# Edna Pulse

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

## Подключение

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

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

1. Авторизуйтесь в [Edna Pulse](https://app.edna.ru/). Аккаунт создается через техподдержку Edna Pulse.
2. Перейдите в раздел Настройки → Каналы.\
   ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-MYYBjo66eS/9c759b33b80f99aa0a14eb961c4542c129fd196ffe48b5ea503d709f30a69ab2022520b9369129cd94c18a00af772d3df6c0fa92e7c0e6ac4df49ba80f2f40ab7cb407856cff9f63a7e6267ec47ef1eaccc40c5cd2498e7f6a31e26927d382926f751971)
3.
   1. В разделе должен быть как минимум один существующий канал. В ином случае обратитесь в техподдержку Edna Pulse для его создания.\
      ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-7xhvJcDyQd/24fb2ff7753177716d6dfdf69dd76c04c8e9245ae46517be4a0c8b4102dd3c2f82f7371b0bc4d9c305135ad2bbdb96b94eec338022e43a2474c22f5e9f32233a2ddc4f0d8db00870fe7dd3f528c61a84e964eb5f302f45a8f098177d56551696a8747667)
4. Перейдите в раздел Каскады. Нажмите на кнопку Добавить каскад +.\
   ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-2emmGR97vS/70fcec00b1e08d4ab42d619dae9557a539f010df75039fced29755889cd38aa25db81e29c42e13bcee8d6df6a00eaa6e47dd46b14cd31bc24ee67f3e6f5571488119fa893c6140b79817c692b0f51e2a588c14e7b57cadd98f7cf9e5742c9fee217b2e40)
5.
   1. Пропишите название каскада.\
      ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-JQCkPLukX9/0566023dd9ade36b85bf82446d4b3b489ad912edaf29e1078f9cf89b6a890dd17032e55cb6746c9e05cdf78fc87fe089b6efd07e5f125cd79957cf0c0c98b2acc2d7e5fa1ba707189e4159b45f435623cda080916e3e401cf2f8a06bdb44ed7847138e8d)
   2. В разделе Создание каскада в поле Сообщение в канале выберите канал. На данный момент для интеграции доступны только каналы WhatsApp, т.е. доступны для создания только каскады с одним пунктом.\
      ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-h88-l0X_jy/61448beb2dba98aba856aa9bbad39f6fd4e950fd8025a59bb1b115f60ae5da8d5f02a61fc0794533cb014a7338fa263ce5707986a4dfbfcd4adfded4b599e2575d68907428e1bec701d86d8a17e22a88b77b1ddb74141e3515e1a7e937b6f5db40488aed)
   3. Сохраните каскад, нажав кнопку Сохранить.\
      ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-Y0ODTruZBY/3cf3ed275f4a5eb2b269e6d44bd822d26f0693e5ac06b1d02244d35dac739bd144365367909cec873269b330226f46237e5963abfb1a92df31a0665799b924cd07390305c1c672c49a0c22d6d54a4c54b325ff5df801c381db1209ff15b484036c081054)
   4. Подтвердите действие во всплывающем окне.\
      ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-QF8yXNWilm/cedc2eeca397c267ff24c5adfe9456ebc85503ae276e2b0bf8841361be34e59f4aa38271e95c4640ff11e712bcaf9139acf3c0eb10d233b0eb408334ee85323a3934f2b94e276cf08841b1942bb32edab6982c3abbf510691f9d10c8fabcc64cb0aab396)
   5. После сохранения каскада появится его ID в поле ID каскада. Он понадобится позже при настройке канала Агента.\
      ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-K4JzMNHdUH/585638475aa837a34440cc33df41afd7193e75d8940ed8a6fdf68d4599bd4b80318ce807d478b838da0d87124c3b947d3fba71ca1ee96eeb233b484af5aecebd3f976374919f89b59aa90aa1fc0315abcf75eda46c61222ee34a050f1bcfc5e22f5c789c)
6. Перейдите в раздел Интеграция → Тестирования.\
   ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-l7dKCuJqrv/a2afed507b194b0cc74eb55a77da44a3d37fc785395c6acaeb7e0865764af86eb78cacf0389c636f45cb76b4e4423341931bb3b0bb13e9786bbf391a9cfcce721299d2c92d10db2a493199c3804a52fc221f8885d96f314d8b17cc4c5f8fdde6b0c9fbd4)
7.
   1. Скопируйте значение из поля Ваш API-ключ. Он понадобится позже при настройке канала Агента.

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

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

1. Кликните по кнопке настроек Агента.\
   ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-m_bL4GvN1_/de0e6c51b47058d8e7854370e44e3e29e8d1195855e34484c55e0ba55e6f4cbc2f103ac4ebcc2b78bf606d6b02118303275d07760b64f89e5ea954cd86466379ab9850814435bbe8d5ab7d3e80e7ac68c8a471b3ba0022e97fb3209a771f11a86b6c817e)
