Was ist ein Webhook?
Das Webhooks-Modul ermöglicht umfangreiche Anpassungen, indem HTTP-Anfragen an externe URLs gesendet werden, die verschiedene Aktionen basierend auf den zurückgegebenen Daten auslösen. Ob es darum geht, eine Schranke für bestimmte Anrufe zu öffnen, E-Mails für Kundenkontakte zu versenden oder eine Kopplung mit CRM-Systemen und Marketingkampagnen herzustellen – die Möglichkeiten sind nahezu unbegrenzt. Konfiguriere die URL und die Funktionen, um Rufumleitungen oder Datenbankabfragen ganz nach deinen Bedürfnissen anzupassen.
Wirf unbedingt einen Blick auf Anrufbenachrichtigungen, um das volle Potenzial deines Telefondienstes auszuschöpfen.
Wie erstellt man einen Webhook?
- Gehe zu Webhooks.
- Klicke auf Hinzufügen.
- Gib einen Namen für deinen Webhook ein.
- Optional kannst du im Feld Beschreibung zusätzliche Informationen angeben. Dies ist für die Funktion des Webhooks nicht erforderlich.
- Wähle unter Caller ID Übermittlung aus, welche Nummer der Anrufempfänger 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 bietet weitere Details. Dieses Feld legt fest, wie die vom Webhook aufzurufende URL formatiert werden 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 verwenden (Interactive Voice Response)
Aktiviere dieses Kontrollkästchen, wenn der Anrufer einen Zifferncode eingeben soll, um fortzufahren. Nach Auswahl dieser Option erscheinen fünf zusätzliche Felder:
- Timeout: Gib die Anzahl der Sekunden ein, die der Anrufer für die Eingabe seines Zifferncodes hat.
- Anzahl der Versuche: Gib die Anzahl der Versuche ein, die der Anrufer hat, um den Zifferncode korrekt einzugeben.
- Startnachricht: Wähle den Sound aus, der abgespielt werden soll, wenn der Anrufer zu diesem Webhook weitergeleitet wird.
- Fehlermeldung: Wähle den Sound aus, der abgespielt werden soll, wenn der Anrufer einen falschen Zifferncode eingibt.
- Timeout-Nachricht: Wähle den Sound aus, der abgespielt werden soll, wenn die Timeout-Periode ü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 auf Schritt hinzufügen an der Stelle, an der du den Webhook einfügen möchtest.
- Du siehst zwei Unterschritte:
- HTTP und IVR erfolgreich: 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 fehlgeschlagen: Diese Unterschritte werden ausgeführt, wenn ein Problem auftritt, etwa wenn der Anrufer eine ungültige Auswahl trifft oder die URL nicht funktioniert, möglicherweise aufgrund eines Serverproblems.
Was du in deinen Webhook integrieren kannst
Du kannst verschiedene Elemente in deinen Webhook integrieren, genau wie in deinem Anrufplan. Hier sind einige Funktionen und ihre Verwendung:
Variable für Anrufername
Der Anrufername – der Name, den der Empfänger auf seinem Bildschirm sieht – kann auf drei Arten angepasst werden:
- Webhook: Set the caller name to the value returned by the webhook.
- Prefix: Enter text in the routing step that will be prefixed to the caller's name.
- Replace: Enter text in the routing step that will replace the caller's name entirely.
Hinweis: Variabler Anrufername kann auch außerhalb des Webhooks verwendet werden. In diesem Fall können nur die Funktionen Voranstellen und Ersetzen genutzt werden.
Variables Ziel
Wenn der Webhook ein Ziel bereitstellt, kannst du den Anruf an dieses Ziel weiterleiten, indem du im Routing-Schritt (im 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: Input is good.
- NAK: Input is not valid.
- ERR: An error occured.
Destination
Used for forwarding to another destination.
Caller Name
Use this if you want to display the caller's name or the status of the call (such as IVR choice) on a VoIP device.
Feedback interpretation
status=ACK
The request was successfully received and processed with valid input.
status=ACK&destination=%2B31502102544
The request was successfully processed, and the call should be forwarded to the destination number +31 50 210 2544.
status=ACK&destination=215
The request was successfully processed, and the call should be forwarded to the destination number 215.
status=ACK&callername=VoIPGRID
The request was successfully processed, and the caller's name should be set to "VoIPGRID."
Alternative Verwendungsmöglichkeiten für Webhooks
CRM-Kopplung
Bei eingehenden Anrufen 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 dann 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 auf Basis des eingehenden Anrufs ö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 angerufenen Nummer
- Einem eingegebenen PIN-Code
Telefonanrufe in Google Analytics erfassen
Um Telefonanrufe zu erfassen, 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 verfolgen.
Wenn ein Kunde eine der Nummern im Block anruft, senden wir eine URL mit der angerufenen Nummer (die die Kampagne repräsentiert) und der Nummer des Anrufers (falls verfügbar). Bitte 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 erfasst.
E-Mail für verpasste Anrufe 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 angerufener Nummer. Ein detailliertes Beispiel über eine Zapier-Verbindung mit Webhooks findest du unter Webhooks Beispiele.
VIP-PIN-Code
Du kannst einen Webhook verwenden, 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 mit über 300 weiteren Webanwendungen via Zapier
Du kannst deinen Webhook nahtlos mit Zapier verbinden, ähnlich wie IFTTT (If This Then That). Zapier ermöglicht es dir, verschiedene Systeme zu integrieren, sodass eine Aktion in einem Webdienst Aktionen in anderen auslösen kann und eine Kettenreaktion entsteht. Zapier unterstützt die Integration mit Diensten wie Slack, Gmail, Google Calendar, Zendesk, Mailchimp, Evernote, Dropbox und vielen anderen.
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 Anruflebenszyklus aufgerufen werden.
- Für Webhooks verwende bitte eine GET-Anfrage.
- Für Anrufbenachrichtigungen verwende bitte eine POST-Anfrage.