Saltar al contenido principal

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.

LlamadaPermiso
POST /api/v1/hooks/subscriptionsintegrations:write
GET /api/v1/hooks/subscriptionsintegrations: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_url debe ser una dirección https pública. Se rechazan loopback, redes privadas y nombres internos.
  • event es un tipo de evento o un patrón de tema como call.*. Debe ser un evento que la clave pueda recibir para toda la empresa, con el permiso indicado en Webhooks salientes. Si no, la respuesta es 400.
  • source es 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.