Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Sv translation
languageen

ACD Group Parameters can be triggered to send REST calls from the telephony server during call processing with agents.

Syntax

The syntax of the parameter name determines where in the call flow the REST call is made. 

The syntax of the parameter value determines the actual REST call made.

Parameter Name

The syntax is as follows:

CallTransfer.Client.<UseCase>.<Event>

<UseCase>

The following use cases are provided:

<UseCase>

Description

INBOUND.ACD.DIRECTA direct inbound call
INBOUND.ACD.BLENDEDA direct inbound call which has gone through call blending
OUTBOUND.CLICKTOCALLAn outbound call via the click to dial function in agent home
OUTBOUND.DIALLERAn outbound call made via the dialler
TRANSFER.AGENT

Call transfer to an agent

TRANSFER.GROUPCall transfer to an ACD-Group
TRANSFER.SYNONYMCall transfer to a synonym
TRANSFER.NUMBERCall transfer to a number
TRANSFER.NUMBER_ANNOUNCEMENTCall transfer to a number with a configured announcement

<Event>

The following events are provided which affect when the configured REST function is triggered:

<Event>

Description

InboundOutboundComments
RINGINGsent when the call is in the ringing statexxThis event is always sent FIRST.
CONNECTEDsent when the call is connectedxx
CONNRES.1sent when the call was successful and is endedxx
CONNRES.2sent when the call was not answeredxx
CONNRES.3send when the destination is busy 
x

Not provided for inbound calls, since RINGING is required first. 

CONNRES.4

sent when the caller (inbound) or agent (outbound) hungup during the call initiation or ringing phase

xx
CONNRES.5


Not provided as RINGING is required first.
CONNRES.6sent when the called agent refused the call or hungup during a whisper transfer announcementx

If a destination agent telephone rings then becomes busy, this means the agent refused the call. 

This CONNRES is used in that case.

CONNRES.7


Not provided since RINGING is required first. 

Examples

CallTransfer.Client.INBOUND.ACD.DIRECT.RINGING

CallTransfer.Client.INBOUND.ACD.DIRECT.CONNECTED

CallTransfer.Client.INBOUND.ACD.DIRECT.CONNRES.2

CallTransfer.Client.OUTBOUND.DIALLER.CONNECTED

Parameter Values

The value of the parameter determines how the REST call is made.

It is a multi-line parameter, each line must begin with one of the fields below followed by an equals ("=") sign.

The right hand part of the value determines the actual value used in the REST call.

The following lines are supported:

Value

Description

SpecifyExample
URL=<url>

Specifies the URL to be called. Should be specified in fully qualified form using http or https as the protocol.

A port can also be specified.

Once
URL=https://myrestserver.com:1234
METHOD=GET/POSTSpecifies the http method to useOnce
METHOD=GET
TIMEOUT=<ms>Specifies a timeout in ms before the function is aborted.Once
TIMEOUT=3000
HEADER=<http_header>Specifies an http header to be used. May be specified multiple times.Zero or more times 
HEADER=Bearer-Token: xxyyzz
QUERYPARAM=<param=value>Specifies a query parameter which will be added to the URL in URL encoded format,Zero or more times
QUERYPARAM=Agent=$agent_nickname
DATA=<value>Specifies POST data which will be sent with the request. Zero or one time
DATA=Agent=$agent_nickname

Variables

The following variables may be used in the parameter value:

Variable

Description

$date_timethe current date and time
$service_numberthe ServiceNumbers.Name field
$service_namethe ServiceNumbers.Name2 field
$callerthe caller ID
$agent_nameThe surname of the agent
$agent_firstnameThe firstname of the agent
$agent_numberThe number of the agent
$agent_id The ID of the agent
$agent_tel The telephone number of the agent
$agent_uidThe UID of the agent
$agent_nicknameThe NickName of the agent
$group_nameThe name of the ACD group
$group_number The number of the ACD group
$diallercampaign_nameThe name of the dialler campaign
$diallercontact_nameThe surname of the dialler contact
$diallercontact_firstnameThe firstname of the dialler contact
$diallercontact_externalsystemlinkThe external system link for the dialler contact
$diallercontact_userdataThe UserData field for the dialler contact

