Ontwikkelaars

Webhooks

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

Alle ontwikkelaarsdocumentatie →

Waar u het mee kunt verbinden

Een webhook is een gewoon HTTPS-verzoek, dus alles wat er een kan ontvangen, kan ernaar handelen. U hebt ons niet nodig om een integratie voor uw tool te bouwen.

Automatiseringsplatformen

Koppel een webhook aan een workflow in n8n, Make, Zapier, Pipedream, Activepieces en elke gebeurtenis wordt een trigger — plaats een bericht in een kanaal, open een ticket, werk een spreadsheet bij of roep een andere API aan. Zelf gehoste platforms werken op precies dezelfde manier, zolang het eindpunt bereikbaar is via HTTPS.

CRM's en helpdesks

Verzend facturatie- en accountgebeurtenissen naar HubSpot, Pipedrive, Salesforce, of naar een helpdesk of CRM met een inkomende webhook, zodat een klantrecord weergeeft wat er met diens hosting gebeurt zonder dat iemand gegevens handmatig hoeft over te nemen.

Al het andere dat 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 wordt verzonden

U kiest welke categorieën naar welke bestemming gaan — en u kunt er meerdere koppelen, zodat facturatie naar de ene plek kan gaan en sitewaarschuwingen naar een andere. Standaard staat alles ingeschakeld.

Facturering en betalingen

Uitgereikte en betaalde facturen, mislukte betalingen, kaarten die bijna verlopen, verlengingen en annuleringen.

Sites en beveiliging

Inrichting voltooid, een site opgeschort, malware gevonden, back-ups en certificaatwijzigingen.

Ondersteuning en domeinen

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

Bewijzen dat een verzoek van ons afkomstig is

Elk verzoek is ondertekend met een geheim dat alleen u en wij bezitten. Controleer de handtekening voordat u actie onderneemt op de hoofdtekst — deze headers worden bij elke levering meegestuurd:

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 hoofdtekst ondertekend in plaats van ernaast te worden verzonden, zodat een onderschept verzoek later niet opnieuw naar u kan worden verzonden. Wijs alles af wat ouder is dan een paar minuten.

Uw ondertekeningsgeheim wordt slechts één keer getoond, wanneer u de webhook toevoegt. We kunnen het niet opnieuw tonen — als u het verliest, verwijdert u de bestemming en voegt u deze opnieuw toe.

Bezig met instellen van een

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.
Druk op Test. 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 aan elke bestemming een andere set categorieën toewijzen.

Wilt u ons liever bellen?

Webhooks laten u weten wanneer er iets is gebeurd. Met de API brengt u zelf iets teweeg — elke bewerking die het dashboard uitvoert, is voor u beschikbaar.

Doorzoek de API-referentie