Geschäftskommunikation, einfach gemacht
Apps für Mobilgeräte und ComputerEntwicklerIllyVoIP-StatusHilfe-Center
Alle Funktionen

Webhooks

Ein Ereignis im Dienst. Die passende Aktion in Ihrer Anwendung.

Verbinden Sie Anruf-, SMS-, Kontakt- und Voicemail-Ereignisse mit Ihrer Anwendung – mit dokumentierten Nutzdaten, signierten Anfragen und Zustellverlauf.

Webhook-Dokumentation lesenAblauf ansehen

Ereignisse, die
Ihre Abläufe anstoßen.

Wählen Sie eine Kategorie, um die aktuell dokumentierten Ereignisse anzusehen. Dies ist eine Referenz, kein Live-Ereignisfeed.

call_initiated

Ein Anruf beginnt.

call_ringing

Der Anruf wechselt in die Klingelphase.

call_answered

Ein Anruf wird angenommen.

call_completed

Ein Anruf endet; die endgültige Dauer ist enthalten.

So funktioniert es

Ein Ereignis tritt ein.
Ihre Anwendung reagiert.

IllyVoIP sendet JSON-POST-Anfragen an den von Ihnen konfigurierten Endpunkt.

Ereignisse auswählen

Legen Sie in den Webhook-Einstellungen Ihres Kontos einen Endpunkt an. Abonnieren Sie die Anruf-, SMS-, Kontakt- oder Voicemail-Ereignisse, die Ihre Anwendung benötigt.

Vor der Verarbeitung verifizieren

Prüfen Sie den Header Illyvoip-Signature mit Ihrem Webhook-Secret, dem Zeitstempel und dem unveränderten Anfragekörper wie in der Dokumentation beschrieben.

Empfang bestätigen und Arbeit einreihen

Antworten Sie zeitnah mit einem erfolgreichen 2xx-Status. Stellen Sie länger dauernde Aufgaben in eine Warteschlange, damit die Empfangsbestätigung nicht verzögert wird.

Wiederholte Zustellungen berücksichtigen

Speichern Sie die Ereignis-ID aus dem Anfragekörper und ignorieren Sie bereits verarbeitete Ereignisse. Bei einem erneuten Zustellversuch kann dasselbe Ereignis nochmals eintreffen.

Für reale
Zustellbedingungen entwickeln.

Im Portal finden Sie den Zustellverlauf. Die API-Dokumentation erläutert Nutzdaten, Signaturen und das Verhalten bei erneuten Zustellversuchen.

Fehler untersuchen
Prüfen Sie Zustellstatus, HTTP-Antwort und Fehlerinformationen, um Empfangsprobleme von Fehlern in Ihrer Geschäftslogik zu unterscheiden.
SMS-Umgebungen trennen
Ein Endpunkt kann Ereignisse für alle oder nur ausgewählte Sender-IDs empfangen. Jeder passende Endpunkt erhält das Ereignis. Durch eine Filteränderung werden alte Ereignisse nicht erneut zugestellt.
Geheime Schlüssel auf dem Server aufbewahren
Die Webhook-Verwaltung umfasst kontoweite Endpunkte, geheime Schlüssel und Zustellprotokolle. Vergeben Sie diese Berechtigung bewusst. Aktuelle Webhook-Spezifikation lesen

Gut zu
wissen.

Unser Team fragen
Gibt es für jede Portalaktion einen Webhook?+

Nein. Maßgeblich ist der Ereigniskatalog in der API-Dokumentation. Abonnieren Sie nur die für Ihren gewünschten Ablauf verfügbaren Ereignisse.

Kann dasselbe Ereignis mehrmals eintreffen?+

Ja. Bei erneuten Zustellversuchen bleibt die Ereignis-ID gleich. Erkennen Sie Duplikate anhand des Felds id im Nachrichteninhalt, nicht anhand der ID des Zustellauftrags.

Bei welchen Fehlern wird die Zustellung erneut versucht?+

Laut aktueller Dokumentation wird die Zustellung bei Netzwerkfehlern sowie HTTP 408, 429 und 5xx erneut versucht. Weiterleitungen und andere 4xx-Antworten beenden die Zustellung. Prüfen Sie vor der Implementierung Ihres Empfängers die aktuelle Spezifikation.

Lassen Sie Ereignisse Ihre Abläufe anstoßen.

Lesen Sie zunächst die aktuelle Ereignisdokumentation und konfigurieren Sie dann Ihren Empfangsendpunkt.

Webhook-Dokumentation lesenMit unserem Team sprechen