Desarrolladores

Webhooks

Cada notificación que genera su cuenta se puede enviar directamente a sus propios sistemas como un POST de JSON firmado, de modo que lo que ocurre en su alojamiento puede iniciar un flujo de trabajo en cualquier otro lugar.

A qué lo puedes conectar

Un webhook es una petición HTTPS ordinaria, por lo que cualquier sistema que pueda recibir una puede procesarla. No necesita que desarrollemos una integración para su herramienta.

Plataformas de automatización

Apunta un webhook a un flujo de trabajo en n8n, Make, Zapier, Pipedream, Activepieces y cada evento se convierte en un activador: publica en un canal, abre un ticket, actualiza una hoja de cálculo, llama a otra API. Las plataformas autohospedadas funcionan exactamente de la misma manera, siempre que el punto de enlace sea accesible mediante HTTPS.

CRMs y centros de ayuda

Envíe eventos de facturación y de cuenta a HubSpot, Pipedrive, Salesforce, o a cualquier servicio de asistencia técnica o CRM con un webhook entrante, para que el registro de un cliente refleje lo que hace su alojamiento sin que nadie tenga que copiarlo manualmente.

Cualquier otra cosa que escuche

Slack, Discord, Google Sheets, Airtable, Notion, su propia supervisión, un almacén de datos o un pequeño script que haya escrito. Si puede aceptar un POST HTTPS y leer JSON, puede recibirlos.

Qué se envía

Usted elige qué categorías van a qué destino; además, puede conectar varias para que la facturación vaya a un lugar y las alertas del sitio a otro. Todo está activado de manera predeterminada.

Facturación y pagos

Facturas emitidas y pagadas, pagos fallidos, tarjetas a punto de caducar, renovaciones y cancelaciones.

Sitios y seguridad

Aprovisionamiento finalizado, un sitio suspendido, malware encontrado, copias de seguridad y cambios en el certificado.

Soporte y dominios

Tickets abiertos y escalados, transferencias de dominios, renovaciones y cambios de DNS.

Demostrar que una solicitud provino de nosotros

Cada solicitud está firmada con un secreto que solo usted y nosotros poseemos. Compruebe la firma antes de procesar el contenido; estas cabeceras se incluyen en cada entrega:

X-Zinn-Signature: sha256=<hmac of `timestamp.body`>
X-Zinn-Timestamp: unix seconds
X-Zinn-Delivery: stable id for this delivery
X-Zinn-Event: invoice.paid

La marca de tiempo se firma junto con el cuerpo en lugar de enviarse al lado, de modo que una solicitud que alguien haya capturado no pueda reproducirse en su contra más tarde. Rechace cualquier elemento que tenga más de unos minutos de antigüedad.

Su secreto de firma se muestra una sola vez, al añadir el webhook. No podemos volver a mostrarlo; si lo pierde, elimine el destino y vuelva a añadirlo.

Configurando uno

En su panel, abra Notificaciones y agregue un destino de tipo Webhook.
Proporcióneles su endpoint HTTPS y copie el secreto de firma que le mostramos.
Probar. Enviamos una solicitud real con el mismo formato que una activa, para que pueda desarrollarla antes de que ocurra cualquier evento real.
Elija qué categorías debe recibir ese destino. Los nuevos tipos de notificación se activan automáticamente.

Puede agregar tantos destinos como desee, combinar webhooks con correo electrónico, Slack y Telegram, y asignar a cada uno un conjunto diferente de categorías.

¿Prefiere llamarnos por teléfono?

Los webhooks le avisan cuando algo sucede. La API es la forma de hacer que algo suceda; todas las operaciones que realiza el panel de control están a su disposición.

Explorar la referencia de la API