Webhook memungkinkan Anda menerima notifikasi real-time saat peristiwa terjadi di bot Anda. Alih-alih melakukan polling ke API kami, konfigurasikan URL webhook dan kami akan mengirim event kepada Anda secara instan.

Event yang Tersedia

message.received

Pesan baru di chat

message.edited

Pesan telah diedit

member.joined

Pengguna bergabung ke grup

member.left

Pengguna keluar dari grup

bot.added

Bot ditambahkan ke grup

bot.removed

Bot dihapus dari grup

command.executed

Perintah bot dijalankan

module.triggered

Aksi modul dipicu

Endpoints

GET

/api/webhooks

Daftar semua webhook yang dikonfigurasi

botId

POST

/api/webhooks

Buat endpoint webhook baru

urleventssecret

PATCH

/api/webhooks/:id

Perbarui konfigurasi webhook

urleventsstatus

DELETE

/api/webhooks/:id

Hapus webhook

POST

/api/webhooks/:id/test

Kirim event uji coba ke webhook Anda

Keamanan Webhook

Verifikasi Tanda Tangan

Semua payload webhook menyertakan header tanda tangan untuk verifikasi:

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

Kebijakan Percobaan Ulang

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.

Jelajahi Selengkapnya

Pelajari praktik keamanan terbaik untuk integrasi API Anda.

Security Guide

Webhooks API