Search…
⌃K

Webhook

Эта функция позволяет запускать бота по API из любого другого сервиса.

Зачем это нужно

Пример: пользователь попал в бота онлайн-школы.
Бот рассказал про курсы, и клиент зашел на сайт. Там купил один из курсов. Если в обучающей платформе курса настроить интеграции по webhook, после этого бот сам напишет клиенту.
То есть с помощью вебхука другой сервис может запустить нужную цепочку сценария Smartbot Pro.

Создание и настройка webhook

  1. 1.
    Создаем токен.
Создать новый токен и увидеть список всех токенов проекта можно в разделе «Интеграции».
Для запуска бота нужно создать токен с правом выполнения блоков. Нажмите «Создать токен» и выберите «Уровень доступа — Выполнение блоков».
2. Создаем событие "Webhook" в сценарии
В сценарии для запуска цепочки из другого сервиса нужно настроить специальное событие Webhook, которое позволит запустить бота по API.
Переходим в нужный сценарий, в боковом меню выбираем "События" --> "Webhook".
3. Указываем токен
В блоке Webhook выбираем созданный токен или создаем новый.
4. Выбираем канал
Выберите канал в социальной сети, где сработает бот после того, как его «дернуть» вебхуком.
Если бот работает одновременно в ЛС и в беседе, необходимо также указать нужный чат:
6. Параметры запроса: URL и body.
Скопируйте указанный URL и отправьте на него POST-запрос из вашего сервиса.
:
Скопируйте следующий JSON и вставьте его в Body запроса:
peer_id — это ID чата, в который будет отправлено сообщение от бота.
Если бот должен сработать в групповом чате, то peer_id установится автоматически.
Если бот должен сработать в ЛС, то peer_id нужно заполнить самостоятельно в соответствии с подсказкой.

Требования к отправке сообщения через Webhook

Чтобы пользователь получил сообщение через webhook, должно выполняться два условия: — разрешена отправка сообщений в лс — пользователь уже общался с ботом (бот не может первым написать пользователю)

Удаление токена

Если токен украден злоумышленником, его нужно удалить в разделе «Интеграции».