Signiert mit HMAC-SHA256
Jede Zustellung trägt eine Signatur, die aus dem Body und dem Secret Ihres Endpoints berechnet wird. So kann Ihr Empfänger prüfen, ob die Anfrage wirklich von uns kommt, bevor er darauf reagiert.
Ausgehende Webhooks
Einunddreißig Ereignisse, vom neu angelegten Kontakt bis zur verfehlten Support-Zusage oder abgelehnten Anzeige, landen als signierte HTTP-POSTs mit automatischen Wiederholungen an Ihrem Endpoint. Im Business-Plan. Keine Polling-Schleife, kein Cronjob, der fragt, ob sich etwas geändert hat.
Zuletzt aktualisiert:
Abonnieren Sie für jeden Endpoint nur die Ereignisse, die er braucht, statt alles zu empfangen und auf Ihrer Seite zu filtern.
Einen JSON-Body per POST verschicken kann jeder. Signieren, erneut zustellen und nachvollziehbar machen, was passiert ist: Erst das macht es produktionstauglich.
Jede Zustellung trägt eine Signatur, die aus dem Body und dem Secret Ihres Endpoints berechnet wird. So kann Ihr Empfänger prüfen, ob die Anfrage wirklich von uns kommt, bevor er darauf reagiert.
Eine fehlgeschlagene Zustellung wird mit wachsendem Abstand erneut versucht, statt verworfen zu werden. Ein Deployment-Fenster oder ein kurzer Ausfall bei Ihnen kostet also nicht still und leise genau das Ereignis, auf das es ankam.
Sehen Sie, was wann gesendet wurde, was Ihr Endpoint geantwortet hat und wie lange es gedauert hat. Fehlersuche in einer Integration ist dann kein Streit mehr darüber, ob das Ereignis überhaupt ausgelöst wurde.
Jeder Endpoint abonniert die Ereignisse, die er möchte. Ein Fulfillment-Dienst, der nur invoice.paid braucht, muss nicht jede Kontaktänderung empfangen und wegwerfen.
Bis zu zwanzig Endpoints: Ein Lagersystem, ein internes Slack-Relay und ein Data Warehouse können jeweils einen eigenen Feed mit eigenem Secret bekommen.
Mit einem Testereignis prüfen Sie Endpoint, Signaturprüfung und Handler, bevor ein echtes deal.won davon abhängt, dass alle drei funktionieren.
support.ticket.breached wird ausgelöst, wenn eine zugesagte Antwortzeit verfehlt wird. Genau dieses Ereignis wollen die meisten Teams im Bereitschaftskanal sehen, nicht in einem Dashboard, das niemand offen hat.
Kontakte, Pipeline-Phasen, Nachrichten, Akquise-Schritte und Antworten, Deals, Aufgaben, Rechnungen, Transaktionen, Abonnements, Support-Tickets und Warnungen aus Werbekonten lösen alle Ereignisse aus.
Der Webhook meldet, dass etwas passiert ist; mit der öffentlichen REST-API lesen oder ändern Sie den betroffenen Datensatz. Zusammen machen sie Polling komplett überflüssig.
Ein Webhook bedeutet: Pinlyx schickt in dem Moment, in dem etwas passiert, einen HTTP-POST an eine URL, die Sie kontrollieren, statt dass Ihr Code alle paar Minuten bei uns nachfragt, ob sich etwas getan hat. Einunddreißig Ereignisse stehen zur Verfügung, jede Zustellung ist signiert, Fehlschläge werden wiederholt, und das Protokoll zeigt genau, was Ihr Endpoint geantwortet hat.
Der praktische Unterschied liegt in Latenz und Kosten. Ein Polling-Job, der alle fünf Minuten läuft, ist fünf Minuten zu spät und besteht größtenteils aus vergeblichen Anfragen. Ein Webhook kommt in unter einer Sekunde an, und nur dann, wenn es etwas zu melden gibt.
Jeder Endpoint hat ein eigenes Secret. Wir berechnen mit diesem Secret einen HMAC-SHA256 über den Request-Body und senden ihn als Signatur-Header; Ihr Empfänger berechnet ihn neu und vergleicht. Eine Anfrage ohne passende Signatur sollte abgewiesen werden.
Vergleichen Sie in konstanter Zeit statt mit einem normalen Stringvergleich, und behandeln Sie das Secret wie ein Passwort: Es ist das Einzige, was zwischen Ihrem Endpoint und jedem steht, der die URL errät.
Eine Antwort außerhalb von 2xx oder ein Timeout markiert die Zustellung als fehlgeschlagen, und sie wird mit Backoff erneut versucht. Das deckt die üblichen Fälle ab: ein Deployment, ein Neustart, eine kurze Datenbanksperre.
Weil es Wiederholungen gibt, muss Ihr Handler idempotent sein. Bauen Sie ihn so, dass dasselbe Ereignis zweimal empfangen zum selben Ergebnis führt wie einmal, meist über die Ereignis-ID als Schlüssel. Das gilt für jedes Webhook-System, und es ist der Fehler, der sich am häufigsten als doppelte Datensätze zeigt.
Ausgehende Webhooks sind eine Funktion des Business-Plans, mit bis zu zwanzig Endpoints, ebenso wie die öffentliche REST-API, die dazu passt. Wenn Sie gar keinen Empfänger schreiben möchten, verarbeiten die Integrationen für Zapier und n8n im selben Plan dieselben Ereignisse. Aktuelle Preise finden Sie auf der Preisseite.
Die Datensätze lesen und ändern, auf die sich Ereignisse beziehen.
Lassen Sie einen KI-Client den Workspace steuern.
Dieselben Ereignisse, ohne eigenen Empfänger.
Selbst gehostete Automatisierung auf denselben Daten.
Woher das Ereignis für SLA-Verstöße kommt.
Endpoint-Kontingente pro Plan.
Startklar
Webhooks und die REST-API sind im Business-Plan enthalten.