Webhooks REST para Zapier, Make y n8n
Un webhook REST permite que una plataforma de automatización pida eventos a MonoPbx, un disparador a la vez. Cuando alguien activa un Zap, un escenario o un flujo de trabajo, la plataforma suscribe su propia dirección a un evento. Cuando lo desactiva, cancela la suscripción. MonoPbx envía entonces cada evento que coincide a esa dirección como un POST firmado.
Una suscripción es un endpoint de webhook saliente para un tipo de evento, así que la firma, los reintentos, la protección de direcciones salientes y las reglas sobre quién puede recibir qué evento son las mismas. Cuenta para el límite de endpoints de webhook de su empresa.
Llamadas
Todas las llamadas usan una clave de API o un token de usuario. Vea los Primeros pasos con la API.
| Llamada | Permiso |
|---|---|
POST /api/v1/hooks/subscriptions | integrations:write |
GET /api/v1/hooks/subscriptions | integrations:read |
DELETE /api/v1/hooks/subscriptions/{id} | integrations:write |
Suscríbase con:
{ "target_url": "https://hooks.zapier.com/hooks/standard/123/abc", "event": "call.ended", "source": "zapier" }
target_urldebe ser una direcciónhttpspública. Se rechazan loopback, redes privadas y nombres internos.eventes un tipo de evento o un patrón de tema comocall.*. Debe ser un evento que la clave pueda recibir para toda la empresa, con el permiso indicado en Webhooks salientes. Si no, la respuesta es400.sourcees opcional (zapier,make,n8n) y sirve para distinguir las suscripciones.
La respuesta es 201 con el id de la suscripción y un secret de firma de Standard Webhooks, que se muestra una sola vez. Conserve el id para cancelar la suscripción. La lista nunca muestra secretos y no incluye los endpoints creados en la consola. Eliminar una suscripción también quita sus entregas en espera; un id desconocido, el id de otra empresa o un endpoint de la consola responden 404.
Recibir eventos
Cada entrega es un sobre JSON {id, type, occurred_at, data} con los encabezados de Standard Webhooks descritos en Webhooks salientes. Use id para ignorar duplicados.
Zapier, Make y n8n
Use el disparador de webhook de la plataforma para suscribirse con estas llamadas, y la API pública para las acciones. También puede recibir los mismos eventos en un endpoint de webhook.