Webhooks
Senden Sie Ereignisse aus go33 an eigene Backends, Zapier oder Make.
Ereignisse
conversation.completed— ein Chat wurde erfolgreich abgeschlossen.lead.captured— ein Besucher hat ein Formular im Chat abgeschickt.helpdesk.escalation_created— eine Anfrage wurde an einen Menschen weitergegeben. Nur über die API abonnierbar, danotification.createddenselben Vorgang bereits mitträgt.notification.created— eine Meldung des Assistenten aus dem Benachrichtigungssystem.conversation.started— reserviert für Start-Ereignisse.
notification.created bündelt bewusst alle Assistenten-Meldungen: Formular-Eingabe, Terminbuchung, eskalierte Anfrage und was künftig dazukommt. Wer es abonniert, bekommt neue Meldungsarten automatisch mit; um welche es sich handelt, steht im Feld notification_type. Meldungen zu Konto, Sicherheit und Abrechnung bleiben ausgenommen — sie betreffen Ihren go33-Zugang, nicht das Geschäft des Assistenten.
Welche Meldung auf welchem Weg zugestellt wird, steuern Sie unter Benachrichtigungen; der Webhook-Weg folgt dabei nicht den persönlichen Einstellungen einzelner Team-Mitglieder, sondern gilt für den Assistenten als Ganzes.
Ihre Webhook-URLgo33 sendet JSON per HTTP POST. Erfolgreich sind Statuscodes 2xx. Jede Anfrage enthält X-Webhook-Signature: sha256=<HMAC> und X-Webhook-Delivery-Id.
{
"event": "conversation.completed",
"tenant_id": "tenant-uuid",
"conversation_id": "session-uuid",
"session_id": "session-uuid",
"timestamp": "2026-05-17T10:30:00Z"
}notification.created
{
"event": "notification.created",
"tenant_id": "tenant-uuid",
"notification_type": "form_submission",
"category": "leads",
"title": "Neue Formular-Eingabe",
"body": "Rückruf anfordern",
"data": {
"form_name": "Rückruf anfordern",
"submitted_at": "17.05.2026 10:30"
},
"timestamp": "2026-05-17T10:30:00Z"
}HMAC-Verifikation
const crypto = require("crypto");
function verifyWebhook(rawBody, signature, secret) {
const expected = "sha256=" + crypto
.createHmac("sha256", secret)
.update(rawBody)
.digest("hex");
return crypto.timingSafeEqual(
Buffer.from(signature),
Buffer.from(expected)
);
}Zustellung, Wiederholungen und Dopplungen
Ein Ereignis wird gespeichert, bevor es zugestellt wird. Ist Ihr Endpunkt gerade nicht erreichbar, geht es deshalb nicht verloren — auch dann nicht, wenn go33 in diesem Moment neu startet.
Der erste Versuch läuft sofort und wiederholt sich bei einem Fehler dreimal innerhalb weniger Sekunden. Bleibt es dabei, versucht es go33 alle fünf Minuten erneut, insgesamt fünfmal. Danach gilt der Endpunkt als defekt und die Zustellung wird aufgegeben; im Webhook-Protokoll steht dann, woran es lag. Über alle Runden sind das im schlechtesten Fall 15 Anfragen über etwa 20 Minuten.
Wer den Webhook deaktiviert, stoppt damit auch die noch offenen Wiederholungen.
Bitte doppelte Zustellungen einplanen
go33 stellt mindestens einmal zu. Wenn Ihr Endpunkt eine Anfrage annimmt, die Antwort aber unterwegs verloren geht, kommt dasselbe Ereignis später noch einmal an.
Dafür trägt jede Anfrage den Kopfzeilen-Wert X-Webhook-Delivery-Id. Er bleibt über alle Wiederholungen derselben Zustellung gleich und ändert sich bei jedem neuen Ereignis. Merken Sie sich die zuletzt verarbeiteten Werte und überspringen Sie eine ID, die Sie schon kennen — dann kann eine Wiederholung nichts doppelt auslösen.
Zapier
- Erstellen Sie in Zapier einen Zap mit Webhook-Trigger.
- Kopieren Sie die Catch-Hook-URL in go33 unter Entwickler Webhooks.
- Wählen Sie als Action z.B. Google Sheets Zeile erstellen, um abgeschlossene Gespräche zu protokollieren.
Make (Integromat)
- Legen Sie in Make ein Scenario mit Custom Webhook an.
- Verbinden Sie den Trigger anschließend z.B. mit Calendly: Neuer Lead Calendly Termin oder mit Ihrem CRM.