Automatisierungen und Webhooks

Automatisierungen senden Ereignisse aus deinen Chats an die anderen Tools, die dein Unternehmen nutzt. Wenn ein Gespräch beginnt, ein Besucher eine Nachricht sendet, die KI antwortet oder ein Chat endet, schickt Pingu die Details an eine URL deiner Wahl.

Richte sie auf Zapier, Make oder n8n, um Pingu ohne Code mit Tausenden Apps zu verbinden, oder auf deine eigene API, um genau den Ablauf zu bauen, den du brauchst.

Einen Webhook einrichten

Hol dir eine Webhook-URL. Lege im Tool, das die Ereignisse empfangen soll, einen Webhook-Trigger an – etwa Catch Hook in Zapier, einen benutzerdefinierten Webhook in Make oder einen Webhook-Knoten in n8n – und kopiere dessen URL. Du kannst auch eine https://-Adresse in deinem eigenen System verwenden.
Öffne im Dashboard Automatisierungen und wähle Webhook hinzufügen.
Füge die URL ein, ergänze eine Beschreibung und wähle die Ereignisse, die gesendet werden sollen.
Wähle Speichern.
Wähle Testereignis senden. Der Zustellverlauf zeigt, ob dein System es empfangen hat, mit Antwortcode und Zeit.

Ereignisse, die du senden kannst

Ereignis	Wann es gesendet wird
`conversation.started`	Ein Besucher startet einen neuen Chat
`message.received`	Ein Besucher sendet eine Nachricht
`message.ai_replied`	Die KI antwortet dem Besucher
`conversation.ended`	Ein Chat wird geschlossen

Die Signatur prüfen

Jeder Webhook hat sein eigenes Signaturgeheimnis. Pingu signiert jede Anfrage in einem Header, damit dein System prüfen kann, dass das Ereignis wirklich von Pingu kommt:

X-Pingu-Signature: t=1760000000,v1=<HMAC-SHA256 of "<t>.<body>">

Die Prüfung der Signatur ist optional, für deine eigenen APIs aber empfehlenswert.

Zuverlässige Zustellung

Wenn dein System nicht antwortet, versucht Pingu es nach 1 Minute, 5 Minuten, 30 Minuten, 2 Stunden und 6 Stunden erneut. Ein Webhook, der 3 Tage lang fehlschlägt, wird automatisch deaktiviert – du kannst ihn mit einem Klick wieder einschalten.

Häufige Probleme

Das Testereignis schlägt fehl. Prüfe, ob die URL stimmt, mit https:// beginnt und das empfangende Tool eingeschaltet ist und auf Anfragen wartet.

Mein Webhook wurde deaktiviert. Er ist 3 Tage in Folge fehlgeschlagen. Behebe das Problem im empfangenden System und schalte den Webhook unter Automatisierungen wieder ein.