Webhook

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

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

Пример: пользователь попал в бота онлайн-школы.

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

То есть с помощью вебхука другой сервис может запустить нужную цепочку сценария Smartbot Pro.

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

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, должно выполняться два условия: — разрешена отправка сообщений в лс — пользователь уже общался с ботом (бот не может первым написать пользователю)

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

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