Вебхуки

Получайте события бота на свой сервер в реальном времени — без опроса API.

Регистрация вебхука

Укажите URL и список событий, на которые хотите подписаться:

POST /bots/847291/webhook
{
  "url": "https://ваш-сервер.ру/hooks/flowgram",
  "events": ["message.received", "button.clicked", "payment.completed"]
}

Типы событий

Событие	Когда срабатывает
`message.received`	Пользователь написал боту
`button.clicked`	Нажата кнопка в сценарии
`payment.completed`	Оплата прошла успешно
`user.blocked`	Пользователь заблокировал бота

Проверка подписи

Каждый запрос вебхука подписывается HMAC-SHA256 в заголовке X-Flowgram-Signature. Сверяйте подпись на своей стороне, чтобы убедиться, что запрос действительно пришёл от Flowgram, а не от третьей стороны.

Если ваш сервер не отвечает 200 OK в течение 5 секунд, Flowgram повторит доставку ещё дважды с интервалом в минуту.