WhatsApp как входящий канал

Мессенджер WhatsApp предоставляет возможность подключения ботов в ваш бизнес-аккаунт WhatsApp.

Чат-бот, подключенный к бизнес-аккаунту WhatsApp, может оперативно отвечать на запросы клиентов. Он поддерживает многие функции с помощью разных типов ответов: например, отправку файлов, медиа, геолокации или контактов.

Чтобы подключить WhatsApp как входящий канал в JAICP:

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

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

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

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 номера телефона и Постоянный маркер понадобятся вам при подключении канала в JAICP.

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

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

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

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

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

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

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

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

Настройка интеграции завершена. Чтобы протестировать бота, отправьте ему приветственную или активационную фразу из вашего сценария. После этого начнется диалог с ботом.