Перейти к основному содержимому

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 номера телефона.
  1. На вкладке Настройка скопируйте Постоянный маркер.
предупреждение
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. Нажмите Готово.

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

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