Webhooks verwalten

Webhooks senden Klang-Ereignisse an deinen Server. Damit kannst du nach einer fertig verarbeiteten Besprechung ein CRM aktualisieren, eine Chat-Nachricht senden oder einen eigenen Prozess starten.

Webhooks sind persönlich und empfangen nur Ereignisse für Inhalte, auf die ihr Besitzer zugreifen darf.

Webhook erstellen

1. Öffne Einstellungen → Entwickler → Webhooks
2. Klicke auf Webhook erstellen

3. Gib einen öffentlichen HTTPS-Endpunkt als URL ein
4. Füge optional eine Beschreibung hinzu
5. Wähle die zu abonnierenden Ereignisse. Standardmäßig sind alle drei ausgewählt
6. Klicke auf Erstellen

Klang zeigt das Signaturgeheimnis einmal an. Kopiere und speichere es sicher, um eingehende Anfragen zu prüfen.

Verfügbare Ereignisse

• conversation.ready: Transkript und KI-Analyse sind fertig und zum Abruf bereit
• conversation.failed: Die Verarbeitung ist fehlgeschlagen
• conversation.deleted: Eine Besprechung oder Datei wurde gelöscht

Jede Ereignis-Payload enthält eine Ereignis-ID, den Ereignistyp und eine Referenz auf die Konversation. Payload-Schema, Signaturheader und Beispielcode findest du in der Webhook-Dokumentation.

Zustellungen überwachen

Öffne einen Webhook, um Details anzuzeigen.

Sie zeigt Status und URL, das einblendbare Geheimnis, Zustellungen und Fehler der letzten 24 Stunden sowie die neuesten Versuche mit Anfrage und Serverantwort.

Klang wiederholt fehlgeschlagene Zustellungen mit Wartezeiten bis zu sechsmal. Nach 25 aufeinanderfolgenden Fehlern wird der Webhook pausiert. Behebe den Endpunkt und aktiviere Ereignisse empfangen wieder.

Testereignis senden

1. Klicke oben rechts auf Testereignis senden
2. Wähle bei mehreren Abonnements ein Ereignis
3. Prüfe die neue Zeile unter Neueste Zustellungen

Tests tragen das Tag TEST und IDs mit evt_test_. Ihr Schema entspricht echten Ereignissen.

Webhook pausieren oder löschen

Deaktiviere Ereignisse empfangen, um nur die Zustellung zu pausieren. Klicke zum Löschen auf Bearbeiten und dann auf Webhook löschen. Beides ist auch über das Menü … in der Liste möglich.

Nächste Schritte

• Lies die Webhook-Dokumentation
• Verwalte Integrationen für integrierte Dienste
• Erstelle einen Flow, um Inhalte vor dem Senden umzuwandeln