Webhooks - Notifique

Webhook es la timbre de tu servidor: cuando algo cambia en Notifique, la API avisa con un POST JSON a tu URL.

Registrar por API

Scopes: webhooks:read y webhooks:manage.

curl -X POST https://api.notifique.dev/v1/webhooks \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Mi webhook",
    "url": "https://api.tudominio.com/receive",
    "events": ["message.sent", "message.delivered"],
    "instanceIds": []
  }'

Guarda el secret para validar X-Notifique-Signature.

Campo	Uso
`headers`	Mapa opcional de encabezados HTTP personalizados: hasta 10 pares, nombres de hasta 128 caracteres y valores de hasta 2.048. Los valores se cifran; `GET` los devuelve enmascarados. `Host`, `Content-Length`, `Content-Type`, `Transfer-Encoding`, `Connection` y `X-Notifique-*` están reservados.

Use PATCH /v1/webhooks/{id} para editar solo encabezados; {"headers": {}} los elimina todos. PUT también acepta headers junto con la configuración completa. La verificación de URL y cada entrega incluyen los encabezados configurados.

Entregas

Método	Ruta
GET	`/v1/webhooks/deliveries`
GET	`/v1/webhooks/deliveries/{deliveryId}`
POST	`/v1/webhooks/deliveries/{deliveryId}/resend`
POST	`/v1/webhooks/{id}/rotate-secret`

Guía completa: Webhooks.