> For the complete documentation index, see [llms.txt](https://chatme-ai-4.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://chatme-ai-4.gitbook.io/docs/kak-vyvesti-agenta-v-konechnye-kanaly/vyvod-agenta-v-messendzhery/360dialog-cloud.md). # 360dialog (cloud) 360dialog — официальный провайдер WhatsApp Business. Коннектор 360dialog (cloud) — новый коннектор для подключения бота в WhatsApp Business Account (WABA). Подробнее о правилах WhatsApp можно узнать в [документации 360dialog](https://docs.360dialog.com/). ## Подключение ### 1. Конфигурация на стороне 360dialog В первую очередь нужно произвести конфигурацию на стороне 360dialog. 1. Зайдите в аккаунт [360dialog](https://hub.360dialog.com/auth/login). На главной странице будет выведен список зарегистрированных бизнес-аккаунтов WhatsApp ([подробнее о том, как зарегистрировать WhatsApp Business Account](https://www.facebook.com/business/help/2087193751603668?id=2129163877102343)). 2. ![аккаунты.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-zZ4ez_NiCj/1512835285c1fae1cece3f647378f886bec7e0db6e436550afbc37b45d0ca2fb34283fb9b908f735dbd55615eaf00235bdddc1fb94bef81a7d5fd4a9d0067004f54e562d911a08382eb0264aabab3e5e27984e0e7fd7b5d3240b87c1b059c4492bba2d4f) 3. Выберите бизнес-аккаунт, к которому необходимо подключить Агента. 4. Получите токен доступа по [инструкции](https://docs.360dialog.com/api-key). 5. Скопируйте токен доступа. ### 2. Конфигурация канала агента в Платформе Агенту необходимо создать и настроить Канал Проекта с Коннектором 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-mcrmS4aK3h/962a3133f58c3bb8dd45508546724b20749a3cf4b26a5489f5bfcb24472eb611b439d0087db302e94016a7a9a2d57a215eddf734a9120c67ec8fa8349a5e6a7923cdebc8e5b8973a0292f3c2f83db7a9ff3ed6470e2d3136a9c7e148a8912cf8a026e12f) 4. Выберите 360dialog (cloud). 5. Откроется панель создания Канал Проекта.\ ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-swYUXJD9XT/f9f2fbd65e7ca4a1ee3fb4a1b93cb4276fb601d7fd89ba2c496eeec9b1c1c9879171003b3eae26aaa835bf30fdbdf2cc4e8624f71e825525efb6a3c0667bd4649146898a92d453a7cb3d74382dbb3f26ab43d98da62ca999ef4eb512591dd12bb631901b) 6. По необходимости пропишите заголовок для данного Канал Проекта в поле названия с плейсхолдером New channel.\ ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-MbGDz11pfi/bc2b7d050e663f9062c616376b57660457c8c8c28b92e1ba4b3ce4a825d73e866430779f6e93fbb9ce21deec0a55a9314fd65ddf702e65b253f2271a25992ff72734fe7d1f62597f29497164b9451752ff6eaf64e36d56d501cc3e4043f1eb319582557e) 7. Вставьте скопированный ранее токен в поле 360Dialog token.\ ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-fs_Xnr0ioA/182f03fd2ef1a0f25a0f12a8ba23364e4bae9e011b4c00707417985feab20346bba98b28859ba635a8340e73b99e211e09f4d87a8f1aa108601ece850d43683747a4a993e69e8454d3315f04515c637c4ad119c724d0b8009905769f52c409642ce1c383) 8. Для сохранения Канал Проекта без его активации, нажмите кнопку CREATE.\ ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-SPGWyegvC2/a6e853e132c6cbc32504b639c40d1aa08374893a8af45181f7d942d9649616c32d73951b39d984fe3e9e9b10187af9b3894f971b1798527932b6f78081156c6bc0a4726fa0760188c3d0243513b2a7909fee4a8ae960fb377e9bf78edddca72a39714c48) 9. Для сохранения и активации Канал Проекта, нажмите кнопку CREATE & ACTIVATE.\ ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-_2BnFYrdKO/db7b065c826e63361e2a9e71578182610e99e4cc56f182d81fad522882c269329fead530992b8bdc83731130faa050cf263a1cf55c5063d8e41957cd0266f8e728bcfa0d9edae87dce14a2fe262fc4210f3eab83d4db4fd761fa634a6395f7e77587a736) 10. 1. Канал Проекта будет сохранен и активирован, если: 2. 1. Агент обучен; 2. токен в поле 360Dialog token уникален (нет ли активных Канал Проекта того же типа с тем же значением в поле); 3. будет доступен адрес Канал Проекта; 4. удастся зарегистрировать вебхук канала. 3. Канал Проекта будет сохранен, но не активирован, если одно или больше условий не будут выполнены. 11. Для отмены создания Канал Проекта нажмите кнопку CANCEL.\ ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-W1d9bpCU9Y/cdab787a141a7f7c16fb0f2c888ae0936abd956d492ab5e2607717797960c0d96a91fff26e017d46aa46b73dd3be10e70d1e68b2175c87353fa2061e84e5f0dbc4c8fe723a30665948c588e09d14639dc4f3fac24ef4da30c69db52667fa5221bbdbdcfb) ## Редактирование и удаление Канала Агента Для редактирования Канал Проекта, необходимо кликнуть по его иконке на карточке Агента.\ ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-m0Nvp0Vxv-/2da472949e9bbc881c8374fdff61fb31407c130fe9d0cd3fa76d1bde27aa2ca70f401b13d4eda1ed31d72c8fb4cb51d013c1507dca7697488760209ca961ec75a6b16efc424482579408225f9d498383203b7afef05c03328f02b81f55422bd2cc227f50) 1. Чтобы отредактировать значение в любом поле, кликните по полю и впишите новое значение. 2. Чтобы применить изменения к активированному Канал Проекта, нажмите кнопку APPLY.\ ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-kN63Cl6ORh/43f1183d5c11c01bd62b87164850f2f42d5456024e6b386f3f959343389a3262aec00e33be29cfb199fa58d794933834954b86d4cd18ba492e4b4d85a7610e143e0b207b1f27353ba2fc23d9b17d7c565f0a27cf6492350d630785cd030a88fcde7a574a) 3. 1. Изменения будут применены, если: 2. 1. Агент обучен; 2. токен в поле 360Dialog token уникален (нет ли активных Канал Проекта того же типа с тем же значением в поле); 3. будет доступен адрес Канал Проекта; 4. удастся зарегистрировать вебхук канала. 3. Изменения не будут применены, если одно или больше условий не будут выполнены. 4. Чтобы деактивировать Канал Проекта, нажмите кнопку DEACTIVATE.\ ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-LSMcLF1mTZ/d0758445a52dd874ba949724f7d8f9a9a74858b38bd13ab488da9f1f047d8423ee8033cf6afb998be5ddb009a7bb67c48286ab4b91a9fa04e6b089068f3476e508e3927b59fea035f88a5e132c41bad11f9d96947aa0cbc433c9fdc9958064f21cb55cc5) 5. Чтобы применить изменения к деактивированному Канал Проекта, нажмите кнопку SAVE.\ ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-7AAQcmNDLV/6ff2c851b406084a99fe4babfaddb1bf9029cf1126f3916e0022d5cfe06408eeb34960e5765f502241abd3bd7f59489f8648b3e4ff8d8635fff3712cc026a733010c1a4787e388ae29d9b6f0f42452595570282a519c5b168abb03a686127ebf1be25d2e) 6. Чтобы применить изменения и активировать Канал Проекта, нажмите кнопку SAVE & ACTIVATE.\ ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-nPgwsvBlVW/2be133cde325defecdf915ef4a54ef2b01cd60a2b628313038959ac3553b0c8a8e841cc7001fd81acc5e65f43e9c7bca2a9caf02f054ed460481b3df114089ec5b2f704d70991d5ee36e031c3351e0d77685b58b03218ccac1a06eedcc5e00789c9f3e6a) 7. 1. Изменения будут применены и Канал Проекта будет активирован, если: 2. 1. Агент обучен; 2. токен в поле 360Dialog token уникален (нет ли активных Канал Проекта того же типа с тем же значением в поле); 3. будет доступен адрес Канал Проекта; 4. удастся зарегистрировать вебхук канала. 3. Изменения будут применены, но Канал Проекта не будет активирован, если одно или больше условий не будут выполнены. 8. Чтобы отменить внесение изменений, нажмите кнопку CANCEL.\ ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-by1fBEDvrS/5bd97c42a712c21c23624112b637f8ca657b66868aba443f09ebff1905bf7a6a1974dc3575081b15c4bb71eaa589a248afb8c32f176276dbb11beb13f95e7ac51b41bfc6bd9a7fa02442ad5a64f43f9084bac3aeec0750e22a705c185c88ceac3099833d) 9. Чтобы удалить Канал Проекта, нажмите кнопку DELETE.\ ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-6aPVzCgdOl/71f4aefba714f316de5b6d93ad70bde0e862786fcafc046cd4e70a67d440c81aae67101b635696185e402fe0ee7607d94ab61040530827e04b8eee3a5aa6b26ea154325dbe5d9bf09cb63ba3b9ba48af46c1969e61d0e9713d94926525cf0780846cd424) ## Общение Взаимодействие с данным Конечный канал происходит по асинхронному методу, с использованием [WhatsApp Business API](https://www.whatsapp.com/business/api/?lang=ru). ### Шаблоны рассылок Шаблоны — это сообщения, с помощью которых Бот в WhatsApp стартует Чат с Собеседником. Чтобы произвести рассылку по Собеседникам в WhatsApp, необходимо создать шаблон, отправить на согласование, в случае неуспеха переформулировать и отправить новый шаблон, а в случае согласования инициировать рассылку с помощью Слота Notification.Подробнее: Создание и согласование шаблонов рассылочных сообщений в 360dialog > Важно: стартовать Диалог с Собеседником возможно только через отправку шаблона рассылки через Слот Notification. Подробнее: Рассылки в WhatsApp| Слот Notification. | Переменная | Конечный канал | Переменная в запросе из канала | Примечания | | --------------------------- | ----------------- | ---------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------- | | channel\_conversation\_id | 360dialog (cloud) | response\["messages"]\[0]\["from"] | | | channel\_visitor\_id | 360dialog (cloud) | response\["messages"]\[0]\["from"] | | | channel\_visitor\_firstname | 360dialog (cloud) | response\["contacts"]\[0]\["profile"]\["name"] | До первого пробела, может отсутствовать | | channel\_visitor\_lastname | 360dialog (cloud) | response\["contacts"]\[0]\["profile"]\["name"] | После первого пробела, может отсутствовать | | channel\_visitor\_phone | 360dialog (cloud) | response\["messages"]\[0]\["from"] | После отправки рассылки Слотом Notification в эту переменную попадает номер телефона, на который была отправлена рассылка | | channel\_visitor\_email | 360dialog (cloud) | Нет | | | channel\_visitor\_account | 360dialog (cloud) | response\["messages"]\[0]\["from"] | номер телефона пользователя | | channel\_visitor\_auth | 360dialog (cloud) | Нет | | | channel\_visitor\_source | 360dialog (cloud) | Нет | |
| Функционал общения | Конечный канал | Доступность в канале | Примечания | | ------------------------------------------------------------------------------ | ----------------- | -------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | channel\_chat\_id | 360dialog (cloud) | Да | Формат: номер телефона собеседника начиная с телефонного кода страны без знака +\|dialog360 | | Сообщения дойдут до собеседника, если агент напишет первый в существующем чате | 360dialog (cloud) | Частично | Агент может стартовать диалог с помощью отправки согласованного шаблона рассылки, подробнее: согласование шаблонов. Однако в 360dialog диалог длится 24 часа, по истечении этого времени отправленное Агентом через Incoming Request сообщение не дойдет до Собеседника | | Кнопки | 360dialog (cloud) | Частично |
  1. Один
  2. Два
  3. Три

Чтобы сценарий вышел в нужную ветку, пользователь должен отправить лейбл кнопки, например, текст Один.

| | Перевод на оператора | 360dialog (cloud) | Нет | В 360dialog нет операторского софта | | Передача файлов в виде файлов от Агента (Attachment) | 360dialog (cloud) | Частично | Картинку не передает, видео передает, аудио передает в виде аудиофайла, файл передает в виде файла для скачивания | | Передача файлов в виде ссылок от Агента (Attachment) | 360dialog (cloud) | Да | Происходит попытка отправки картинки\файла спец.методом, если формат файла по ссылке не подходит, канал ответит техническим сообщением об ошибке и тогда мы повторим отправку сообщения но уже отправим ссылку на файл\картинку простым текстом. | | Получение файла от Собеседника в сценарий | 360dialog (cloud) | Да | Формат: file:тип файла\|id передаваемого файла\| передаваемого файлаПример: file:document\|7b825480-9148-44a7-9454-b60d7f433e14\| | | Получение геолокации от собеседника в сценарии | 360dialog (cloud) | Нет | | | Доставка сообщений более 1000 символов от Агента до Собеседника | 360dialog (cloud) | Да | | | Использование маркдауна | 360dialog (cloud) | Нет | | | Рассылки с помощью Notification | 360dialog (cloud) | Да |

Перед созданием слота Notification необходимо проделать следующие действия:

  1. Создать шаблон в 360dialog (подробнее: WhatsApp (360dialog)).
  2. Создать канал Whatsapp (360dialog) (подробнее: WhatsApp (360dialog)) (без этого Слот не удастся сохранить).

Важно: к одному WABA можно подключить только одного Агента.

|