Вебхуки дозволяють отримувати сповіщення в реальному часі, коли події відбуваються у ваших ботах. Замість опитування нашого API, налаштуйте URL вебхука, і ми миттєво надсилатимемо вам події.
Доступні події
message.receivedНове повідомлення в чаті
message.editedПовідомлення було відредаговано
member.joinedКористувач приєднався до групи
member.leftКористувач покинув групу
bot.addedБота додано до групи
bot.removedБота видалено з групи
command.executedВиконано команду бота
module.triggeredСпрацювала дія модуля
Endpoints
/api/webhooksПерелік усіх налаштованих вебхуків
/api/webhooksСтворення нового ендпоінта вебхука
/api/webhooks/:idОновлення конфігурації вебхука
/api/webhooks/:idВидалення вебхука
/api/webhooks/:id/testНадсилання тестової події на ваш вебхук
Безпека вебхуків
Перевірка підпису
Усі навантаження вебхуків містять заголовок підпису для перевірки:
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.