Was ist ein Webhook?
Das Webhooks-Modul ermöglicht umfangreiche Anpassungen, indem es HTTP-Anfragen an externe URLs erlaubt 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 Anbindungen an CRM-Systeme und Marketingkampagnen zu realisieren – die Möglichkeiten sind vielfältig. Konfiguriere die URL und Funktionen, um Features wie Rufumleitungen oder Datenbankabfragen nach Deinen Anforderungen anzupassen.
Schau Dir unbedingt die Anrufbenachrichtigungen an, um die Möglichkeiten Deines Telefon-Services optimal zu nutzen.
Wie erstelle ich einen Webhook?
- Gehen Sie zu Webhooks.
- Klicken Sie auf Hinzufügen.
- Geben Sie einen Namen für Ihren Webhook ein.
- Optional können Sie im Feld Beschreibung zusätzliche Informationen angeben. Dies ist für die Funktion des Webhooks nicht erforderlich.
- Wählen Sie unter Caller ID-Übermittlung, welche Nummer der Angerufene als Caller ID sehen soll:
- Nummer des Anrufers.
- Angerufene Nummer.
- Unterdrückt (anonym).
- Geben Sie 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
Aktivieren Sie diese Option, wenn der Anrufer einen Zifferncode eingeben soll, um fortzufahren. Nach Auswahl dieser Option erscheinen fünf zusätzliche Felder:
- Timeout: Geben Sie die Anzahl der Sekunden ein, die der Anrufer für die Eingabe seines Zifferncodes hat.
- Anzahl der Versuche: Geben Sie ein, wie oft der Anrufer versuchen kann, den Zifferncode korrekt einzugeben.
- Startnachricht: Wählen Sie den Sound, der abgespielt werden soll, wenn der Anrufer zu diesem Webhook weitergeleitet wird.
- Fehlermeldung: Wählen Sie den Sound, der abgespielt werden soll, wenn der Anrufer einen falschen Zifferncode eingibt.
- Timeout-Nachricht: Wählen Sie den Sound, der abgespielt werden soll, wenn die Timeout-Zeit überschritten wird.
- Klicken Sie auf Speichern.
Wenn alles korrekt eingerichtet ist, wird nun eine Verbindung zwischen Ihrer Telefonplattform und Ihrem Skript, CRM-System, Zapier oder einem anderen Programm hergestellt. Sie müssen diesen Webhook nur noch in Ihrem Anrufplan aktivieren.
Webhooks im Anrufplan einrichten
- Gehen Sie zu Anrufpläne.
- Klicken Sie auf die Telefonnummer, bei der Sie den Webhook verwenden möchten.
- Klicken Sie auf Anrufplan ändern.
- Klicken Sie an der Stelle, an der Sie den Webhook einfügen möchten, auf Schritt hinzufügen.
- Sie sehen 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 Auswahl trifft 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 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 (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: Ein Fehler ist aufgetreten.
Ziel
Wird für die Weiterleitung an ein anderes Ziel verwendet.
Name des Anrufers
Verwenden Sie dies, wenn Sie den Namen des Anrufers oder den Status des Anrufs (z. B. IVR-Auswahl) auf einem VoIP-Gerät anzeigen möchten.
Feedback-Interpretation
status=ACK
Die Anfrage wurde erfolgreich empfangen und mit gültigen Eingaben verarbeitet.
status=ACK&destination=%2B31502102544
Die Anfrage wurde erfolgreich verarbeitet und der Anruf sollte an die Zielnummer +31 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 Name des Anrufers sollte auf „VoIPGRID" gesetzt werden.
Alternative Verwendungsmöglichkeiten für Webhooks
CRM-Kopplung
Bei einem eingehenden Anruf 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 anzuzeigenden Namen zurück, den wir auf dem Display des VoIP-Telefons anzeigen.
Optional kann das CRM auch ein Kundenprofil basierend auf dem eingehenden Anruf öffnen – diese Logik muss jedoch im CRM selbst verarbeitet 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
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 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). Beachte, dass unser System JavaScript oder ähnliche Skripte nicht 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
Bei einem verpassten Anruf kann es hilfreich sein, die Telefonnummer des Anrufers per E-Mail, SMS oder beispielsweise via Slack zu erhalten – einschließlich Datum, Uhrzeit und angerufener Nummer. Ein detailliertes Beispiel über eine Zapier-Verbindung mit Webhooks findest Du unter Webhooks-Beispiele.
VIP-PIN-Code
Du kannst ein Webhook verwenden, um Kunden einen spezifischen 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 anderen Webanwendungen via Zapier
Du kannst Dein Webhook nahtlos mit Zapier verbinden, ähnlich wie IFTTT (If This Then That). Zapier ermöglicht die Integration verschiedener Systeme, sodass eine Aktion in einem Webdienst 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 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 finden Sie unter:
Bei Anrufbenachrichtigungen kann die URL an fünf verschiedenen Punkten im Anruflebenszyklus aufgerufen werden.
- Für Webhooks verwende eine GET-Anfrage.
- Für Anrufbenachrichtigungen verwende eine POST-Anfrage.