Desarrolladores
Webhooks
Cada notificación que genera su cuenta puede enviarse directamente a sus propios sistemas como un JSON POST firmado, de modo que lo que suceda en su alojamiento puede iniciar un flujo de trabajo en cualquier otro lugar.
Con qué puede conectarlo
Un webhook es una solicitud HTTPS ordinaria, por lo que cualquier elemento que pueda recibirla puede actuar en consecuencia. No necesita que desarrollemos una integración para su herramienta.
Plataformas de automatización
Dirija un webhook a un flujo de trabajo en n8n, Make, Zapier, Pipedream, Activepieces y cada evento se convertirá en un disparador: publique en un canal, abra un ticket, actualice una hoja de cálculo, llame a otra API. Las plataformas autohospedadas funcionan exactamente de la misma manera, siempre que el endpoint sea accesible a través de HTTPS.
CRM y servicios de asistencia
Envíe los eventos de facturación y de cuenta a HubSpot, Pipedrive, Salesforce, o a cualquier servicio de asistencia o CRM con un webhook entrante, para que el registro del cliente refleje lo que sucede con su alojamiento sin que nadie tenga que copiar los datos manualmente.
Cualquier otra cosa que escuche
Slack, Discord, Google Sheets, Airtable, Notion, su propio monitoreo, un almacén de datos o un pequeño script que usted haya escrito. Si puede aceptar un HTTPS POST y leer JSON, puede recibir estos datos.
Qué se envía
Usted elige qué categorías van a qué destino, y puede conectar varios, de modo que la facturación vaya a un lugar y las alertas del sitio a otro. Todo está activado de forma 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 de certificado.
Soporte y dominios
Tickets abiertos y escalados, transferencias de dominios, renovaciones y cambios de DNS.
Demostrar que una solicitud procede de nosotros
Cada solicitud está firmada con un secreto que solo usted y nosotros poseemos. Compruebe la firma antes de actuar sobre el cuerpo: estos encabezados llegan con 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.paidLa marca de tiempo se firma junto con el cuerpo en lugar de enviarse junto a él, de modo que una solicitud interceptada no pueda reproducirse más tarde contra usted. Rechace cualquier elemento con una antigüedad superior a unos minutos.
Su secreto de firma se muestra una sola vez, cuando añade el webhook. No podemos volver a mostrarlo; si lo pierde, elimine el destino y vuelva a añadirlo.
Configurando uno
- En su panel de control, abra Notificaciones y añada un destino de tipo Webhook.
- Proporcione su extremo HTTPS y copie el secreto de firma que le mostramos.
- Presione Test. Enviamos una solicitud real con el mismo formato que una en vivo, para que pueda realizar integraciones con ella antes de que ocurra algo real.
- Elija qué categorías debe recibir ese destino. Los nuevos tipos de notificaciones 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 informan cuando ocurre algo. La API es el medio para hacer que algo suceda: cada operación que realiza el panel de control está a su disposición.