Подключение WhatsApp Business напрямую

Чтобы подключить бота в WhatsApp Business:

1. Создайте приложение в аккаунте разработчика.
2. Настройте приложение.
3. Создайте сценарий в Aimylogic.
4. Подключите бота к каналу.
5. Настройте вебхук в приложении.
6. Протестируйте бота в мессенджере.

Видеоинструкция: как подключить чат-бота к WhatsApp

Создание приложения

предупреждение

Чтобы настроить интеграцию, вам понадобится аккаунт разработчика.

1. Войдите в аккаунт разработчика.
2. В верхней панели выберите Мои приложения.
3. Нажмите Создать приложение.
4. На вкладке Тип выберите Компания и нажмите Далее.
5. На вкладке Информация добавьте основную информацию о приложении:
   • название;
   • электронный адрес;
   • связанный бизнес-аккаунт вашей компании.
6. Нажмите Создание приложения.

Настройка приложения

Чтобы продолжить настройку приложения, вам нужно сгенерировать постоянный маркер.

предупреждение

Постоянный маркер доступен только для приложений в рабочем режиме.

Генерация постоянного маркера

Чтобы сгенерировать постоянный маркер:

1. Перейдите на страницу Настройки компании.
2. В разделе Пользователи выберите Системные пользователи и нажмите Добавить.
3. Введите Имя системного пользователя, Роль системного пользователя и нажмите Создать системного пользователя.
4. На странице Системные пользователи нажмите Добавить объекты.
5. В разделе Выберите тип объекта → Приложения → Выберите объект выберите свое приложение.
6. Включите опцию Управление приложением в разделе Полный контроль и нажмите Сохранить изменения.
7. На странице Системные пользователи нажмите Создать новый маркер.
8. Выберите свое приложение из списка.
9. Выберите разрешения whatsapp_business_management и whatsapp_business_messaging из списка и нажмите Сгенерировать маркер.

Завершение настройки

Чтобы завершить настройку приложения:

1. Перейдите на страницу Мои приложения и выберите свое приложение.
2. На странице Панель приложений в разделе Добавление продуктов в приложение выберите Интеграция с WhatsApp.
3. На вкладке Первые шаги:
   • Перейдите к Шаг 1: Выберите номера телефонов и выберите номер телефона, к которому привязан бизнес-аккаунт. ! > Если у вас еще нет номера, перейдите к Шаг 5: Добавьте номер телефона, создайте профиль и подтвердите номер.
     Затем вернитесь к Шаг 1: Выберите номера телефонов и выберите номер из выпадающего списка.
   • Скопируйте ID номера телефона.
4. На вкладке Настройка скопируйте Постоянный маркер.

предупреждение

ID номера телефона и Постоянный маркер понадобятся вам при подключении канала в Aimylogic.

Создание сценария в Aimylogic

Теперь вам нужно создать сценарий бота в Aimylogic.

подсказка

Как создать бота и как разработать сценарий

Особенности сценария в Aimylogic

В канале WhatsApp диалог начинает пользователь, а не бот.

Чтобы пользователь начал диалог с ботом, добавьте на первый экран глобальный интент $TEXT:

1. На вкладке Чат-боты выберите проект бота, который вы планируете подключить к мессенджеру.
2. Нажмите Добавить экран → Сделать свой интент.
3. Создайте интент $TEXT.
4. Нажмите  , чтобы сделать интент шаблоном.
5. Включите опцию Сделать доступным из любой точки сценария.
6. Нажмите Сохранить.
7. Соедините интент $TEXT с экраном приветствия в сценарии.

предупреждение

Опция Любая другая фраза не должна быть связана с другими блоками.

Чтобы обрабатывать непредсказумые фразы пользователя в ходе сценария:

1. Добавьте еще один экран с интентом $TEXT. Не включайте опцию Сделать доступным из любой точки сценария.
2. Соедините опцию Любая другая фраза с блоком, в котором будет ответ на непредсказуемую фразу.

Подключение входящего канала

Чтобы подключить канал WhatsApp Business в Aimylogic:

1. На вкладке Каналы в разделе Подключения → Мессенджеры, соцсети и API выберите канал WhatsApp Business.
2. Выберите способ подключения Напрямую.
3. Заполните поля:
   • Название канала — введите название входящего канала. Его будете видеть только вы в разделе Каналы.
   • Токен — вставьте Постоянный маркер, который вы скопировали ранее.
   • ID номера телефона — вставьте идентификатор, который вы скопировали ранее. Это набор символов вида 102678009166123.
4. Нажмите Подключить.

В разделе Подключения вы увидите опубликованный канал WhatsApp Business.

Нажмите Получить webhook. Вебхук понадобится вам для завершения настройки интеграции в аккаунте разработчика.

Настройка вебхука

Чтобы завершить настройку интеграции в приложении:

1. Выберите ваше приложение в аккаунте разработчика.
2. В разделе Товары на боковой панели выберите WhatsApp → Настройкa.
3. На вкладке Настройка перейдите в раздел Webhook и нажмите Изменить.
4. Заполните данные в окне Редактировать URL обратного вызова webhook:
   • В поле URL обратного вызова вставьте вебхук, скопированный из канала Aimylogic.
   • В поле Подтверждение маркера укажите justai_verify_token.
5. Нажмите Подтвердить и сохранить.
6. В разделе Поля Webhook выберите messages и нажмите Оформить подписку на поле Webhooks messages.
7. Нажмите Подтвердить и сохранить.

Тестирование бота

Настройка интеграции завершена. Чтобы протестировать бота, отправьте сообщение в бизнес-аккаунт WhatsApp.