Les webhooks vous permettent de recevoir des notifications en temps réel lorsque des événements se produisent dans vos bots. Au lieu d'interroger notre API, configurez une URL de webhook et nous vous enverrons les événements instantanément.
Événements disponibles
message.receivedNouveau message dans un chat
message.editedUn message a été modifié
member.joinedUn utilisateur a rejoint un groupe
member.leftUn utilisateur a quitté un groupe
bot.addedUn bot a été ajouté à un groupe
bot.removedUn bot a été retiré d'un groupe
command.executedUne commande de bot a été exécutée
module.triggeredUne action de module a été déclenchée
Endpoints
/api/webhooksLister tous les webhooks configurés
/api/webhooksCréer un nouveau endpoint de webhook
/api/webhooks/:idMettre Ă jour la configuration du webhook
/api/webhooks/:idSupprimer un webhook
/api/webhooks/:id/testEnvoyer un événement de test à votre webhook
Sécurité des webhooks
VĂ©rification de signature
Tous les payloads de webhook incluent un en-tête de signature pour la vérification :
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!"
}
}Politique de réessai
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.
Explorer davantage
Découvrez les bonnes pratiques de sécurité pour votre intégration API.
Security Guide