Webhooks ermöglichen es Ihnen, Echtzeit-Benachrichtigungen zu erhalten, wenn Ereignisse in Ihren Bots auftreten. Anstatt unsere API abzufragen, konfigurieren Sie eine Webhook-URL und wir senden Ihnen Ereignisse sofort zu.

Verfügbare Ereignisse

message.received

Neue Nachricht in einem Chat

message.edited

Nachricht wurde bearbeitet

member.joined

Benutzer ist einer Gruppe beigetreten

member.left

Benutzer hat eine Gruppe verlassen

bot.added

Bot wurde einer Gruppe hinzugefügt

bot.removed

Bot wurde aus einer Gruppe entfernt

command.executed

Bot-Befehl wurde ausgeführt

module.triggered

Eine Modul-Aktion wurde ausgelöst

Endpoints

GET

/api/webhooks

Alle konfigurierten Webhooks auflisten

botId

POST

/api/webhooks

Einen neuen Webhook-Endpunkt erstellen

urleventssecret

PATCH

/api/webhooks/:id

Webhook-Konfiguration aktualisieren

urleventsstatus

DELETE

/api/webhooks/:id

Einen Webhook löschen

POST

/api/webhooks/:id/test

Ein Testereignis an Ihren Webhook senden

Webhook-Sicherheit

Signaturverifizierung

Alle Webhook-Payloads enthalten einen Signatur-Header zur Verifizierung:

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!"
  }
}

Wiederholungsrichtlinie

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.

Mehr erkunden

Erfahren Sie mehr über Sicherheits-Best-Practices für Ihre API-Integration.

Security Guide

Webhooks API