API de Webhooks

Recibe notificaciones de eventos en tiempo real

Los webhooks te permiten recibir notificaciones en tiempo real cuando ocurren eventos en tus bots. En lugar de consultar nuestra API, configura una URL de webhook y te enviaremos los eventos al instante.

Eventos disponibles

message.received

Nuevo mensaje en un chat

message.edited

Se editó un mensaje

member.joined

Un usuario se unió a un grupo

member.left

Un usuario abandonó un grupo

bot.added

Se añadió un bot a un grupo

bot.removed

Se eliminó un bot de un grupo

command.executed

Se ejecutó un comando de bot

module.triggered

Se activó una acción de módulo

Endpoints

GET
/api/webhooks

Listar todos los webhooks configurados

botId
POST
/api/webhooks

Crear un nuevo endpoint de webhook

urleventssecret
PATCH
/api/webhooks/:id

Actualizar configuración de webhook

urleventsstatus
DELETE
/api/webhooks/:id

Eliminar un webhook

id
POST
/api/webhooks/:id/test

Enviar un evento de prueba a tu webhook

id

Seguridad de webhooks

Verificación de firma

Todos los payloads de webhook incluyen un encabezado de firma para verificación:

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

Política de reintentos

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.

Explorar más

Aprende sobre las mejores prácticas de seguridad para tu integración con la API.

Security Guide