2. Нажмите кнопку Add channel.\
   ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-KJ7zJqauLN/e76804ae1c32c84507914bcbac89b59e5fa7160e857084643655c65f3192dbec4709a2cd8abae87edc6a858acbd80d17c3296d23c47a2c39eccf56433201a9779ccf4ea2580c347508e5f68b0ee94654585fa349ceadd2e6587a4bdebd6c5d9715835322)
3. Откроется панель выбора Конечный канал.\
   ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-62tME9Q3Tk/f779216e19191a55b23b4a00ffb922a46f1587b7e46c39ac560d7a1e3e4e3220175134966cf739b00da0c172d437a3ceb4922819da88f71f3aef10632b2ea2393b8516fa0480afa8c6be84c80554bdf4d3a606ff6a90115a33f12dfa28fa91b514e84f60)
4. Выберите Edna Pulse.
5. Откроется панель создания Канал Проекта.\
   ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-ss6NDfoyiw/38b47df054066cda73fd505c64c0dd78b5eb7cc60456c9d38778e45b87f65dd70358d0e68967c76a03249d63b9faf4d0759a241ad7c3213d59cf72c66dbaa8f318ba4b29c6b9051aa373c1b4db98e6d04cf68a029e3d8d01e477ee881a25472502292d66)
6. По необходимости пропишите заголовок для данного Канал Проекта в поле названия с плейсхолдером New channel.\
   ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-VIafylyT4z/b51feada189f61a16a5e126268ff7934b27f10e16fe2e806e95fe0ca06b2f96623757030cbb414419aff88e58cbf3236b88969f35610db0dcc7624229d7b2d127eb41585b226c22a9fd6822c384fae79b66b1319769d3ac6787686702529b6650fa4b4ac)
7. Пропишите ссылку [https://app.edna.ru/api](https://app.edna.ru/api) или [https://app.edna.io/api](https://app.edna.io/api) в поле Edna Pulse webhook URL.\
   ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-b8BkhFr6F1/a45eb027e8e0853d45d4683f1ca2708120d1b6e290d10df982b6317ba0e8793fbc45a06da97744038c8b6afadc71923ad6f1583f9ecbf45a20a122aa7b80200bc13053d12b0cb1fa8db8a13ee1b2e251cfe26d7eeedee30753b33d7a24c213b52372ee4a)
8. Вставьте API-ключ в поле Edna Pulse token.\
   ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-VXlueHnAbS/1525fc8bd29b90aa8262335ed3df4a1d3451201e8ae0f721aa8140f3c3fe51a8d246836de66f67299aa24bf815a7b574206e1f382495c7c02dd04e9a95f9af859ec5e33e148d4ce55d24d3a01e9a462f46e398f6ac17dddcd8e84d50e9360c6305722e39)
9. Вставьте ID каскада в поле Edna Pulse cascadeId.\
   ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-S9bFGY-dwc/9527a640d331aa07ec87045c15c7bce0c9c694a869fe3ca54517e6872774aa19ddfb8079b8ee9015ab369a975e3b2e103cac70bd8c1f16294171982b947d5c7a194a4aa6fd15940f5fe932bed06906c773b32fb8fb2130373299443718a8ecf1b9255273)
10. Для сохранения Канал Проекта без его активации, нажмите кнопку CREATE.\
    ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-1J32OcTNSs/8d9c3e6e56261957de8e878bd2575669e68da8af02e63387824794bee21efe6218c91caa20a1a4fbd4b868a4df44e0110ef5203ff5203581ed58584cc8a82d9f27a7d213e26b91b2e8e66279d19dec7d4bc03e4be595ef2cb90f0cb5f1ce4a10f3f84801)
11. Для сохранения и активации Канал Проекта, нажмите кнопку CREATE & ACTIVATE.\
    ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-FvZI2IK8H2/8efa6123270cb97b861761ff1ff42cb2c162467a0d7f0dc651cea8f8631f08b7dc09dacbad5ae69b1226a4465c906f7d358927883431824766e4daac94b06d188352b8d9f1b48d2ee47f6961748a2dd484d91391a27d330c9d0064417c42d5bcfe09112f)
12.
    1. Канал Проекта будет сохранен и активирован, если:
    2.
       1. Агент обучен;
       2. токен в поле Edna Pulse token уникален (нет ли активных Канал Проекта того же типа с тем же значением в поле);
       3. будет доступен адрес Канал Проекта;
       4. удастся зарегистрировать вебхук канала.
    3. Канал Проекта будет сохранен, но не активирован, если одно или больше условий не будут выполнены.
13. Для отмены создания Канал Проекта нажмите кнопку CANCEL.\
    ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-ptsKwN8u42/11c029c132a4bb06b12dcee48e7dc123553fb9038815c5c7afbba1371dfd22271bb0019af9eefd2ef0350f1683849b42343f3b56e6539fcd7d9e6c36e781d32ef292fde5878dba381c03dec5e29fe207739e1be18a6d1e9f546af3e8bad49f1c2a7fe9c4)

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

