Was ist ein Webhook?
Das Webhooks-Modul ermöglicht umfangreiche Anpassungen, indem es HTTP-Anfragen an externe URLs erlaubt und verschiedene Aktionen auf Basis der zurückgegebenen Daten auslöst. Ob es darum geht, eine Schranke für bestimmte Gespräche zu öffnen, E-Mails für Kundenkontakte zu versenden oder Kopplungen mit CRM-Systemen und Marketingkampagnen herzustellen – die Möglichkeiten sind vielfältig. Konfiguriere die URL und Funktionen, um Rufumleitungen oder Datenbankabfragen ganz nach deinen Bedürfnissen anzupassen.
Schau dir unbedingt Anrufbenachrichtigungen an, um die Möglichkeiten deines Telefondienstes voll auszuschöpfen.
Wie erstellt man einen Webhook?
- Gehe zu Webhooks.
- Klicke auf Hinzufügen.
- Gib einen Namen für deinen Webhook an.
- Optional kannst du im Feld Beschreibung zusätzliche Informationen angeben. Dies ist nicht erforderlich, damit der Webhook funktioniert.
- Unter Caller ID-Übertragung wählst du aus, welche Nummer der Angerufene als Caller ID sehen wird:
- Nummer des Anrufers.
- Angerufene Nummer.
- Unterdrückt (anonymisiert).
- Im Feld URL-Vorlage gibst du 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 URL formatiert sein soll, die vom Webhook aufgerufen wird. Vier Variablen können in der URL-Vorlage verwendet werden:
- {code}: Der vom Anrufer eingegebene Zifferncode (siehe „Verwendung von IVR" weiter 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.companyname.com/test.py?code={code}&callerid={callerid}
IVR verwenden (Interactive Voice Response)
Aktiviere diese Option, wenn der Anrufer einen Zifferncode eingeben soll, um fortzufahren. Nach der 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 an, wie oft der Anrufer versuchen kann, den Zifferncode korrekt einzugeben.
- Startnachricht: Wähle den Sound aus, der abgespielt werden soll, wenn der Anrufer zu diesem Webhook geleitet 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 der Timeout-Zeitraum überschritten wird.
- Klicke auf Speichern.
Wenn alles korrekt eingerichtet ist, besteht jetzt eine Verbindung zwischen deiner Telefonplattform und deinem Skript, CRM-Paket, Zapier oder einem anderen Programm. 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-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, 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, genauso wie in deinem Anrufplan. Hier sind einige Funktionen und ihre Verwendung:
Variable Anrufername
Der Anrufername – der Name, den der Empfänger auf seinem Bildschirm sieht – kann auf drei Arten angepasst werden:
- Webhook: Setzt den Anrufernamen auf den vom Webhook zurückgegebenen Wert.
- Präfix: Gib im Routing-Schritt Text ein, der dem Namen des Anrufers vorangestellt wird.
- Ersetzen: Gib im Routing-Schritt Text ein, der den Namen des Anrufers 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 (im Webhook-Bereich) „Variables Ziel" auswählst.
Rückmeldung, die du dem System geben kannst
Gib die folgende Rückmeldung, 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 zu einem anderen Ziel verwendet.
Anrufername
Verwende diese Funktion, wenn du den Namen des Anrufers oder den Status des Anrufs (wie z. B. die IVR-Auswahl) auf einem VoIP-Gerät anzeigen möchtest.
Interpretation der Rückmeldung
status=ACK
Die Anfrage wurde erfolgreich empfangen und mit gültiger Eingabe verarbeitet.
status=ACK&destination=%2B43502102544
Die Anfrage wurde erfolgreich verarbeitet, und der Anruf sollte an die Zielnummer +43 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 Einsatzmöglichkeiten für Webhooks erkunden
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 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 basierend auf dem eingehenden Anruf öffnen – diese Logik muss jedoch im CRM selbst hinterlegt 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
Telefonanrufe in Google Analytics nachverfolgen
Um Telefonanrufe nachzuverfolgen, 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 nachverfolgen.
Wenn ein Kunde eine der Nummern im Block anruft, senden wir eine URL, die die gewählte Nummer (die die Kampagne repräsentiert) und die Nummer des Anrufers (falls verfügbar) enthält. 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.
Nachdem die URL aufgerufen wurde, leiten wir den Anruf an die Hauptnummer des Unternehmens weiter, und die Kampagne wird erfasst.
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 über Slack zu erhalten, inklusive Datum, Uhrzeit und gewählter Nummer. Schau dir die Webhook-Beispiele für ein detailliertes Beispiel über eine Zapier-Verbindung mit Webhooks an.
VIP-PIN-Code
Du kannst einen Webhook verwenden, um Kunden einen speziellen VIP-PIN-Code zuzuweisen, zum Beispiel für eine dedizierte Support-Hotline. Details zur Einrichtung findest du auf der Seite VIP-PIN-Code.
Verbindung zu über 300 anderen Webanwendungen über 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 Webservice 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 bei eingehenden Anrufen. Bei Bedarf kann für jeden eingerichteten Webhook eine andere URL verwendet werden. Ein Webhook wird zu einem einzigen Zeitpunkt aufgerufen.
Anrufbenachrichtigungen funktionieren sowohl bei eingehenden als auch bei ausgehenden Anrufen. 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.