360dialog (WhatsApp)
Last updated
Last updated
360dialog — официальный провайдер WhatsApp Business. Используя Коннектор “Dialog360” можно подключить Бота в WhatsApp Business Account (WABA). Подробнее о правилах WhatsApp можно узнать в документации 360dialog.
В первую очередь нужно произвести конфигурацию на стороне 360dialog.
Зайдите в аккаунт 360dialog. На главной странице будет выведен список зарегистрированных бизнес-аккаунтов WhatsApp (подробнее о том, как зарегистрировать WhatsApp Business Account).
Выберите бизнес-аккаунт, к которому необходимо подключить Агента.
Получите токен доступа по инструкции.
Скопируйте токен доступа.
Агенту необходимо создать и настроить Канал Проекта с Коннектором
Кликните по кнопке настроек Агента.
Нажмите кнопку Add channel.
Откроется панель выбора Конечный канал.
Выберите 360dialog (Whatsapp).
Откроется панель создания Канал Проекта.
По необходимости пропишите заголовок для данного Канал Проекта в поле названия с плейсхолдером New channel.
Вставьте скопированный ранее токен в поле 360Dialog token.
Для сохранения Канал Проекта без его активации, нажмите кнопку CREATE.
Для сохранения и активации Канал Проекта, нажмите кнопку CREATE & ACTIVATE.
Канал Проекта будет сохранен и активирован, если:
Агент обучен;
токен в поле 360Dialog token уникален (нет ли активных Канал Проекта того же типа с тем же значением в поле);
будет доступен адрес Канал Проекта;
удастся зарегистрировать вебхук канала.
Канал Проекта будет сохранен, но не активирован, если одно или больше условий не будут выполнены.
Для отмены создания Канал Проекта нажмите кнопку CANCEL.
Чтобы отредактировать значение в любом поле, кликните по полю и впишите новое значение.
Изменения будут применены, если:
Агент обучен;
токен в поле 360Dialog token уникален (нет ли активных Канал Проекта того же типа с тем же значением в поле);
будет доступен адрес Канал Проекта;
удастся зарегистрировать вебхук канала.
Изменения не будут применены, если одно или больше условий не будут выполнены.
Изменения будут применены и Канал Проекта будет активирован, если:
Агент обучен;
токен в поле 360Dialog token уникален (нет ли активных Канал Проекта того же типа с тем же значением в поле);
будет доступен адрес Канал Проекта;
удастся зарегистрировать вебхук канала.
Изменения будут применены, но Канал Проекта не будет активирован, если одно или больше условий не будут выполнены.
Взаимодействие с данным Конечный канал происходит по асинхронному методу, с использованием WhatsApp Business API.
Шаблоны — это сообщения, с помощью которых Бот в WhatsApp стартует Чат с Собеседником. Чтобы произвести рассылку по Собеседникам в WhatsApp, необходимо создать шаблон, отправить на согласование, в случае неуспеха переформулировать и отправить новый шаблон, а в случае согласования инициировать рассылку с помощью Слота Notification.Подробнее: Создание и согласование шаблонов рассылочных сообщений в 360dialog
Важно: стартовать Диалог с Собеседником возможно только через отправку шаблона рассылки через Слот Notification. Подробнее: Рассылки в WhatsApp| Слот Notification.
response["messages"][0]["from"]
response["messages"][0]["from"]
response["contacts"][0]["profile"]["name"]
До первого пробела, может отсутствовать
response["contacts"][0]["profile"]["name"]
После первого пробела, может отсутствовать
response["messages"][0]["from"]
Нет
response["messages"][0]["from"]
номер телефона пользователя
Нет
Нет
Да
Формат: номер телефона собеседника начиная с телефонного кода страны без знака +|dialog360
Частично
Частично
Если в кнопочном меню не более 3х кнопок, то они будут отправлены как кнопки;
Если в кнопочном меню более 3х кнопок, то они будут отправлены как нумерованный список, например:
Один
Два
Три
Чтобы сценарий вышел в нужную ветку, пользователь должен отправить лейбл кнопки, например, текст Один.
Нет
В 360dialog нет операторского софта
Частично
Картинку не передает, видео передает, аудио передает в виде аудиофайла, файл передает в виде файла для скачивания
Да
Происходит попытка отправки картинки\файла спец.методом, если формат файла по ссылке не подходит, канал ответит техническим сообщением об ошибке и тогда мы повторим отправку сообщения но уже отправим ссылку на файл\картинку простым текстом.
Да
Формат: 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
Нет
Да
Нет
Да
Перед созданием слота Notification необходимо проделать следующие действия:
Да
Формат: номер телефона собеседника начиная с телефонного кода страны без знака +|dialog360
Для редактирования Канал Проекта, необходимо кликнуть по его иконке на карточке Агента.
Чтобы применить изменения к активированному Канал Проекта, нажмите кнопку APPLY.
Чтобы деактивировать Канал Проекта, нажмите кнопку DEACTIVATE.
Чтобы применить изменения к деактивированному Канал Проекта, нажмите кнопку SAVE.
Чтобы применить изменения и активировать Канал Проекта, нажмите кнопку SAVE & ACTIVATE.
Чтобы отменить внесение изменений, нажмите кнопку CANCEL.
Чтобы удалить Канал Проекта, нажмите кнопку DELETE.
После отправки рассылки ом в эту переменную попадает номер телефона, на который была отправлена рассылка
Агент может стартовать диалог с помощью отправки согласованного шаблона рассылки, подробнее: . Однако в 360dialog диалог длится 24 часа, по истечении этого времени отправленное ом через Incoming Request сообщение не дойдет до а
Создать шаблон в 360dialog (подробнее: ).
Создать канал Whatsapp (360dialog) (подробнее: ) (без этого не удастся сохранить).
Важно: к одному WABA можно подключить только одного а.