Développeurs
Webhooks
Chaque notification générée par votre compte peut être envoyée directement à vos propres systèmes sous la forme d’un JSON POST signé — ainsi, ce qui se passe sur votre hébergement peut déclencher un flux de travail n’importe où ailleurs.
À quoi vous pouvez le connecter
Un webhook est une requête HTTPS ordinaire, de sorte que tout élément capable d’en recevoir une peut agir en conséquence. Vous n’avez pas besoin de nous pour créer une intégration pour votre outil.
Plateformes d’automatisation
Pointez un webhook vers un flux de travail dans n8n, Make, Zapier, Pipedream, Activepieces et chaque événement deviendra un déclencheur — publiez dans un canal, ouvrez un ticket, mettez à jour une feuille de calcul, appelez une autre API. Les plateformes auto-hébergées fonctionnent exactement de la même manière, tant que le point de terminaison est accessible via HTTPS.
CRM et centres d’assistance
Envoyez les événements de facturation et de compte à HubSpot, Pipedrive, Salesforce, ou à tout centre d’assistance ou CRM disposant d’un webhook entrant, afin que le dossier d’un client reflète l’état de son hébergement sans que personne n’ait à copier les données manuellement.
Tout autre élément à l’écoute
Slack, Discord, Google Sheets, Airtable, Notion, votre propre surveillance, un entrepôt de données ou un petit script que vous avez écrit. S’il peut accepter une requête HTTPS POST et lire du JSON, il peut recevoir ces données.
Ce qui est envoyé
Vous choisissez quelles catégories vont vers quelle destination — et vous pouvez en connecter plusieurs, afin que la facturation aille à un endroit et les alertes du site à un autre. Tout est activé par défaut.
Facturation et paiements
Factures émises et payées, paiements ayant échoué, cartes arrivant à expiration, renouvellements et annulations.
Sites et sécurité
Provisionnement terminé, un site suspendu, logiciel malveillant détecté, sauvegardes et modifications de certificat.
Support et domaines
Tickets ouverts et escaladés, transferts de domaine, renouvellements et modifications DNS.
Prouver qu’une requête provient de nous
Chaque requête est signée avec un secret que seuls vous et nous détenons. Vérifiez la signature avant d’agir sur le corps de texte — ces en-têtes arrivent avec chaque livraison :
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.paidL’horodatage est signé avec le corps plutôt qu’envoyé à côté, de sorte qu’une requête interceptée ne puisse pas être rejouée ultérieurement contre vous. Rejetez tout élément datant de plus de quelques minutes.
Votre secret de signature n’est affiché qu’une seule fois, lorsque vous ajoutez le webhook. Nous ne pouvons plus l’afficher — si vous le perdez, supprimez la destination et ajoutez-la à nouveau.
Configuration en cours
- Dans votre tableau de bord, ouvrez Notifications et ajoutez une destination de type Webhook.
- Indiquez votre point de terminaison HTTPS et copiez le secret de signature que nous vous affichons.
- Appuyez sur Test. Nous envoyons une véritable requête sous la même forme qu’une requête réelle, afin que vous puissiez développer avec celle-ci avant que quoi que ce soit de réel ne se produise.
- Choisissez les catégories que cette destination doit recevoir. Les nouveaux types de notifications sont activés automatiquement.
Vous pouvez ajouter autant de destinations que vous le souhaitez, combiner les webhooks avec les e-mails, Slack et Telegram, et attribuer à chacune un ensemble de catégories différent.
Vous préférez plutôt nous appeler ?
Les webhooks vous informent lorsqu’un événement s’est produit. L’API est le moyen par lequel vous déclenchez une action — chaque opération effectuée par le tableau de bord est à votre disposition.