Webhook-и позволяют получать уведомления в реальном времени при возникновении событий в ваших ботах. Вместо опроса нашего API настройте URL webhook-а, и мы мгновенно отправим вам события.
Доступные события
message.receivedНовое сообщение в чате
message.editedСообщение было отредактировано
member.joinedПользователь присоединился к группе
member.leftПользователь покинул группу
bot.addedБот был добавлен в группу
bot.removedБот был удалён из группы
command.executedБыла выполнена команда бота
module.triggeredБыло вызвано действие модуля
Endpoints
/api/webhooksСписок всех настроенных webhook-ов
/api/webhooksСоздание нового эндпоинта webhook
/api/webhooks/:idОбновление конфигурации webhook
/api/webhooks/:idУдаление webhook-а
/api/webhooks/:id/testОтправка тестового события на ваш webhook
Безопасность Webhook-ов
Проверка подписи
Все данные webhook-ов содержат заголовок подписи для проверки:
X-BotLaunch-Signature: sha256=abc123...Example Payload
{
"event": "message.received",
"timestamp": "2024-01-15T10:30:00Z",
"data": {
"messageId": "msg_abc123",
"chatId": "-100123456789",
"from": {
"id": 123456789,
"username": "johndoe"
},
"text": "Hello, bot!"
}
}Политика повторных попыток
If your endpoint returns a non-2xx status, we'll retry up to 3 times with exponential backoff (10s, 30s, 90s). After 3 failures, the webhook is paused.