Webhooks

Suscribirse a un evento de webhook

post

Suscríbete para recibir notificaciones webhook. Existen dos tipos de eventos:

Eventos de mensajes (message.incoming, message.outgoing): Requieren connection_type. Se envían cuando hay mensajes entrantes o salientes en un canal específico.

Eventos de leads (lead.smart_tag_assigned, lead.variable_assigned): NO requieren connection_type. Se envían cuando se asigna un smart tag o se modifica una variable de un lead.

Seguridad: Todos los webhooks incluyen un header X-Webhook-Signature con firma HMAC-SHA256. Calcula HMAC-SHA256(request_body, tu_api_key) y compara con el header para verificar autenticidad.

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

connection_typestring · enumOptional

Requerido solo para eventos de mensajes (message.incoming, message.outgoing). No se requiere para eventos de leads.

Example: whatsapp-businessPossible values:

event_typestring · enumRequired

Tipo de evento. Eventos de mensajes requieren connection_type, eventos de leads no requieren connection_type.

Example: message.incomingPossible values:

webhook_urlstring · uriRequiredExample: https://your-domain.com/webhook

Responses

200

Suscripción creada exitosamente

application/json

400

Error de validación o conexión no encontrada/no habilitada

application/json

401

No autorizado (API Key ausente o inválida)

application/json

500

Error interno

application/json

post

/webhooks/subscription

HTTPcURLJavaScriptPython

POST /public/v1/webhooks/subscription HTTP/1.1
Host: api.prometheo.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 119

{
  "connection_type": "whatsapp-business",
  "event_type": "message.incoming",
  "webhook_url": "https://your-domain.com/webhook"
}

{
  "success": true,
  "message": "Suscripción de webhook creada exitosamente",
  "subscription": {
    "id": "text",
    "connection_type": "text",
    "event_type": "text",
    "webhook_url": "text",
    "active": true,
    "created_at": "2026-02-03T21:13:33.098Z",
    "updated_at": "2026-02-03T21:13:33.098Z"
  }
}

Desuscribirse de un evento de webhook

delete

Elimina una suscripción de webhook. Para eventos de mensajes se requiere connection_type, para eventos de leads solo se requiere event_type.

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

connection_typestring · enumOptional

Requerido solo para eventos de mensajes

Possible values:

event_typestring · enumRequiredPossible values:

Responses

200

Suscripción eliminada exitosamente

application/json

401

No autorizado

application/json

404

Suscripción no encontrada

application/json

500

Error interno

application/json

delete

/webhooks/subscription

HTTPcURLJavaScriptPython

DELETE /public/v1/webhooks/subscription HTTP/1.1
Host: api.prometheo.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 71

{
  "connection_type": "whatsapp-business",
  "event_type": "message.incoming"
}

{
  "success": true,
  "message": "Suscripción de webhook eliminada exitosamente"
}

Listar todas las suscripciones de webhook

get

Obtiene todas las suscripciones de webhook activas para tu organización, con filtrado opcional.

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

connection_typestring · enumOptional

Filtrar por tipo de conexión (solo aplica a eventos de mensajes)

Possible values:

event_typestring · enumOptional

Filtrar por tipo de evento

Possible values:

Responses

200

Suscripciones obtenidas exitosamente

application/json

401

No autorizado

application/json

500

Error interno

application/json

get

/webhooks/subscriptions

HTTPcURLJavaScriptPython

GET /public/v1/webhooks/subscriptions HTTP/1.1
Host: api.prometheo.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "success": true,
  "subscriptions": [
    {
      "id": "text",
      "connection_type": "text",
      "event_type": "text",
      "webhook_url": "text",
      "active": true,
      "connection_enabled": true,
      "connection_status": "text",
      "created_at": "2026-02-03T21:13:33.098Z",
      "updated_at": "2026-02-03T21:13:33.098Z"
    }
  ],
  "count": 1
}