360dialog (cloud)

360dialog — официальный провайдер WhatsApp Business. Коннектор 360dialog (cloud) — новый коннектор для подключения бота в WhatsApp Business Account (WABA). Подробнее о правилах WhatsApp можно узнать в документации 360dialog.

Подключение

1. Конфигурация на стороне 360dialog

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

  1. Зайдите в аккаунт 360dialog. На главной странице будет выведен список зарегистрированных бизнес-аккаунтов WhatsApp (подробнее о том, как зарегистрировать WhatsApp Business Account).

  2. Выберите бизнес-аккаунт, к которому необходимо подключить Агента.

  3. Получите токен доступа по инструкции.

  4. Скопируйте токен доступа.

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

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

  1. Кликните по кнопке настроек Агента.

  2. Нажмите кнопку Add channel.

  3. Откроется панель выбора Конечный канал.

  4. Выберите 360dialog (cloud).

  5. Откроется панель создания Канал Проекта.

  6. По необходимости пропишите заголовок для данного Канал Проекта в поле названия с плейсхолдером New channel.

  7. Вставьте скопированный ранее токен в поле 360Dialog token.

  8. Для сохранения Канал Проекта без его активации, нажмите кнопку CREATE.

  9. Для сохранения и активации Канал Проекта, нажмите кнопку CREATE & ACTIVATE.

    1. Канал Проекта будет сохранен и активирован, если:

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

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

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

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

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

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

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

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

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

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

    1. Изменения будут применены, если:

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

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

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

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

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

  3. Чтобы деактивировать Канал Проекта, нажмите кнопку DEACTIVATE.

  4. Чтобы применить изменения к деактивированному Канал Проекта, нажмите кнопку SAVE.

  5. Чтобы применить изменения и активировать Канал Проекта, нажмите кнопку SAVE & ACTIVATE.

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

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

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

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

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

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

  6. Чтобы отменить внесение изменений, нажмите кнопку CANCEL.

  7. Чтобы удалить Канал Проекта, нажмите кнопку DELETE.

Общение

Взаимодействие с данным Конечный канал происходит по асинхронному методу, с использованием WhatsApp Business API.

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

Шаблоны — это сообщения, с помощью которых Бот в 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)

Частично

  • Если в кнопочном меню не более 3х кнопок, то они будут отправлены как кнопки;

  • Если в кнопочном меню более 3х кнопок, то они будут отправлены как нумерованный список, например:

  1. Один

  2. Два

  3. Три

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

Перевод на оператора

360dialog (cloud)

Нет

В 360dialog нет операторского софта

Передача файлов в виде файлов от Агента (Attachment)

360dialog (cloud)

Частично

Картинку не передает, видео передает, аудио передает в виде аудиофайла, файл передает в виде файла для скачивания

Передача файлов в виде ссылок от Агента (Attachment)

360dialog (cloud)

Да

Происходит попытка отправки картинки\файла спец.методом, если формат файла по ссылке не подходит, канал ответит техническим сообщением об ошибке и тогда мы повторим отправку сообщения но уже отправим ссылку на файл\картинку простым текстом.

Получение файла от Собеседника в сценарий

360dialog (cloud)

Да

Формат: file:тип файла|id передаваемого файла|https://waba.360dialog.io/v1/media/id передаваемого файлаПример: file:document|7b825480-9148-44a7-9454-b60d7f433e14|https://waba.360dialog.io/v1/media/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 можно подключить только одного Агента.

Last updated