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:

Image Modified

Direct Inbound Answer

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

Image Modified



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 :

Image Added

Réponse entrante directe

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

Image Added