Webhook'lar API

Gerçek zamanlı etkinlik bildirimleri alın

Webhook'lar, bot'larinizda olaylar gerceklestiginde gerçek zamanlı bildirimler almanizi sağlar. API'mizi sorgulamak yerine, bir webhook URL'si yapılandırın ve etkinlikleri anında size gönderelim.

Mevcut Etkinlikler

message.received

Sohbette yeni mesaj

message.edited

Mesaj düzenlendi

member.joined

Kullanıcı bir gruba katildi

member.left

Kullanıcı bir gruptan ayrildi

bot.added

Bot bir gruba eklendi

bot.removed

Bot bir gruptan cikarildi

command.executed

Bot komutu yurutuldu

module.triggered

Bir modül eylemi tetiklendi

Endpoints

GET
/api/webhooks

Tüm yapılandırılmış webhook'ları listeleyin

botId
POST
/api/webhooks

Yeni bir webhook endpoint'i oluşturun

urleventssecret
PATCH
/api/webhooks/:id

Webhook yapılandırmasını güncelleyin

urleventsstatus
DELETE
/api/webhooks/:id

Bir webhook'u silin

id
POST
/api/webhooks/:id/test

Webhook'unuza bir test etkinliği gönderin

id

Webhook Güvenliği

İmza Doğrulama

Tüm webhook verileri doğrulama için bir imza başlığı içerir:

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

Yeniden Deneme Politikası

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.

Daha Fazlasını Keşfedin

API entegrasyonunuz için güvenlik en iyi uygulamalarını öğrenin.

Security Guide