Développeurs
Webhooks
Chaque notification générée par votre compte peut être envoyée directement vers vos propres systèmes sous forme de requête JSON POST signée, permettant ainsi à tout événement sur votre hébergement de déclencher un flux de travail partout ailleurs.
Ce que vous pouvez y connecter
Un webhook est une requête HTTPS ordinaire, de sorte que tout service capable d'en recevoir une peut l'exploiter. Vous n'avez pas besoin que nous développions 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 devient un déclencheur — publiez sur un canal, ouvrez un ticket, mettez à jour un tableur, 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 services d'assistance
Envoyez les événements de facturation et de compte à HubSpot, Pipedrive, Salesforce, ou à tout service d'assistance ou CRM doté d'un webhook entrant, afin qu'un dossier client reflète l'activité de son hébergement sans qu'aucune saisie manuelle ne soit nécessaire.
Tout autre élément à l'écoute
Slack, Discord, Google Sheets, Airtable, Notion, votre propre système de surveillance, un entrepôt de données ou un petit script que vous avez écrit. S'ils peuvent accepter une requête POST HTTPS et lire du JSON, ils peuvent recevoir ces éléments.
Ce qui est envoyé
Vous choisissez quelles catégories vont vers quelle destination — et vous pouvez en connecter plusieurs, de sorte que la facturation puisse aller à un endroit et les alertes du site à un autre. Tout est activé par défaut.
Facturation et paiements
Factures émises et réglées, paiements ayant échoué, cartes sur le point d'expirer, renouvellements et annulations.
Sites et sécurité
Provision achevé, site suspendu, malware détecté, sauvegardes et modifications de certificats.
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 vous et nous seuls détenons. Vérifiez la signature avant de traiter le corps de la requête — ces en-têtes accompagnent 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 de la requête plutôt qu'en tant qu'élément séparé, de sorte qu'une requête interceptée ne peut pas vous être rejouée ultérieurement. 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 pas l'afficher à nouveau. Si vous le perdez, supprimez la destination et rajoutez-la.
Configuration d'un nouveau
- Dans votre tableau de bord, ouvrez Notifications et ajoutez une destination de type Webhook.
- Donnez-lui votre point de terminaison HTTPS et copiez le secret de signature que nous vous affichons.
- Testez la requête. Nous envoyons une requête réelle au même format qu'une requête en production, ce qui vous permet de concevoir votre application avant qu'un événement réel ne se produise.
- Choisissez les catégories que cette destination doit recevoir. Les nouveaux types de notification sont activés automatiquement.
Vous pouvez ajouter autant de destinations que vous le souhaitez, combiner des webhooks avec des e-mails, Slack et Telegram, et attribuer à chacune un ensemble de catégories différent.
Vous préférez nous appeler ?
Les webhooks vous préviennent lorsqu'un événement se produit. L'API vous permet de provoquer un événement — toutes les opérations effectuées par le tableau de bord sont à votre disposition.