Entwickler
Webhooks
Jede Benachrichtigung, die Ihr Konto generiert, kann als signierter JSON POST direkt an Ihre eigenen Systeme gesendet werden — so kann das, was auf Ihrem Hosting geschieht, überall einen Workflow starten.
Womit Sie es verbinden können
Ein Webhook ist eine gewöhnliche HTTPS-Anfrage, sodass alles, was eine solche empfangen kann, darauf reagieren kann. Sie benötigen uns nicht, um eine Integration für Ihr Tool zu erstellen.
Automatisierungsplattformen
Richten Sie einen Webhook auf einen Workflow in n8n, Make, Zapier, Pipedream, Activepieces aus, und jedes Ereignis wird zu einem Auslöser – posten Sie in einem Kanal, öffnen Sie ein Ticket, aktualisieren Sie eine Tabelle, rufen Sie eine andere API auf. Selbst gehostete Plattformen funktionieren genau gleich, solange der Endpunkt über HTTPS erreichbar ist.
CRMs und Helpdesks
Senden Sie Abrechnungs- und Kontoereignisse an HubSpot, Pipedrive, Salesforce oder an ein beliebiges Helpdesk- oder CRM-System mit einem eingehenden Webhook, damit ein Kundendatensatz den aktuellen Stand des Hostings widerspiegelt, ohne dass jemand Daten manuell übertragen muss.
Alles andere, was lauscht
Slack, Discord, Google Sheets, Airtable, Notion, Ihr eigenes Monitoring, ein Data-Warehouse oder ein kleines Skript, das Sie geschrieben haben. Wenn es einen HTTPS-POST annehmen und JSON lesen kann, kann es diese empfangen.
Was gesendet wird
Sie wählen aus, welche Kategorien an welches Ziel gesendet werden – und Sie können mehrere verbinden, sodass Abrechnungsinformationen an einen Ort und Website-Benachrichtigungen an einen anderen gesendet werden können. Standardmäßig ist alles aktiviert.
Abrechnung und Zahlungen
Ausgestellte und bezahlte Rechnungen, fehlgeschlagene Zahlungen, bald ablaufende Karten, Verlängerungen und Kündigungen.
Websites und Sicherheit
Bereitstellung abgeschlossen, eine Website gesperrt, Malware gefunden, Backups und Zertifikatsänderungen.
Support und Domains
Geöffnete und eskalierte Tickets, Domain-Transfers, Verlängerungen und DNS-Änderungen.
Nachweisen, dass eine Anfrage von uns stammt
Jede Anfrage ist mit einem Geheimnis signiert, das nur Sie und wir besitzen. Überprüfen Sie die Signatur, bevor Sie Maßnahmen bezüglich des Nachrichtentexts ergreifen — diese Header werden bei jeder Zustellung mitgesendet:
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.paidDer Zeitstempel wird zusammen mit dem Textkörper signiert, anstatt neben ihm gesendet zu werden, sodass eine abgefangene Anfrage später nicht erneut gegen Sie verwendet werden kann. Weisen Sie alles ab, was älter als ein paar Minuten ist.
Ihr Signiergeheimnis wird nur einmal angezeigt, wenn Sie den Webhook hinzufügen. Wir können es nicht erneut anzeigen — wenn Sie es verlieren, entfernen Sie das Ziel und fügen Sie es wieder hinzu.
Wird eingerichtet
- Öffnen Sie in Ihrem Dashboard die Benachrichtigungen und fügen Sie ein Ziel vom Typ Webhook hinzu.
- Geben Sie Ihren HTTPS-Endpunkt an und kopieren Sie das Signiergeheimnis, das wir Ihnen anzeigen.
- Drücken Sie auf Test. Wir senden eine echte Anfrage im gleichen Format wie eine Live-Anfrage, damit Sie darauf aufbauen können, bevor etwas Reales geschieht.
- Wählen Sie aus, welche Kategorien dieses Ziel empfangen soll. Neue Benachrichtigungsarten werden automatisch aktiviert.
Sie können beliebig viele Ziele hinzufügen, Webhooks mit E-Mail, Slack und Telegram kombinieren und jedem Ziel eine andere Auswahl an Kategorien zuweisen.
Möchten Sie uns stattdessen lieber anrufen?
Webhooks informieren Sie, wenn etwas geschehen ist. Über die API veranlassen Sie Aktionen — jeder Vorgang, den das Dashboard ausführt, steht Ihnen zur Verfügung.