Webhooks

Suscribirse a un evento de webhook

post

Suscríbete para recibir notificaciones webhook de mensajes entrantes o salientes para un tipo de conexión específico. El webhook se enviará inmediatamente cuando ocurra el evento, con los datos originales del proveedor y una versión estandarizada mapeada.

Seguridad de Webhooks: Todos los webhooks incluyen un header X-Webhook-Signature que contiene una firma HMAC-SHA256. Calcula HMAC-SHA256(request_body, tu_api_key) y compara con el valor del header para verificar la autenticidad.

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

connection_typestring · enumRequiredExample: whatsapp-businessPossible values:

event_typestring · enumRequiredExample: 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": "2025-12-08T11:17:09.301Z",
    "updated_at": "2025-12-08T11:17:09.301Z"
  }
}

Desuscribirse de un evento de webhook

delete

Elimina una suscripción de webhook para un tipo de conexión y tipo de evento específicos.

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

connection_typestring · enumRequiredPossible 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 · enumOptionalPossible values:

event_typestring · enumOptionalPossible 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": "2025-12-08T11:17:09.301Z",
      "updated_at": "2025-12-08T11:17:09.301Z"
    }
  ],
  "count": 1
}