Examples

Direct Inbound RINGING

The following parameter will send a GET request when a direct inbound ACD call is ringing:

Direct Inbound Answer

This parameter will send a POST request when a direct inbound ACD call is not answered:



Sv translation
languagefr

Les paramètres de groupe ACD peuvent être déclenchés pour envoyer des appels REST depuis le serveur de téléphonie pendant le traitement des appels avec les agents.

Syntaxe

La syntaxe du nom du paramètre détermine où dans le flux d'appels l'appel REST est effectué.

La syntaxe de la valeur du paramètre détermine l'appel REST réel effectué.

Le nom du paramètre

La syntaxe est la suivante :

CallTransfer.Client.<UseCase>.<Event>

<UseCase>

Les cas d'utilisation suivants sont fournis :

<UseCase>

Description

INBOUND.ACD.DIRECTUn appel entrant direct
INBOUND.ACD.BLENDEDUn appel entrant direct qui est passé par le mélange d'appels
OUTBOUND.CLICKTOCALLUn appel sortant via la fonction click to dial dans l'accueil de l'agent
OUTBOUND.DIALLERUn appel sortant passé via le numéroteur
TRANSFER.AGENT

Transfert d'appel vers un agent

TRANSFER.GROUPTransfert d'appel vers un groupe ACD
TRANSFER.SYNONYMTransfert d'appel vers un synonyme
TRANSFER.NUMBERTransfert d'appel vers un numéro
TRANSFER.NUMBER_ANNOUNCEMENTTransfert d'appel vers un numéro avec une annonce configurée

<Event>

Les événements suivants sont fournis et affectent le moment où la fonction REST configurée est déclenchée :

<Event>

Description

Entrant

Sortant

Commentaires

RINGINGenvoyé lorsque l'appel est en état de sonneriexxCet événement est toujours envoyé en PREMIER.
CONNECTEDenvoyé lorsque l'appel est connectéxx
CONNRES.1envoyé lorsque l'appel a réussi et est terminéxx
CONNRES.2envoyé lorsque l'appel n'a pas été réponduxx
CONNRES.3envoyer lorsque la destination est occupée
x

Not provided for inbound calls, since RINGING is required first. 

CONNRES.4

envoyé lorsque l'appelant (entrant) ou l'agent (sortant) a raccroché pendant la phase d'appel ou de sonnerie

xx
CONNRES.5


Non fourni car RINGING est requis en premier.
CONNRES.6envoyé lorsque l'agent appelé a refusé l'appel ou a raccroché lors d'une annonce de transfert chuchotéx

Si le téléphone d'un agent destinataire sonne puis devient occupé, cela signifie que l'agent a refusé l'appel.

Ce CONNRES est utilisé dans ce cas.

CONNRES.7


Non fourni car RINGING est requis en premier.

Exemples

CallTransfer.Client.INBOUND.ACD.DIRECT.RINGING

CallTransfer.Client.INBOUND.ACD.DIRECT.CONNECTED

CallTransfer.Client.INBOUND.ACD.DIRECT.CONNRES.2

CallTransfer.Client.OUTBOUND.DIALLER.CONNECTED

Valeurs des paramètres

La valeur du paramètre détermine la manière dont l'appel REST est effectué.

Il s'agit d'un paramètre multiligne, chaque ligne doit commencer par l'un des champs ci-dessous suivi d'un signe égal ("=").

La partie droite de la valeur détermine la valeur réelle utilisée dans l'appel REST.

Les lignes suivantes sont prises en charge :

Valeur

Description

Spécifier

Exemple

URL=<url>

Spécifie l'URL à appeler. Doit être spécifié sous une forme pleinement qualifiée en utilisant http ou https comme protocole.

Un port peut également être spécifié.

