Канал WhatsApp
Общая схема подключения
Интеграция с WhatsApp работает только через уполномоченных партнеров. На данный момент подключение возможно через оператора Edna.
Схема подключения интеграции:
- Обратиться в Edna для заключения договора на подключение к платформе Edna.
- Заключить договор с Edna и получить доступ к личному кабинету.
- Перейти к созданию канала в BPMSoft OCC.
Добавление канала WhatsApp
Установите пакет BPMSoftOCCWAMfmsJson.
Для того чтобы установить пакет:
- Перейдите в «Дизайнер системы»
и откройте раздел «Установка и удаление приложений».
Рисунок 1 — Раздел «Установка и удаление приложений»
- Нажмите «Добавить приложение» и выберите действие «Установить из файла».
Рисунок 2 — Страница раздела «Установка и удаление приложений»
После успешной установки пакета MFMSJson пользователю будет доступно добавление канала WhatsApp в разделе «Настройка чатов BPMSoft OCC» в Дизайнере системы.
Добавление канала в BPMSoft
Для того чтобы добавить канал в BPMSoft:
- Перейдите в раздел «Настройка чатов BPMSoft OCC» в «Дизайнере системы».
- Нажмите
на детали «Каналы» страницы раздела «Настройка чатов BPMSoft OCC», чтобы добавить новый канал.
Рисунок 3 — Деталь «Каналы»
- Выберите канал WhatsApp.
- Заполните поля, описание которых представлено в таблице ниже:
Таблица 1 — Описание полей на странице «Добавление канала WhatsApp»
| Наименование | Описание |
| Название канала | Название канала, которое будет отображаться в BPMSoft |
| ApiKey | Ключ из личного кабинета Edna (вкладка «Интеграция») |
| Номер телефона | Номер телефона, указанный в личном кабинете Edna на вкладке «Интеграция». При копировании уберите все пробелы и скобки в номере |
| CascadeId | Идентификатор каскада, указанный в личном кабинете Edna на вкладке «Настройки» → «Каскады» → значение из столбца «ID каскада». Поле отображается, если флаг в системной настройке «BPMSoftOCCUseObsoleteWhatsAppApi» не установлен |
| WebHook | Нередактируемое поле, заполняется автоматически |
| Вес чата | Единица веса чата. Данный параметр необходим для настройки нагрузки на оператора |
Рисунок 4 — Страница «Добавление канала WhatsApp»
Добавьте значение из поля «Webhook» в личный кабинет Edna в поля «Входящие сообщения мы отправляем на» и «Статусы сообщений мы отправляем на».
В BPMSoft предусмотрена возможность работы с несколькими версиями API Edna: https://app.edna.ru/api/cascade/schedule (новым) и https://app.edna.ru/api/old/ (старым). Для переключения между старым и новым API Edna используется системная настройка «BPMSoftOCCUseObsoleteWhatsAppApi». По умолчанию флаг в системной настройке не установлен и используется новая версия API Edna. Если необходимо использовать старую версию API Edna, установите флаг. При использовании старой версии API доступно добавление канала с параметром «Subject» вместо «CascadeId».