Entwickler
Webhooks
Jede Benachrichtigung, die Ihr Konto generiert, kann direkt als signierter JSON-POST an Ihre eigenen Systeme gesendet werden – so kann das Geschehen auf Ihrem Hosting überall sonst einen Arbeitsablauf 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 müssen nicht darauf warten, dass wir eine Integration für Ihr Tool entwickeln.
Automatisierungsplattformen
Leiten Sie einen Webhook auf einen Workflow in n8n, Make, Zapier, Pipedream, Activepieces um und jedes Ereignis wird zu einem Auslöser — senden Sie eine Nachricht an einen Kanal, öffnen Sie ein Ticket, aktualisieren Sie eine Tabelle, rufen Sie eine andere API auf. Selbst gehostete Plattformen funktionieren genau auf dieselbe Weise, solange der Endpunkt über HTTPS erreichbar ist.
CRMs und Helpdesks
Senden Sie Abrechnungs- und Kontoereignisse an HubSpot, Pipedrive, Salesforce oder an einen beliebigen Helpdesk oder CRM mit einem Inbound-Webhook, damit ein Kundendatensatz widerspiegelt, was das Hosting tut, ohne dass jemand dies 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.
Gesendete Inhalte
Sie bestimmen, welche Kategorien an welches Ziel gesendet werden – und Sie können mehrere verknüpfen, sodass Abrechnungen an einen Ort und Website-Benachrichtigungen an einen anderen gehen können. Standardmäßig ist alles aktiviert.
Abrechnung und Zahlungen
Ausgestellte und bezahlte Rechnungen, fehlgeschlagene Zahlungen, bald ablöschende Karten, Verlängerungen und Kündigungen.
Websites und Sicherheit
Bereitstellung abgeschlossen, Website gesperrt, Malware gefunden, Backups und Zertifikatsänderungen.
Support und Domains
Eröffnete und eskalierte Tickets, Domain-Transfers, Verlängerungen und DNS-Änderungen.
Denachweis, dass eine Anfrage von uns stammt
Jede Anfrage wird mit einem Geheimnis signiert, das nur Sie und wir kennen. Überprüfen Sie die Signatur, bevor Sie den Inhalt verarbeiten – diese Header werden bei jeder Lieferung 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 Nachrichtenkörper signiert, anstatt separat mitgesendet zu werden, sodass eine von Dritten abgefangene Anfrage nicht später gegen Sie wiederholt werden kann. Lehnen Sie alles ab, was älter als einige Minuten ist.
Ihr Signierungsgeheimnis 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 es wieder hinzu.
Einrichten
- Ö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 Signierungsgeheimnis, das wir Ihnen anzeigen.
- Test ausführen. Wir senden eine echte Anfrage im gleichen Format wie eine Live-Anfrage, damit Sie damit entwickeln können, bevor etwas Reales passiert.
- Wählen Sie aus, welche Kategorien dieses Ziel erhalten 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 Reihe von Kategorien zuweisen.
Rufen Sie uns lieber an?
Webhooks informieren Sie, wenn etwas passiert ist. Die API ermöglicht es Ihnen, Dinge geschehen zu lassen – jede Operation, die das Dashboard ausführt, steht Ihnen zur Verfügung.