Ausgehende Webhooks

Ihre Systeme erfahren es in dem Moment, in dem es passiert

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.

  • 31 Ereignisse
  • Mit HMAC-SHA256 signiert
  • Wiederholungen mit Backoff

Zuletzt aktualisiert:

Alle Ereignisse, die Sie abonnieren können

Abonnieren Sie für jeden Endpoint nur die Ereignisse, die er braucht, statt alles zu empfangen und auf Ihrer Seite zu filtern.

Kontakte und Pipeline

4
  • contact.created
  • contact.updated
  • contact.deleted
  • pipeline.stage_changed

Nachrichten

3
  • message.sent
  • message.received
  • sequence.completed

Akquise-Sequenzen

4
  • outreach.step.sent
  • outreach.replied
  • outreach.completed
  • outreach.unsubscribed

Deals

5
  • deal.created
  • deal.updated
  • deal.stage_changed
  • deal.won
  • deal.lost

Aufgaben

2
  • task.created
  • task.completed

Finanzen

4
  • invoice.created
  • invoice.paid
  • finance.transaction.created
  • subscription.changed

Support-Desk

4
  • support.ticket.created
  • support.ticket.updated
  • support.ticket.resolved
  • support.ticket.breached

Werbekonten

5
  • ads.ad.disapproved
  • ads.budget.exhausted
  • ads.spend.anomaly
  • ads.billing.problem
  • ads.campaign.status_changed

Die unspektakulären Details, an denen Vertrauen hängt

Einen JSON-Body per POST verschicken kann jeder. Signieren, erneut zustellen und nachvollziehbar machen, was passiert ist: Erst das macht es produktionstauglich.

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.

Wiederholungen mit Backoff

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.

Ein Zustellprotokoll, das man lesen kann

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.

Abonnement pro Ereignis

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.

Mehrere Endpoints

Bis zu zwanzig Endpoints: Ein Lagersystem, ein internes Slack-Relay und ein Data Warehouse können jeweils einen eigenen Feed mit eigenem Secret bekommen.

Erst testen, dann darauf verlassen

Mit einem Testereignis prüfen Sie Endpoint, Signaturprüfung und Handler, bevor ein echtes deal.won davon abhängt, dass alle drei funktionieren.

Inklusive SLA-Verstößen im Support

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.

Das ganze Geschäft, nicht nur Kontakte

Kontakte, Pipeline-Phasen, Nachrichten, Akquise-Schritte und Antworten, Deals, Aufgaben, Rechnungen, Transaktionen, Abonnements, Support-Tickets und Warnungen aus Werbekonten lösen alle Ereignisse aus.

Im Zusammenspiel mit der REST-API

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.

Wofür ausgehende Webhooks da sind

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.

So prüfen Sie, ob eine Zustellung wirklich von uns kommt

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.

Was passiert, wenn Ihr Endpoint nicht erreichbar ist

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.

Welcher Plan nötig ist

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.

Häufige Fragen

Einunddreißig: Kontakte und Pipeline-Phasen, Nachrichten, Akquise-Sequenzen, Deals, Aufgaben, Rechnungen und Transaktionen, Abonnements, Tickets im Support-Desk einschließlich SLA-Verstößen sowie Warnungen aus Werbekonten, etwa eine abgelehnte Anzeige oder ein aufgebrauchtes Budget.
Jede Zustellung ist mit HMAC-SHA256 und dem Secret Ihres Endpoints signiert. Berechnen Sie die Signatur aus dem unveränderten Body neu und vergleichen Sie sie in konstanter Zeit; weisen Sie alles ab, was nicht übereinstimmt.
Fehlgeschlagene Zustellungen werden mit Backoff erneut versucht, statt verworfen zu werden, und das Zustellprotokoll zeigt jeden Versuch mit der Antwort Ihres Endpoints. Wegen der Wiederholungen sollte Ihr Handler idempotent sein.
Ja, bis zu zwanzig, jeder mit eigenem Secret und eigenem Ereignis-Abonnement. So bekommen verschiedene Systeme verschiedene Feeds.
Nein. Ausgehende Webhooks sind eine Funktion des Business-Plans, zusammen mit API-Schlüsseln und der öffentlichen REST-API. Der MCP-Server ist in jedem Plan enthalten. Aktuelle Preise finden Sie auf der Preisseite.
Nutzen Sie die Integrationen für Zapier oder n8n. Sie verarbeiten dieselben Ereignisse und leiten sie in andere Apps weiter, ohne dass Sie etwas programmieren oder hosten müssen.

Startklar

Schluss mit Polling nach Änderungen

Webhooks und die REST-API sind im Business-Plan enthalten.

Dauerhaft kostenloser Plan · Auf die DSGVO ausgelegt · Keine Kreditkarte nötig