Prepare REST Request

Dieser Node-Typ wird verwendet, um eine beliebige HTTP Anfrage vorzubereiten, die an eine externe Plattform gesendet werden soll. Alle vorbereiteten Anfragen werden gesendet, wenn die angegebenen Agenten bezogenen Ereignisse eintreten.

Die HTTP Anfrage wird nur gesendet, wenn sie durch ein bestimmtes Ereignis ausgelöst wird, z.B. wenn ein Agent auf einen eingehenden Call aufmerksam gemacht wird oder wenn er einen Call annimmt. Es können mehrere REST Abfragen für dasselbe Ereignis vorbereitet werden.

Mit diesem Node können beispielsweise externe Systeme über Calls des Contact Centers benachrichtigt oder an sie weitergeleitet werden, z. B. über einzelne Kundeninteraktionen, Statistiken usw. zur Überwachung, Konfiguration und Datenanalyse.

Wenn der Replace Placeholders auf true eingestellt ist, ersetzt das System alle im Textkörper gefundenen Platzhalter durch die entsprechenden Werte, wenn die Anfrage gesendet wird. Unterstützte Platzhalter sind: ##agentExternalId##, ##agentUsername##, ##event##, ##queueName## und ##time##. Der Einfachheit halber kann ein Simple JSON Node verwendet werden, um einen JSON String zu erstellen, der diese Platzhalter als Werte enthält. Diese Platzhalter werden wie folgt ersetzt:

  • ##agentExternalId## – ersetzt durch den Wert der externen ID, wie er für das Benutzerkonto eines Agenten im Administrator-Portal konfiguriert ist.
  • ##agentUsername## – wird ersetzt durch den Benutzernamen des Agenten, der angerufen wird.
  • ##event## – wird durch eine der folgenden Zeichenketten ersetzt: AGENT_RINGING, AGENT_ANSWERED, TRANSFER_RINGING, oder TRANSFER_ANSWERED.
  • ##queueName## – ersetzt durch den Namen der Warteschleife, in der sich der aktuelle Call befindet, oder, im Falle einer Weiterleitung, durch den Namen der Zielwarteschleife.
  • ##time## – wird durch eine Zeichenkette im ISO 8601-kompatiblen Format ersetzt.


Bei Bedarf können Sie die Kopfzeile beim Senden einer HTTP Anfrage ändern (z.B. für Authentifizierungszwecke) und zusätzliche Kopfzeilen hinzufügen.

Hinweis: Im Gegensatz zum REST Query Node sendet dieser Node Typ die HTTP-Anfrage nicht sofort, sondern speichert die Anfragedetails, damit die Anfrage bei Eintreten eines bestimmten Ereignisses (oder einer Reihe von Ereignissen) gesendet werden kann.

Hinweis: Bei Bedarf können einige der Parameter für diesen Node-Typ auf user configurable eingestellt werden, so dass sie die von einem Unternehmensadministrator festgelegten Werte annehmen können.

Hinweis: Nur die unten aufgeführten Ports können für die Einrichtung des Nodes verwendet werden:

  • 80 (http)
  • 443 (https)
  • 25 (smtp)
  • 465 (smtps)
  • 587 (smtp)
  • 110 (pop)
  • 995 (pops)
  • 143 (imap)
  • 993 (imaps)


Die folgenden Paramter können eingestellt werden:

ParamterWie viele?TypBeschreibung
Events0 bis 4EnumWann sollte diese HTTP Anfrage versendet werden:

Agent Ringing – Sobald das Telefon des Agenten anfängt zu klingeln

Agent Answered – Sobald der Agent den Call annimmt

Transfer Ringing – Sobald das Telefon desjenigen klingelt, an den der Call weitergeleitet wurde

Transfer Answered – Sobald der Agent den Call annimmt, an welchen der Call weitergeleitet wurde
URL1StringDie URL für die HTTP Anfrage.

Der Parameter kann auf user configurable gestellt werden.
Body1StringDer Body der Oubound HTTP Anfrage.

Der Parameter kann auf user configurable gestellt werden.
Content Type1EnumEiner der Folgenden: JSON, TEXT/PLAIN or TEXT/HTML
Replace Placeholders0 oder 1BooleanOb die Stichwörter der Platzhalter beim Senden der HTTP-Anfrage im Body der HTTP-Anfrage ersetzt werden oder nicht.

Die Platzhalter sind oben definiert.

Der Parameter kann auf user configurable gestellt werden.
Method1EnumDie HTTP Methode, die für die Anfrage verwendet wird. Eine der Folgenden: POST, GET, DELETE or PUT.

Hinweis: Wenn die HTTP Methode auf GET eingestellt ist, wird der Parameter Body weggelassen.
Request Headers0 oder 50Optionale Kopfzeile für die HTTP-Anfrage.
Name0 oder 1StringDer Name der Kopfzeile in der HTTP Anfrage.

Der Parameter kann auf user configurable gestellt werden.
Value0 oder 1StringDer Wert, der der Kopfzeile zugewiesen wird.

Der Parameter kann auf user configurable gestellt werden.


Die folgenden Verzweigungen können eingestellt werden:

VerzweigungWie viele?Beschreibung
Next1Die Verzweigung wird verwendet, wenn die HTTP Anfrage erfolgreich ist.
Failed1Die Verzweigung wird verwendet, wenn die HTTP Anfrage fehlschlägt. Der Fehler wird durch einen Code angezeigt, der sich zwsichen 400 und 599 befindet.

War dieser Artikel hilfreich?

vorheriger Artikel

REST Query