Eingehende Webhooks

Webhooks ermöglichen es yourang.ai, Ihr externes System zu benachrichtigen, sobald etwas passiert, ohne dass Polling erforderlich ist. Das Modell ist einfach: Sie registrieren eine URL, yourang.ai sendet bei jedem interessanten Ereignis eine HTTP-POST-Anfrage dorthin.

Warum Webhooks statt Polling

Ohne Webhooks müsste Ihr System die API wiederholt aufrufen, um zu fragen 'Ist etwas Neues passiert?'. Das ist ineffizient, kostspielig und führt zu Verzögerungen. Mit Webhooks erhalten Sie die Benachrichtigung innerhalb von Millisekunden nach dem Ereignis, mit bereits fertiger Payload.

Verfügbare Ereignisse

• Anruf beendet (mit Transkript, Zusammenfassung, Ergebnis)
• Neue Buchung
• Buchungsänderung
• Buchungsstornierung
• Neue Bestellung
• Bestellstatusaktualisierung
• Neuer Kontakt erstellt
• Aktualisierung von Kontaktfeldern
• Ergebnis eines Bewertungskriteriums
• Workflow abgeschlossen

Einen Webhook konfigurieren

1. 1

   Implementieren Sie den Endpunkt in Ihrem System

   Eine öffentliche HTTPS-URL, die POSTs empfängt. Sie muss mit 200 OK antworten, wenn das Ereignis akzeptiert wurde.

2. 2

   Registrieren Sie die URL in yourang.ai

   Gehen Sie zu Administration → API → Webhooks, geben Sie die URL ein und wählen Sie die interessanten Ereignisse aus.

3. 3

   Überprüfen Sie die Signatur

   Jede Payload wird mit einem gemeinsamen Secret signiert. Ihr Endpunkt muss die Signatur validieren, um sicherzustellen, dass die Nachricht wirklich von yourang.ai kommt.

4. 4

   Testen Sie mit realen Ereignissen

   Das Panel zeigt das Log der letzten Zustellungen mit Ergebnis (200 OK, Fehler). Verwenden Sie dieses Log zum Debugging.

Retry und Zuverlässigkeit

Wenn Ihr Endpunkt mit einem Fehler antwortet oder nicht rechtzeitig antwortet, versucht yourang.ai es automatisch erneut nach einer Strategie mit exponentiellem Backoff (z. B. 30 Sekunden, 5 Minuten, 1 Stunde, ...). Nach mehreren fehlgeschlagenen Versuchen landet das Ereignis in der Dead Letter Queue für manuelle Intervention. Am Endpunkt empfiehlt es sich, sofort mit 200 OK zu antworten und asynchron zu verarbeiten, um Timeouts zu vermeiden.