Ontwikkelaars

Webhooks

Elke melding die uw account genereert, kan rechtstreeks naar uw eigen systemen worden gestuurd als een ondertekende JSON POST — zodat wat er op uw hosting gebeurt, overal elders een workflow kan starten.

Waar u het aan kunt koppelen

Een webhook is een gewone HTTPS-aanvraag, dus alles wat er een kan ontvangen, kan erop reageren. U hoeft geen integratie voor uw tool door ons te laten bouwen.

Automatieplatforms

Richt een webhook op een workflow in n8n, Make, Zapier, Pipedream, Activepieces en elke gebeurtenis wordt een trigger: post naar een kanaal, open een ticket, werk een spreadsheet bij, roep een andere API aan. Zelf-gehoste platforms werken precies hetzelfde, zolang het eindpunt bereikbaar is via HTTPS.

CRM's en helpdesks

Stuur facturatie- en accountevenementen naar HubSpot, Pipedrive, Salesforce, of naar een helpdesk of CRM met een inkomende webhook, zodat een klantenbestand weerspiegelt wat hun hosting doet zonder dat iemand dit handmatig hoeft over te nemen.

Al wat ook luistert

Slack, Discord, Google Sheets, Airtable, Notion, uw eigen monitoring, een datawarehouse of een klein script dat u hebt geschreven. Als het een HTTPS POST kan accepteren en JSON kan lezen, kan het deze ontvangen.

Wat er wordt verzonden

U kiest zelf welke categorieën naar welke bestemming gaan – en u kunt er meerdere koppelen, zodat facturering naar de ene plek kan gaan en site-meldingen naar een andere. Alles staat standaard ingeschakeld.

Facturatie en betalingen

Uitgegeven en betaalde facturen, mislukte betalingen, kaarten die bijna verlopen, verlengingen en opzeggingen.

Sites en beveiliging

Provisioning gereed, een site opgeschort, malware gevonden, back-ups en certificaatwijzigingen.

Ondersteuning en domeinen

Geopende en geëscaleerde tickets, domeinoverdrachten, verlengingen en DNS-wijzigingen.

Bewijzen dat een verzoek van ons afkomstig is

Elk verzoek is ondertekend met een geheim dat alleen u en wij kennen. Controleer de handtekening voordat u actie onderneemt op basis van de inhoud — deze headers worden bij elke levering meegeleverd:

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

De tijdstempel wordt samen met de body ondertekend in plaats de ernaast te worden verzonden, zodat een onderschept verzoek later niet tegen u kan worden herhaald. Wijs alles af dat ouder is dan een paar minuten.

Uw ondertekeningsgeheim wordt slechts één keer getoond wanneer u de webhook toevoゲストegt. We kunnen het niet opnieuw tonen — als u het kwijtraakt, verwijdert u de bestemming en voegt u deze opnieuw toe.

Een instellen

Open in uw dashboard Meldingen en voeg een bestemming van het type Webhook toe.
Geef uw HTTPS-eindpunt op en kopieer het ondertekeningsgeheim dat we u tonen.
Test verzenden. We sturen een echt verzoek in dezelfde vorm als een live verzoek, zodat u hierop kunt bouwen voordat er iets echts gebeurt.
Kies welke categorieën die bestemming moet ontvangen. Nieuwe soorten meldingen worden automatisch ingeschakeld.

U kunt zoveel bestemmingen toevoegen als u wilt, webhooks combineren met e-mail, Slack en Telegram, en elke bestemming een andere set categorieën geven.

Belt u liever?

Webhooks vertellen u wanneer er iets is gebeurd. Met de API laat u iets gebeuren — elke bewerking die het dashboard uitvoert, is voor u beschikbaar.

API-referentie bekijken