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

WhatsApp

примечание

Этот вид подключения может работать нестабильно в связи с замедлением WhatsApp в России.

Через Agent Platform вы можете опубликовать процесс в WhatsApp Business. Чтобы использовать ваш процесс в WhatsApp:

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

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

примечание

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

  1. Войдите в аккаунт разработчика.
  2. Откройте Панель приложений.
  3. Нажмите Создать приложение.
  4. Заполните информацию о приложении:
    • Название приложения;
    • Контактный электронный адрес приложения для связи;
  5. На экране выбора сценария использования выберите Бизнес-переписка и Общайтесь с клиентами в WhatsApp. Нажмите Далее.
  6. Выберите существующее бизнес-портфолио или выполните подсказки, чтобы создать новое.
  7. Завершите создание приложения.

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

Для стабильной работы бота необходимо получить ID номера телефона и сгенерировать постоянный маркер (токен). Временный маркер, который выдается на странице Настройка API, действует всего 24 часа.

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

  1. Перейдите на страницу Настройки компании.
  2. В меню слева выберите Системные пользователи.
  3. Нажмите Добавить в правом верхнем углу и следуйте инструкциям, чтобы создать нового системного пользователя. Если у вас уже есть системный пользователь, можно использовать его.
  4. Нажмите Назначить объекты.
  5. В открывшемся окне:
    • Выберите свое приложение и активируйте переключатель Управление приложением в разделе Полный доступ.
    • Выберите свой аккаунт WhatsApp и активируйте переключатель Управление аккаунтами WhatsApp Business в разделе Полный доступ.
    • Нажмите Назначить объекты.
  6. Вернувшись в список системных пользователей, нажмите Сгенерировать маркер.
  7. Выберите ваше приложение из списка.
  8. Отметьте галочками разрешения:
    • business_management
    • whatsapp_business_messaging
    • whatsapp_business_management
  9. Скопируйте маркер и сохраните его для использования на последующих этапах.
warning

Сохраните марке в надежном месте (например, в менеджере паролей). Facebook покажет его только один раз. Если вы закроете окно, токен придется генерировать заново.

Получение ID номера телефона​

  1. Вернитесь в раздел Мои приложения и выберите ваше приложение.
  2. В меню слева разверните раздел WhatsApp и выберите Настройка API.
  3. В блоке Отправка и получение сообщений:
    • В поле От выберите нужный номер телефона. Если у вас еще нет номера, в меню слева выберите WhatsApp → Конфигурация, добавьте номер и подтвердите его через SMS. Затем вернитесь в раздел Настройка API
    • Скопируйте ID, который отобразится под номером.
примечание

ID номера телефона понадобятся вам при подключении канала в Agent Platform.

Подключение канала​

Добавить новый канал в проекте можно несколькими способами:

  • В проекте перейдите в раздел Интеграции, выберите Подключить → Канал → WhatsApp.
  • На холсте выберите Сообщение → Подключить канал → WhatsApp.

Укажите настройки:

  1. Задайте название. Оно будет отображаться в списке интеграций.
  2. ID номера телефона — вставьте идентификатор, который вы скопировали ранее.
  3. В поле Учетные данные Business API выберите Добавить новые, чтобы создать новые учетные данные для WhatsApp.
    1. Задайте название учетных данных.
    2. Токен — вставьте Постоянный маркер, который вы скопировали ранее, и нажмите Добавить.
  4. В Учетные данные Business API выберите учетные данные, которые только что создали.
  5. Включите Автоматический деплой, чтобы изменения автоматически публиковались в канале при нажатии кнопки Опубликовать на холсте. В противном случае их нужно публиковать вручную кнопкой Опубликовать в триггере Сообщение.
  6. Нажмите Добавить.

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

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

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

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

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

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