Webhooks

Mit Webhooks benachrichtigt Voxbi deine Systeme in dem Moment, in dem etwas bei einem Anruf passiert. Startet ein Anruf, endet er, geht er ins Leere oder tritt ein anderes Ereignis auf, das für dich relevant ist, sendet Voxbi eine HTTP-Anfrage an eine URL deiner Wahl. Dein System empfängt diese Daten und kann darauf reagieren: den Anruf protokollieren, einen Datensatz aktualisieren, eine Benachrichtigung versenden oder einen beliebigen Workflow anstoßen. Die Logik liegt bei dir; Voxbi liefert das Signal.

Dieses Prinzip eignet sich überall dort, wo du Voxbi an Werkzeuge und Prozesse anbinden willst, für die es keine fertige Integration gibt. Hast du eine interne Anwendung, ein eigenes CRM, ein Ticketing-System oder eine Automatisierungsplattform, die über Anrufaktivitäten informiert sein soll, bekommst du die Daten per Webhook in Echtzeit und ohne ständiges Polling. Zusammen mit der Voxbi-API, über die du Anrufverläufe abrufst, Aufzeichnungen verwaltest, SMS sendest und die Telefonie programmgesteuert steuerst, ergibt sich ein vollständiges Bild: Die API antwortet auf Anfragen deines Systems; Webhooks schicken Ereignisse aktiv zu dir, sobald sie eintreten.

Wann sich Webhooks anbieten

• Ein internes Helpdesk-System, das automatisch ein Ticket anlegen soll, wenn ein Support-Anruf während der Geschäftszeiten verpasst wird, damit kein Anruf unbeantwortet bleibt, auch wenn die Warteschlange gerade nicht besetzt ist.

• Ein Business-Intelligence- oder Reporting-Tool, das genaue Anrufdaten in Echtzeit benötigt, ohne manuelle Exporte oder zeitgesteuerte Abfragen des Anrufverlaufs.

• Eine Automatisierungsplattform, bei der ein eingehender Anruf von einer bekannten Kundennummer eine Abfrage auslösen und dem Agenten den Kundendatensatz anzeigen soll, bevor er den Hörer abnimmt.

So funktionieren Webhooks in Voxbi

1. Endpunkt in deinem System vorbereiten. Du brauchst eine URL, die HTTP-POST-Anfragen empfangen und die JSON-Nutzdaten verarbeiten kann, die Voxbi sendet. Der Endpunkt muss aus dem Internet erreichbar sein und einen passenden HTTP-Statuscode zurückgeben, damit Voxbi die erfolgreiche Zustellung bestätigt bekommt.

2. Webhook in Voxbi einrichten. Im Voxbi Cockpit navigierst du zu den Webhook- oder Automatisierungseinstellungen und trägst deine Endpunkt-URL ein. Dann wählst du die Anrufereignisse aus, auf die du reagieren möchtest: Anruf gestartet, Anruf beendet oder Anruf verpasst.

3. Ereignis empfangen und verarbeiten. Tritt das abonnierte Ereignis ein, sendet Voxbi die Anrufdaten an deinen Endpunkt. Dein System verarbeitet die Nutzdaten und führt die von dir definierte Logik aus: in eine Datenbank schreiben, eine Benachrichtigung abschicken, einen Datensatz anlegen oder einen nachgelagerten Prozess starten.

4. Mit der API zu Zwei-Wege-Workflows kombinieren. Webhooks transportieren Ereignisse von Voxbi zu dir. Die Voxbi-API ermöglicht die Gegenrichtung: Anrufverläufe abrufen, Aufzeichnungen laden, SMS senden und die Telefonie programmatisch steuern. Beides zusammen ergibt eine vollständige bidirektionale Automatisierung zwischen Voxbi und deinem Stack. Die API-Dokumentation findest du unter docs.voxbi.com.

Häufige Fragen

Was ist der Unterschied zwischen einem Webhook und der Voxbi-API?

Ein Webhook reagiert auf Ereignisse: Voxbi schickt Daten an deinen Endpunkt, wenn etwas passiert, ohne dass du darum bitten musst. Die API funktioniert auf Anfrage: Dein System ruft einen Voxbi-Endpunkt auf, wenn es Informationen benötigt. Die meisten Integrationen nutzen beides, Webhooks für Echtzeit-Auslöser, die API für bedarfsgesteuerten Datenabruf.

Brauche ich einen Entwickler, um Webhooks einzurichten?

Das Einrichten eines Webhook-Endpunkts setzt technisches Grundwissen voraus, da dein System HTTP-Anfragen empfangen und auswerten können muss. Verwendet dein Team eine Automatisierungsplattform, die Webhooks als eingehenden Auslöser unterstützt, übernimmt diese Plattform den Endpunkt für dich und reduziert den Bedarf an eigenem Code erheblich.

Welche Daten enthält ein Webhook-Payload von Voxbi?

Der Payload enthält Daten zum jeweiligen Anrufereignis. Welche Felder genau enthalten sind, hängt vom Ereignistyp ab; typischerweise findest du darin die Rufnummer des Anrufers, das Ziel, einen Zeitstempel, die Gesprächsdauer (sofern zutreffend) und eine Anruf-ID. Die aktuelle Payload-Spezifikation steht in der Voxbi-API-Dokumentation unter docs.voxbi.com.

Kann ich Webhooks nutzen, um Anrufe anhand von Daten aus meinem System weiterzuleiten?

Webhooks speisen Anrufereignisse in deine Systeme ein. Wie Routing-Entscheidungen dann wieder in Voxbi-Anrufabläufe einfließen, hängt von deinem Integrationsdesign ab. Wenn du ein Routing-Szenario planst, das in Echtzeit auf externe Daten angewiesen ist, sprich das Voxbi-Team vor dem Aufbau auf deinen konkreten Anwendungsfall an. Melde dich unter hello@voxbi.com.