Webhooks | Notion

Das Webhooks-Modul stellt eine Verbindung zwischen Ihrer Telefonie und dem Internet her. Dieses Modul wird hauptsächlich für drei Zwecke verwendet: CRM-Integration, Vermittlung auf der Grundlage einer externen Datenbank und Messung von Online-Marketingkampagnen (Google Analytics).

Webhook anlegen

Klicke auf Hinzufügen und stimme den Kosten zu.
Gib dem Webhook einen Namen und eine Beschreibung, z.B. 'CRM-Link'.
Wähle aus, welche Nummer der Empfänger des Anrufs als Rufnummernanzeige sehen soll, unter Rufnummernanzeige übertragen. Wähle zwischen 'Anrufernummer', 'Angerufene Nummer' und 'Unterdrückt (Datenschutz)'.
Gib unter URL-Vorlage die URL ein, die bei einem eingehenden Anruf aufgerufen werden soll.
Weitere Erklärungen zum Einrichten Ihrer Webhooks findest du in unserem technischen Wiki.

Felder

Name: der Name des Webhakens, der für die Auswahl im Anrufplan verwendet wird.

Beschreibung: rein administrativ zu Übersichtszwecken; ansonsten für die Funktion des Webhakens irrelevant.

Anrufer-ID übermitteln: Hier kannst du auswählen, welche Nummer der Empfänger des Anrufs als Anrufer-ID sehen soll. Du kannst zwischen "Anrufernummer", "Angerufene Nummer" und "Unterdrückt (Datenschutz)" wählen.

URL-Vorlage: das komplizierteste Feld des Formulars. Der Hilfetext im Formular liefert bereits einige Erklärungen. In diesem Feld wird angegeben, wie die URL aussehen soll, die vom Webhook aufgerufen wird. In der URL-Vorlage können vier Variablen eingegeben werden:

{code}: der vom Anrufer eingegebene Zahlencode (siehe unten "IVR verwenden")
{did}: die angerufene Nummer
{callerid}: die Anrufer-ID des Anrufers
{Anrufername}: der Name des Anrufers, falls vorhanden.

Wahlmenü verwenden: Markiere dies, wenn du möchtest, dass ein Anrufer einen Zahlencode eingeben muss, um fortzufahren. Nach dem Setzen dieses Hakens werden 5 weitere Felder sichtbar:

Timeout: Gib hier die Anzahl der Sekunden ein, die der Anrufer Zeit hat, seinen Zahlencode einzugeben

Anzahl der Versuche: Gib hier die Anzahl der Versuche ein, die der Anrufer hat, um den Zahlencode korrekt einzugeben

Begin Message: wähle hier die AudioMessage aus, die abgespielt werden soll, sobald der Anrufer zu diesem Webhook weitergeleitet wird.

Fehlermeldung: Wähle hier die AudioMessage, die abgespielt werden soll, wenn der Anrufer einen falschen Zahlencode eingegeben hat.

Untitled

<aside> <img src="https://s3-us-west-2.amazonaws.com/secure.notion-static.com/6d93b0aa-f23c-4017-91dd-d0632b72ec91/transparent.png" alt="https://s3-us-west-2.amazonaws.com/secure.notion-static.com/6d93b0aa-f23c-4017-91dd-d0632b72ec91/transparent.png" width="40px" /> Einfache Beispiel einer solchen URL:

http://webrouting.voipgrid.nl/test.py?code={code}&callerid={callerid}

</aside>

Untitled

Timeout-Meldung: Wähle hier die AudioMessage aus, die abgespielt werden soll, wenn die unter Timeout angegebene Anzahl von Sekunden überschritten wird.

</aside>

Webhooks im Anrufplan einstellen

Drücke das Pluszeichen, und es erscheint ein zusätzlicher Schritt auf dem Bildschirm.
Wähle in dem soeben hinzugefügten Schritt Webhook und dann den entsprechenden Webhook aus.
Es wird eine Reihe von Unterschritten erzeugt:
- HTTP und Auswahlmenü erfolgreich: Diese Teilschritte werden ausgeführt, wenn der Webhook die korrekten Werte zurückgegeben hat und der Aufrufer ggf. einen korrekten Code eingegeben hat
- HTTP oder Auswahlmenü fehlgeschlagen: In anderen Fällen werden die hier aufgeführten Teilschritte ausgeführt.

Untitled

</aside>

Variabler Name des Anrufers

Der Name des Anrufers - der Name, den der Anrufer auf seinem Bildschirm sieht - kann auf 3 Arten manipuliert werden:

Webhook: Setze den Anrufernamen auf den vom Webhook zurückgegebenen Wert:

Vorangestellt: Gib in das Textfeld des Routingschritts einen Text ein, der vor dem Namen des Anrufers stehen soll.
Ersetzen: Gib einen Text in das Textfeld im Routing-Schritt ein: Dies wird nun der Name des Anrufers sein.

Untitled

</aside>

Variables endgültiges Ziel

Wenn der Webhook ein endgültiges Ziel zurückgegeben hat, kann dieses durch Auswahl von "Variable final destination" (unter dem Webhook-Header) im Routing-Schritt weitergeleitet werden:

Untitled

</aside>

Rückmeldung, das du dem System geben kannst

Die Rückmeldung, die du dem System geben kannst, lautet:

Status

ACK -> gut
NAK -> nicht gut
ERR -> Fehler

Ziel

Verwendet für die Weiterleitung an ein anderes Endziel: Ein Beispiel:

Anrufname

Verwende diese Option, wenn du den Namen eines Anrufers oder den Status eines Anrufs (Auswahl in einem IVR) in einem VoIP-Gerät anzeigen möchten:

Ein Beispiel: Ein HTTP-Anruf wird erfolgreich abgefangen. Die Rückmeldung wird:

status=ACK

status=ACK&destination=%2B31502102544

status=ACK&destination=215

status=ACK&callername=VoIPGRID

</aside>