Edna Pulse

Edna Pulse — официальный провайдер WhatsApp Business. Используя коннектор “Edna Pulse” можно создать Бота в WhatsApp Business Account (WABA).

Подключение

1. Конфигурация бота на стороне Edna Pulse

В первую очередь нужно произвести конфигурацию на стороне Edna Pulse.

1. Авторизуйтесь в Edna Pulse. Аккаунт создается через техподдержку Edna Pulse.

2. Перейдите в раздел Настройки → Каналы.

3. 1. В разделе должен быть как минимум один существующий канал. В ином случае обратитесь в техподдержку Edna Pulse для его создания.

4. Перейдите в раздел Каскады. Нажмите на кнопку Добавить каскад +.

5. 1. Пропишите название каскада.

   2. В разделе Создание каскада в поле Сообщение в канале выберите канал. На данный момент для интеграции доступны только каналы WhatsApp, т.е. доступны для создания только каскады с одним пунктом.

   3. Сохраните каскад, нажав кнопку Сохранить.

   4. Подтвердите действие во всплывающем окне.

   5. После сохранения каскада появится его ID в поле ID каскада. Он понадобится позже при настройке канала Агента.

6. Перейдите в раздел Интеграция → Тестирования.

7. 1. Скопируйте значение из поля Ваш API-ключ. Он понадобится позже при настройке канала Агента.

2. Конфигурация канала агента в Платформе

Агенту необходимо создать и настроить Канал Проекта с Коннектором “Edna Pulse”.

1. Кликните по кнопке настроек Агента.
2. Нажмите кнопку Add channel.
3. Откроется панель выбора Конечный канал.
4. Выберите Edna Pulse.

5. Откроется панель создания Канал Проекта.
6. По необходимости пропишите заголовок для данного Канал Проекта в поле названия с плейсхолдером New channel.
7. Пропишите ссылку https://app.edna.ru/api или https://app.edna.io/api в поле Edna Pulse webhook URL.
8. Вставьте API-ключ в поле Edna Pulse token.
9. Вставьте ID каскада в поле Edna Pulse cascadeId.
10. Для сохранения Канал Проекта без его активации, нажмите кнопку CREATE.
11. Для сохранения и активации Канал Проекта, нажмите кнопку CREATE & ACTIVATE.
12. 1. Канал Проекта будет сохранен и активирован, если:

    2. 1. Агент обучен;

       2. токен в поле Edna Pulse token уникален (нет ли активных Канал Проекта того же типа с тем же значением в поле);

       3. будет доступен адрес Канал Проекта;

       4. удастся зарегистрировать вебхук канала.

    3. Канал Проекта будет сохранен, но не активирован, если одно или больше условий не будут выполнены.

13. Для отмены создания Канал Проекта нажмите кнопку CANCEL.

Редактирование и удаление Канала Агента

Для редактирования Канал Проекта, необходимо кликнуть по его иконке на карточке Агента.

1. Чтобы отредактировать значение в любом поле, кликните по полю и впишите новое значение.

2. Чтобы применить изменения к активированному Канал Проекта, нажмите кнопку APPLY.
3. 1. Изменения будут применены, если:

   2. 1. Агент обучен;

      2. токен в поле Edna Pulse token уникален (нет ли активных Канал Проекта того же типа с тем же значением в поле);

      3. будет доступен адрес Канал Проекта;

      4. удастся зарегистрировать вебхук канала.

   3. Изменения не будут применены, если одно или больше условий не будут выполнены.

4. Чтобы деактивировать Канал Проекта, нажмите кнопку DEACTIVATE.
5. Чтобы применить изменения к деактивированному Канал Проекта, нажмите кнопку SAVE.
6. Чтобы применить изменения и активировать Канал Проекта, нажмите кнопку SAVE & ACTIVATE.
7. 1. Изменения будут применены и Канал Проекта будет активирован, если:

   2. 1. Агент обучен;

      2. токен в поле Edna Pulse token уникален (нет ли активных Канал Проекта того же типа с тем же значением в поле);

      3. будет доступен адрес Канал Проекта;

      4. удастся зарегистрировать вебхук канала.

   3. Изменения будут применены, но Канал Проекта не будет активирован, если одно или больше условий не будут выполнены.

8. Чтобы отменить внесение изменений, нажмите кнопку CANCEL.
9. Чтобы удалить Канал Проекта, нажмите кнопку DELETE.

Общение

Шаблоны рассылок

Шаблоны — это сообщения, с помощью которых Бот в WhatsApp стартует Чат с Собеседником. Чтобы произвести рассылку по Собеседникам в WhatsApp, необходимо создать шаблон, отправить на согласование, в случае неуспеха переформулировать и отправить новый шаблон, а в случае согласования инициировать рассылку с помощью Слота Notification.

Важно: стартовать Диалог с Собеседником возможно только через отправку шаблона рассылки через Слот Notification. Подробнее: Рассылки в WhatsApp| Слот Notification.

Переменная	Конечный канал	Переменная в запросе из канала
channel_visitor_id	Edna Pulse	subscriber.identifier
channel_conversation_id	Edna Pulse	subscriber.identifier
channel_visitor_firstname	Edna Pulse	userInfo.firstName
channel_visitor_lastname	Edna Pulse	userInfo.lastName
channel_visitor_account	Edna Pulse	userInfo.userName
channel_visitor_phone	Edna Pulse	subscriber.identifierПосле отправки рассылки Слотом Notification в эту переменную попадает номер телефона, на который была отправлена рассылка
channel_visitor_email	Edna Pulse	Нет
channel_visitor_source	Edna Pulse	Нет
channel_visitor_auth	Edna Pulse	Нет
channel_visitor_location	Edna Pulse	Нет
channel_message_id	Edna Pulse	Нет
channel_message_recipient	Edna Pulse	Нет

Функционал общения	Конечный канал	Доступность в канале	Примечания
channel_chat_id	Edna Pulse	Да	Формат: channel_visitor_id|edna platform
Сообщения дойдут до собеседника, если агент напишет первый в существующем чате	Edna Pulse	Да
Кнопки	Edna Pulse	Да	Кнопки в количестве от 1 до 3 передаются в виде кнопок, 4 и более кнопок преобразуются в нумерованный список.
Перевод на оператора	Edna Pulse	Нет
Передача файлов в виде файлов от Агента (Attachment)	Edna Pulse	Да
Передача файлов в виде ссылок от Агента (Attachment)	Edna Pulse	Да
Получение файла от Собеседника в сценарий	Edna Pulse	Да	Формат: file:тип файла|id передаваемого файла|ссылка на файлПример: file:video|01892905-e1ad-47c1-8a48-39303776b107|https://files.mfms.ru/wabucket2/chatme_WA/GFgOgvt8SvmxTMwn3fDPsA.jpg?AWSAccessKeyId=wabucket2&Expires=1684850140&Signature=ky1QtB4FHMyIyhPPw5fDGccJGTI%3D
Получение геолокации от собеседника в сценарии	Edna Pulse	Нет	Агент не реагирует никак на отправку геолокации
Доставка сообщений более 1000 символов от Агента до Собеседника	Edna Pulse	Да
Получить ссылку на источник лида	Edna Pulse	Нет
Использование маркдауна	Edna Pulse	Да	Поддерживаются следующие типы разметки: *жирный шрифт* _курсив_ *_жирный курсив_*
Рассылки с помощью Notification	Edna Pulse	Да	Перед созданием слота Notification необходимо проделать следующие действия: Создать шаблон в . Создать канал (подробнее: ) (без этого Слот не удастся сохранить). Важно: к одному WABA можно подключить только одного Агента.