Une fois
URL=https://myrestserver.com:1234
METHOD=GET/POSTSpécifie la méthode http à utiliserUne fois
METHOD=GET
TIMEOUT=<ms>Spécifie un délai d'attente en ms avant l'abandon de la fonction.Une fois
TIMEOUT=3000
HEADER=<http_header>Spécifie un en-tête http à utiliser. Peut être spécifié plusieurs fois.Zéro ou plusieurs fois
HEADER=Bearer-Token: xxyyzz
QUERYPARAM=<param=value>Spécifie un paramètre de requête qui sera ajouté à l'URL au format URL encodé,Zéro ou plusieurs fois
QUERYPARAM=Agent=$agent_nickname
DATA=<value>Spécifie les données POST qui seront envoyées avec la requête.Zéro ou une fois
DATA=Agent=$agent_nickname

Variables

Les variables suivantes peuvent être utilisées dans la valeur du paramètre :

Variable

Description

$date_timela date et l'heure actuelle
$service_numberle champ ServiceNumbers.Name
$service_namele champ ServiceNumbers.Name2
$callerl'identifiant de l'appelant
$agent_nameLe nom de l'agent
$agent_firstnameLe prénom de l'agent
$agent_numberLe numéro de l'agent
$agent_id L'identifiant de l'agent
$agent_tel Le numéro de téléphone de l'agent
$agent_uidL'UID de l'agent
$agent_nicknameLe pseudonyme de l'agent
$group_nameLe nom du groupe ACD
$group_number Le numéro du groupe ACD
$diallercampaign_nameLe nom de la campagne de numérotation
$diallercontact_nameLe nom du contact du numéroteur
$diallercontact_firstnameLe prénom du contact numéroteur
$diallercontact_externalsystemlinkLe lien système externe pour le contact du numéroteur
$diallercontact_userdataLe champ UserData pour le contact du numéroteur

Exemples

SONNERIE entrante directe

Le paramètre suivant enverra une requête GET lorsqu'un appel ACD entrant direct sonne :

Réponse entrante directe

Ce paramètre enverra une requête POST lorsqu'un appel ACD entrant direct n'est pas répondu :


Sv translation
languagede

ACD-Gruppenparameter können verwendet werden, um während der Anrufbearbeitung mit Agenten REST-Calls vom Telefonieserver zu senden.

Syntax

Die Syntax des Parameternamens bestimmt, an welcher Stelle des Anrufablaufs der REST-Call erfolgt. 

Die Syntax des Parameterwerts bestimmt den tatsächlich durchgeführten REST-Call.

Parameter Name

Die Syntax ist wie folgt:

CallTransfer.Client.<UseCase>.<Event>

<UseCase>

Die folgenden Use Cases sind vorgesehen:

<UseCase>

Beschreibung

INBOUND.ACD.DIRECTEin direkter eingehender-Anruf
INBOUND.ACD.BLENDEDEin direkter eingehender Anruf, der durch Call-Blending gegangen ist.
OUTBOUND.CLICKTOCALLEin ausgehender Anruf über die Click-to-Dial-Funktion in Agent Home
OUTBOUND.DIALLEREin über den Dialer getätigter ausgehender Anruf
TRANSFER.AGENT

Anrufweiterleitung an einen Agenten

TRANSFER.GROUPAnrufweiterleitung an eine ACD-Gruppe
TRANSFER.SYNONYMAnrufweiterleitung an ein Synonym
TRANSFER.NUMBERAnrufweiterleitung an eine Nummer
TRANSFER.NUMBER_ANNOUNCEMENTAnrufweiterleitung an eine Nummer mit einer Konfigurierten Ansage

<Event>

Die folgenden Events sind bereitgestellt. Sie beeinflussen, wann die konfigurierte REST-Funktion ausgelöst wird:

<Event>

Beschreibung

EingehendAusgehendKommentar
RINGINGwird gesendet, wenn der Anruf klingelt.xxDieses Ereignis wird immer ZUERST gesendet.
CONNECTEDwird gesendet, wenn der Anruf verbunden ist.xx
CONNRES.1wird gesendet, wenn der Anruf erfolgreich war und beendet wurde.xx
CONNRES.2wird gesendet, wenn der Anruf nicht angenommen wurde.xx
CONNRES.3wird gesendet, wenn das Ziel besetzt ist. 
x

Für eingehende Anrufe nicht bereitgestellt, da zuerst RINGING erforderlich ist. 

CONNRES.4