Для редактирования Канал Проекта, необходимо кликнуть по его иконке на карточке Агента.\
![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-GvvId-lNw1/5085f3ec1db30189691a8604fda396204a94499e049b5294459b544debbcb193552e3d5dd652a0c8eba10ce85076bf4b000575af5a1dbeecc685b859dab9a019a576c91fa535ef45793d5104af542c5e68a5463f4211cd6b88f64d5081c13b12d11b51fc)

1. Чтобы отредактировать значение в любом поле, кликните по полю и впишите новое значение.
2. Чтобы применить изменения к активированному Канал Проекта, нажмите кнопку APPLY.\
   ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-bKq8NifUyu/3aa472745922cf7065f02378ce76ffa3af0617cd1a08775495567957eb9f616ae75b101de3c9849c40d0d4aaeee9b8096b6b9ed709967ffddf3457bd9a1d9c6548898ff33c701180f012d02aedd5c1a28a1f17a3eefcb8ab50febd301720e66e98f054ae)
3.
   1. Изменения будут применены, если:
   2.
      1. Агент обучен;
      2. токен в поле Edna Pulse token уникален (нет ли активных Канал Проекта того же типа с тем же значением в поле);
      3. будет доступен адрес Канал Проекта;
      4. удастся зарегистрировать вебхук канала.
   3. Изменения не будут применены, если одно или больше условий не будут выполнены.
4. Чтобы деактивировать  Канал Проекта, нажмите кнопку DEACTIVATE.\
   ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-nbOIAswEIb/288341a332b5030e5201de52ba4df8dc09205a242c8450cf17f002dfa2eda575ffa8ccfa6344e04c2000f74097e90355efb84be4d8768466e7d3c3c69e9812a7e65da140425260f59bcb47bac9a6c5ffd410a73c9a5d80f2aa0c53a5e5bdd6a57a4edc68)
5. Чтобы применить изменения к деактивированному Канал Проекта, нажмите кнопку SAVE.\
   ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-tZSaJj_1QO/76cd7d82778ab33171d01ffc3614bb80591cfdf06f0246137df5e531c38f617ed4947cad29543e914b0a4eac78649dff35b15f676c264beffbdc1c454071a732b77dd0e4fc42ccaf8db411d73b590b66190b0024bf630202f1c33c2ab071fbb3a7411be1)
6. Чтобы применить изменения и активировать Канал Проекта, нажмите кнопку SAVE & ACTIVATE.\
   ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-qMM_-NECbH/c48ce40747039cd058604e77a192df1c5534318370a0e59d77d29e69f90b63086223f4bfc0e78dd19628b9219d6f75699244bc6cbacaa79e6a537d48cb24e51839633961f7abcbffdf67b7761736995fd6b15ff11d9c498be6b67a36e8f609b77592f102)
7.
   1. Изменения будут применены и Канал Проекта будет активирован, если:
   2.
      1. Агент обучен;
      2. токен в поле Edna Pulse token уникален (нет ли активных Канал Проекта того же типа с тем же значением в поле);
      3. будет доступен адрес Канал Проекта;
      4. удастся зарегистрировать вебхук канала.
   3. Изменения будут применены, но Канал Проекта не будет активирован, если одно или больше условий не будут выполнены.
8. Чтобы отменить внесение изменений, нажмите кнопку CANCEL.\
   ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-nJ-L1sYkj9/72fa94feeceb8ea85144f7df02580284e6200959842bf43078f3dab1d70ffb66cb9ee288003614c816bc10ba157fb31535b48964af80ac4911fd677cca96bb9c97e44e5f6a00f078121b36c154be9c10984b9e39ab6541c2ebc427fe61d2313fdba969ac)
9. Чтобы удалить Канал Проекта, нажмите кнопку DELETE.\
   ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-xzRpZ7rJR6/1ed4c35e89db8f696c00b9271d534cd249cb7dad830eaf8c2ace1945025ebc6cc1893b68c2d192f39ca1518375936131aac3ef9e9cf176ad5f6f58715f1d4abd8c6353ff34a7daff93682f4c98c6e06dc0b4757534098d1a81c205265ea3a075641b28b5)

## Общение

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

Шаблоны — это сообщения, с помощью которых Бот в 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](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     | Да                   | <p>Поддерживаются следующие типы разметки:<br>*жирный шрифт*<br>_курсив_<br>*_жирный курсив_*</p>                                                                                                                                                                                                                                                                                                                                                   |
| Рассылки с помощью Notification                                                | Edna Pulse     | Да                   | <p>Перед созданием слота Notification необходимо проделать следующие действия:</p><ol><li>Создать шаблон в .</li><li>Создать канал  (подробнее: ) (без этого Слот не удастся сохранить).</li></ol><p>Важно: к одному WABA можно подключить только одного Агента.</p>                                                                                                                                                                                |
