Was ist ein Webhook?
Das Webhooks-Modul ermöglicht eine umfassende Anpassung, indem es HTTP-Anfragen an externe URLs erlaubt und verschiedene Aktionen auf der Grundlage der zurückgesendeten Daten auslöst. Ob es darum geht, eine Schranke für bestimmte Anrufe zu öffnen, E-Mails für Kundenkontakte zu versenden oder die Integration mit CRM-Systemen und Marketingkampagnen – die Möglichkeiten sind vielfältig. Konfigurieren Sie die URL und die Optionen, um Funktionen wie Rufumleitung oder Datenbankabfragen an Ihre Bedürfnisse anzupassen.
Wie erstellt man einen Webhook?
- Gehen Sie zu Webhooks.
- Klicken Sie auf Hinzufügen.
- Geben Sie einen Namen für Ihren Webhook ein.
- Optional können Sie zusätzliche Informationen in das Feld Beschreibung eingeben. Dies ist nicht erforderlich, damit der Webhook funktioniert.
- Wählen Sie unter Caller ID-Übertragung, welche Nummer der Anrufempfänger als Caller ID sehen soll:
- Die Nummer des Anrufers.
- Angerufene Nummer.
- Unterdrückt (anonym).
- Geben Sie in das Feld URL-Vorlage die URL ein, die bei einem eingehenden Anruf ausgelöst werden soll. Der Hilfetext im Formular enthält weitere Einzelheiten. Dieses Feld gibt an, wie die URL, die vom Webhook aufgerufen werden soll, formatiert werden soll. Vier Variablen können in der URL-Vorlage verwendet werden:
- {code}: Der vom Anrufer eingegebene Zahlencode (siehe „Auswahlmenü 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 lauten:
http://webrouting.companyname.com/test.py?code={code}&callerid={callerid}
Ein Auswahlmenü (IVR - Interactive Voice Response) verwenden
Markieren Sie dieses Feld, wenn Sie möchten, dass der Anrufer einen Zahlencode eingibt, um fortzufahren. Nachdem Sie diese Option ausgewählt haben, werden fünf weitere Felder angezeigt:
- Zeitüberschreitung: Geben Sie die Anzahl der Sekunden ein, die der Anrufer für die Eingabe seines Zahlencodes benötigt.
- Anzahl der Versuche: Geben Sie an, wie oft der Anrufer versuchen kann, den Zahlencode richtig einzugeben.
- Ansage beginnen: Wählen Sie die Aufnahme, die abgespielt werden soll, wenn der Anrufer zu diesem Webhook geleitet wird.
- Fehlermeldung: Wählen Sie die Aufnahme, die abgespielt werden soll, wenn der Anrufer einen falschen Zahlencode eingibt.
- Zeitüberschreitungs-Ansage: Wählen Sie die Aufnahme aus, die abgespielt werden soll, wenn die festgelegte Zeit überschritten wird.
- Klicken Sie auf Speichern.
Wenn alles korrekt eingerichtet ist, wird nun eine Verbindung zwischen Ihrer Telefonieplattform und Ihrem Skript, CRM-Paket, Zapier oder einem anderen Programm hergestellt. Sie müssen diesen Webhook nur in Ihrem Anrufplan aktivieren.
Einrichten von Webhooks im Anrufplan
- Gehen Sie zu Anrufpläne.
- Klicken Sie auf die Telefonnummer, unter der Sie den Webhook verwenden möchten.
- Klicken Sie auf Anrufplan ändern.
- Klicken Sie auf Schritt hinzufügen an der Stelle, an der Sie den Webhook einfügen möchten.
- Sie werden zwei Unterschritte sehen:
- HTTP- und IVR-Erfolg: Diese Teilschritte werden ausgeführt, wenn der Webhook die richtigen 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 wenn die URL nicht funktioniert, möglicherweise aufgrund eines Serverproblems.
Was Sie in Ihren Webhook aufnehmen sollten
Sie können verschiedene Elemente in Ihren Webhook integrieren, so wie Sie es auch in Ihrem Anrufplan tun würden. Im Folgenden finden Sie einige Optionen und ihre Verwendung:
Der Name des Anrufers — der Name, den der Empfänger auf seinem Bildschirm sieht — kann auf drei Arten eingestellt werden:
- Webhook: Setzen Sie den Namen des Anrufers auf den vom Webhook zurückgegebenen Wert.
- Präfix: Geben Sie im Schritt Weiterleitung einen Text ein, der dem Namen des Anrufers vorangestellt wird.
- Ersetzen: Geben Sie im Schritt Routing einen Text ein, der den Namen des Anrufers vollständig ersetzt.
Wenn der Webhook ein Ziel angibt, können Sie den Anruf an dieses Ziel weiterleiten, indem Sie im Schritt Routing (unter dem Webhook-Bereich) „Variables Ziel“ auswählen.
Geben Sie das folgende Feedback, um den Status der Webhook-Interaktion anzuzeigen.
Status
- ACK: Input ist gut.
- NAK: Die Eingabe ist nicht gültig.
- ERR: Es ist ein Fehler aufgetreten.
Interpretation von Feedback
status=ACK
Die Anfrage wurde erfolgreich empfangen und mit gültigen Eingaben verarbeitet.
Ziel:
Wird für die Umleitung an ein anderes Ziel verwendet.
status=ACK&destination=%2B31502102544
Die Anfrage wurde erfolgreich bearbeitet, und der Anruf sollte an die Zielnummer +31 50 210 2544 weitergeleitet werden.
status=ACK&destination=215
Die Anfrage wurde erfolgreich bearbeitet, und der Anruf sollte an die Zielnummer 215 weitergeleitet werden.
Name des Anrufers
Verwenden Sie diese Option, wenn Sie den Namen des Anrufers oder den Status des Anrufs (z. B. IVR-Auswahl) auf einem VoIP-Telefon anzeigen möchten.
status=ACK&callername=VoIPGRID
Die Anfrage wurde erfolgreich bearbeitet, und der Name des Anrufers sollte auf „VoIPGRID“ gesetzt werden
Erkundung alternativer Verwendungsmöglichkeiten für den Webhook
- Umschalten auf Basis einer externen Datenbank
- Nummer des Anrufers
- Angerufene Nummer
- Eingegebener PIN-Code
- Verfolgung von Telefonanrufen in Google Analytics
- VIP-Pincode
- Verbindung zu mehr als 300 anderen Webanwendungen über Zapier
Wir können eingehende Anrufe an eine Telefonnummer weiterleiten, die von einem externen System zurückgegeben wird. Dies kann auf der folgenden Grundlage erfolgen:
Um Telefonanrufe zu verfolgen, benötigen Sie einen Nummernblock. Weisen Sie jeder Kampagne eine eindeutige Nummer zu. Mit einem Block von 10 Nummern können Sie bis zu 10 Kampagnen gleichzeitig verfolgen.
Wenn ein Kunde eine der Nummern im Block anruft, senden wir eine URL mit der angerufenen Nummer (die für die Kampagne steht) und der Nummer des Anrufers (falls verfügbar). Beachten Sie, dass unser System kein JavaScript oder ähnliche Skripte verarbeitet. Daher muss nach dem Aufruf der URL ein Stück Code ausgeführt werden, um die Konvertierung korrekt zu messen.
Nachdem die URL aufgerufen wurde, leiten wir den Anruf an die Hauptnummer des Unternehmens weiter, und die Kampagne wird nachverfolgt.
Sie können einen Webhook verwenden, um Kunden einen bestimmten VIP-PIN-Code zuzuweisen, z. B. für eine spezielle Support-Hotline. Einzelheiten zur Einrichtung finden Sie auf der Seite VIP-PIN-Code.
Sie können Ihren Webhook nahtlos mit Zapier verbinden, ähnlich wie bei IFTTT (If This Then That). Mit Zapier können Sie verschiedene Systeme integrieren, so dass eine Aktion in einem Webservice Aktionen in anderen auslösen kann, wodurch 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. Wenn nötig, kann für jeden eingerichteten Webhook eine andere URL verwendet werden. Ein Webhook wird zu einem bestimmten Zeitpunkt aufgerufen.
Anrufbenachrichtigungen funktionieren sowohl für eingehende als auch ausgehende Anrufe. Weitere Details finden Sie unter:
Bei Anrufbenachrichtigungen kann die URL zu fünf verschiedenen Zeitpunkten im Anrufzyklus aufgerufen werden.
Mit Webhooks wird nur eine URL ausgelöst. Bei Anrufbenachrichtigungen kann die URL zu fünf verschiedenen Zeitpunkten ausgelöst werden.
- Für Webhooks verwenden Sie eine GET Anfrage.
- Für Anrufbenachrichtigungen verwenden Sie eine POST Anfrage.