wird gesendet, wenn der Anrufer (eingehend) oder der Agent (ausgehend) während der Einleitungs- oder Klingelphase des Anrufs aufgelegt hat

xx
CONNRES.5


Nicht bereitgestellt, da zuerst RINGING erforderlich ist. 
CONNRES.6gesendet, wenn der angerufene Agent den Anruf abgelehnt oder während einer Flüstertransferansage aufgelegt hatx

Wenn das Telefon eines Zielagenten klingelt und dann besetzt ist, bedeutet dies, dass der Agent den Anruf abgelehnt hat. 

Dieses CONNRES wird in diesem Fall verwendet.

CONNRES.7


Nicht bereitgestellt, da zuerst RINGING erforderlich ist. 

Beispiele

CallTransfer.Client.INBOUND.ACD.DIRECT.RINGING

CallTransfer.Client.INBOUND.ACD.DIRECT.CONNECTED

CallTransfer.Client.INBOUND.ACD.DIRECT.CONNRES.2

CallTransfer.Client.OUTBOUND.DIALLER.CONNECTED

Parameter Werte

Der Wert des Parameters bestimmt, wie der REST-Call durchgeführt wird.

Es ist ein mehrzeiliger Parameter, jede Zeile muss mit einer der unteren Feldern beginnen, gefolgt von einem Ist-Gleich("=") Zeichen

Der rechte Teil des Wertes bestimmt den tatsächlichen Wert, der im REST-Call verwendet wird.

Die folgenden Zeilen werden unterstützt:

Wert

Beschreibung

SpezifizierenBeispiel
URL=<url>

Spezifiziert die aufzurufende URL. Sie sollte in vollqualifizierter Form unter Verwendung von http oder https als Protokoll spezifiziert werden.

Es kann auch ein Port angegeben werden.

einmal
URL=https://myrestserver.com:1234
METHOD=GET/POSTSpezifiziert die http Methode die benutzt wird.einmal
METHOD=GET
TIMEOUT=<ms>Spezifiziert eine Zeitüberschreitung in ms, bevor die Funktion abgebrochen wird.einmal
TIMEOUT=3000
HEADER=<http_header>Spezifiziert einen zu verwendenden http-Header. Kann mehrfach angegeben werden.kein- oder mehrmals 
HEADER=Bearer-Token: xxyyzz
QUERYPARAM=<param=value>Spezifiziert einen Abfrageparameter, welcher der URL im URL-kodierten Format hinzugefügt wird,kein- oder mehrmals
QUERYPARAM=Agent=$agent_nickname
DATA=<value>Spezifiziert die POST-Daten, die mit der Anfrage gesendet werden. kein- oder einmal
DATA=Agent=$agent_nickname

Variablen

Die folgenden Variablen können im Parameterwert verwendet werden:

Variable

Beschreibung

$date_timeDatum und Uhrzeit aktuell
$service_numberdas ServiceNumbers.Name Feld
$service_name

das ServiceNumbers.Name2 Feld

$callerdie Anrufer ID
$agent_nameDer Nachname des Agenten
$agent_firstnameDer Vorname des Agenten
$agent_numberDie Nummer des Agenten
$agent_id Die ID des Agenten
$agent_tel Die Telefonnummer des Agenten
$agent_uidDie UID des Agenten
$agent_nicknameDer NickName des Agenten
$group_nameDer Name der ACD-Gruppe
$group_number Die Nummer der ACD-Gruppe
$diallercampaign_nameDer Name der Dialer-Kampagane
$diallercontact_nameDer Nachname des Dialer-Kontaktes
$diallercontact_firstnameDer Vorname des Dialer-Kontaktes
$diallercontact_externalsystemlinkDer externe System-Link für den Dialer-Kontakt
$diallercontact_userdataDas Benutzerdaten-Feld für den Dialer-Kontakt

Beispiele

Direkt Eingehend RINGING

Der folgende Parameter sendet eine GET-Anfrage, wenn ein direkt eingehender ACD-Anruf klingelt:

Direkt Eingehend ANSWER

Dieser Parameter sendet eine POST-Anfrage, wenn ein direkt eingehender ACD-Anruf nicht beantwortet wird: