Was ist ein Webhook?
Das Webhooks-Modul ermöglicht umfangreiche Anpassungen, indem es HTTP-Anfragen an externe URLs sendet und verschiedene Aktionen basierend auf den zurückgegebenen Daten auslöst. Ob es darum geht, eine Schranke für bestimmte Anrufe zu öffnen, E-Mails für Kundenkontakte zu versenden oder mit CRM-Systemen und Marketing-Kampagnen zu integrieren – die Möglichkeiten sind vielfältig. Konfiguriere die URL und Funktionen, um Features wie Rufumleitung oder Datenbankabfragen nach Deinen Bedürfnissen anzupassen.
Schau Dir unbedingt Anrufbenachrichtigungen an, um die Möglichkeiten Deines Telefondienstes voll auszuschöpfen.
Wie erstelle ich einen Webhook?
- Gehe zu Webhooks.
- Klicke auf Hinzufügen.
- Gib einen Namen für Deinen Webhook ein.
- Optional kannst Du zusätzliche Informationen im Feld Beschreibung angeben. Dies ist für die Funktion des Webhooks nicht erforderlich.
- Wähle unter Caller ID-Übertragung, welche Nummer der Angerufene als Caller ID sehen soll:
- Nummer des Anrufers.
- Angerufene Nummer.
- Unterdrückt (anonym).
- Gib im Feld URL-Vorlage die URL ein, die bei einem eingehenden Anruf ausgelöst werden soll. Der Hilfetext im Formular enthält weitere Details. Dieses Feld legt fest, wie die vom Webhook aufzurufende URL formatiert sein soll. In der URL-Vorlage können vier Variablen verwendet werden:
- {code}: Der vom Anrufer eingegebene Zifferncode (siehe „IVR verwenden" unten).
- {did}: Die angerufene Nummer.
- {callerid}: Die Caller ID des Anrufers.
- {callername}: Der Name des Anrufers, falls verfügbar.
Ein einfaches Beispiel für eine URL-Vorlage könnte sein:
http://webrouting.firmenname.com/test.py?code={code}&callerid={callerid}
IVR (Interactive Voice Response) verwenden
Aktiviere diese Option, wenn der Anrufer einen Zifferncode eingeben soll, um fortzufahren. Nach Auswahl dieser Option werden fünf weitere Felder angezeigt:
- Timeout: Gib die Anzahl der Sekunden ein, die der Anrufer für die Eingabe seines Zifferncodes hat.
- Anzahl der Versuche: Gib an, wie oft der Anrufer versuchen kann, den Zifferncode korrekt einzugeben.
- Startnachricht: Wähle die Audiodatei, die abgespielt werden soll, wenn der Anrufer zu diesem Webhook weitergeleitet wird.
- Fehlermeldung: Wähle die Audiodatei, die abgespielt werden soll, wenn der Anrufer einen falschen Zifferncode eingibt.
- Timeout-Nachricht: Wähle die Audiodatei, die abgespielt werden soll, wenn die Timeout-Zeit überschritten wird.
- Klicke auf Speichern.
Wenn alles korrekt eingerichtet ist, wird nun eine Verbindung zwischen Deiner Telefonplattform und Deinem Skript, CRM-Paket, Zapier oder einem anderen Programm hergestellt. Du musst diesen Webhook nur noch in Deinem Anrufplan aktivieren.
Webhooks im Anrufplan einrichten
- Gehe zu Anrufpläne.
- Klicke auf die Telefonnummer, bei der Du den Webhook verwenden möchtest.
- Klicke auf Anrufplan ändern.
- Klicke an der Stelle, an der Du den Webhook einfügen möchtest, auf Schritt hinzufügen.
- Du siehst zwei Unterschritte:
- HTTP- und IVR-Erfolg: Diese Unterschritte werden ausgeführt, wenn der Webhook die korrekten Werte zurückgibt (die URL ist verbunden) und der Anrufer möglicherweise eine gültige IVR-Option eingegeben hat.
- HTTP- oder IVR-Fehler: Diese Unterschritte werden ausgeführt, wenn ein Problem auftritt, z. B. wenn der Anrufer eine ungültige Eingabe macht oder die URL nicht funktioniert, möglicherweise aufgrund eines Serverproblems.
Was Du in Deinen Webhook einbinden kannst
Du kannst verschiedene Elemente in Deinen Webhook integrieren, genau wie in Deinem Anrufplan. Hier sind einige Optionen und deren Verwendung:
Variable für Anrufernamen
Der Anrufername – der Name, den der Empfänger auf seinem Display sieht – kann auf drei Arten angepasst werden:
- Webhook: Setzt den Anrufernamen auf den vom Webhook zurückgegebenen Wert.
- Präfix: Gib im Routing-Schritt einen Text ein, der dem Anrufernamen vorangestellt wird.
- Ersetzen: Gib im Routing-Schritt einen Text ein, der den Anrufernamen vollständig ersetzt.
Hinweis: Variabler Anrufername kann auch außerhalb des Webhooks verwendet werden. In diesem Fall können nur die Optionen Voranstellen und Ersetzen genutzt werden.
Variables Ziel
Wenn der Webhook ein Ziel bereitstellt, kannst Du den Anruf zu diesem Ziel weiterleiten, indem Du im Routing-Schritt (unter dem Webhook-Bereich) „Variables Ziel" auswählst.
Feedback, das Du dem System geben kannst
Gib das folgende Feedback, um den Status der Webhook-Interaktion anzuzeigen.
Status
- ACK: Eingabe ist korrekt.
- NAK: Eingabe ist nicht gültig.
- ERR: Es ist ein Fehler aufgetreten.
Ziel
Wird für die Weiterleitung an ein anderes Ziel verwendet.
Anrufername
Verwende dies, wenn Du den Namen des Anrufers oder den Status des Anrufs (z. B. IVR-Auswahl) auf einem VoIP-Gerät anzeigen möchtest.
Feedback-Interpretation
status=ACK
Die Anfrage wurde erfolgreich empfangen und mit gültiger Eingabe verarbeitet.
status=ACK&destination=%2B49502102544
Die Anfrage wurde erfolgreich verarbeitet, und der Anruf sollte an die Zielnummer +49 50 210 2544 weitergeleitet werden.
status=ACK&destination=215
Die Anfrage wurde erfolgreich verarbeitet, und der Anruf sollte an die Zielnummer 215 weitergeleitet werden.
status=ACK&callername=VoIPGRID
Die Anfrage wurde erfolgreich verarbeitet, und der Anrufername sollte auf „VoIPGRID" gesetzt werden.
Alternative Verwendungen für Webhooks
CRM-Kopplung
Wenn ein Anruf eingeht, senden wir einen Impuls an das CRM-System. Dieser Impuls enthält die Nummer des Anrufers (falls bekannt) und die gewählte Nummer. Das CRM gibt den Namen zurück, der angezeigt werden soll, und wir zeigen diesen Namen auf dem Display des VoIP-Telefons an.
Optional kann das CRM auch ein Kundenprofil basierend auf dem eingehenden Anruf öffnen – diese Logik muss jedoch im CRM selbst implementiert werden.
Weiterleitung basierend auf einer externen Datenbank
Wir können eingehende Anrufe an eine Telefonnummer weiterleiten, die von einem externen System zurückgegeben wird. Dies kann basieren auf:
- Der Nummer des Anrufers
- Der gewählten Nummer
- Einem eingegebenen PIN-Code
Anrufe in Google Analytics tracken
Um Anrufe zu tracken, benötigst Du einen Nummernblock. Weise jeder Kampagne eine eindeutige Nummer zu. Mit einem Block von 10 Nummern kannst Du bis zu 10 Kampagnen gleichzeitig tracken.
Wenn ein Kunde eine der Nummern im Block anruft, senden wir eine URL, die die gewählte Nummer (die Kampagne) und die Nummer des Anrufers (falls verfügbar) enthält. Beachte, dass unser System kein JavaScript oder ähnliche Skripte verarbeitet – daher muss nach dem Aufruf der URL ein Code ausgeführt werden, um die Conversion korrekt zu messen.
Nach dem Aufruf der URL leiten wir den Anruf an die Hauptnummer des Unternehmens weiter, und die Kampagne wird getrackt.
E-Mail bei verpassten Anrufen erhalten
Wenn ein Anruf verpasst wird, kann es hilfreich sein, die Telefonnummer des Anrufers per E-Mail, SMS oder beispielsweise via Slack zu erhalten – inklusive Datum, Uhrzeit und gewählter Nummer. Weitere Details findest Du unter Webhook-Beispiele – dort gibt es ein ausführliches Beispiel via Zapier-Verbindung mit Webhooks.
VIP-PIN-Code
Du kannst einen Webhook nutzen, um Kunden einen speziellen VIP-PIN-Code zuzuweisen, beispielsweise für eine dedizierte Support-Hotline. Details zur Einrichtung findest Du auf der Seite VIP-PIN-Code.
Verbindung zu 300+ anderen Webanwendungen via Zapier
Du kannst Deinen Webhook nahtlos mit Zapier verbinden – ähnlich wie IFTTT (If This Then That). Zapier ermöglicht die Integration verschiedener Systeme, sodass eine Aktion in einem Webservice Aktionen in anderen auslösen kann – eine Kettenreaktion. Zapier unterstützt die Integration mit Diensten wie Slack, Gmail, Google Calendar, Zendesk, Mailchimp, Evernote, Dropbox und vielen weiteren.
FAQ
Webhooks werden an einem bestimmten Punkt im Anrufplan ausgelöst und funktionieren nur für eingehende Anrufe. Bei Bedarf kann für jeden eingerichteten Webhook eine andere URL verwendet werden. Ein Webhook wird zu einem einzelnen Zeitpunkt aufgerufen.
Anrufbenachrichtigungen funktionieren sowohl für eingehende als auch für ausgehende Anrufe. Weitere Details findest Du hier:
Bei Anrufbenachrichtigungen kann die URL an fünf verschiedenen Punkten im Anruf-Lebenszyklus aufgerufen werden.
- Für Webhooks verwende eine GET-Anfrage.
- Für Anrufbenachrichtigungen verwende eine POST-Anfrage.