Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Sv translation
languagefr

Cette API est appelée hors ligne, après qu'un appel se soit terminé dans l'ACD JTEL.

Le résultat de l'appel, et certaines statistiques concernant l'appel, sont transmis à l'instance de la force de vente.

Ces données peuvent être utilisées, par exemple, pour créer un enregistrement d'activité dans SalesForce associé à l'enregistrement SalesForce concerné.

Pour utiliser cette API, un terminal REST doit être fourni dans SalesForce pour que le système jtel puisse y accéder.

De plus, le démon suivant doit être activé dans le système jtel :

\\acd-store\shared\JTELCarrierPortal\AppServer\SalesForce\SalesForce.Daemon.REST.writeCallStatistics.r5

Les pages suivantes décrivent un exemple de mise en œuvre.

Demande

POST

Enregistrements de données

Un appel API sera effectué pour chaque ligne de données associée produite pour un appel. Cela signifie que plus d'un appel API peut être effectué pour chaque appel reçu par le système jtel, en fonction de sa configuration.

Le tableau suivant le montre :

Appel APIStatisticsPartAAcdStatisticsPartBStatisticsPartBAcdStatisticsTransactionCodes
1Un appelAcheminé vers le groupe ACD 1Tentative d'appel de l'agent WPas de données
2Tentative d'appel de l'agent XPas de données
3Acheminé vers le groupe 2 de l'ACDAppel réussi avec l'agent YCode de transaction AAA
4Transfert à l'agent ZCode de transaction BBB
5Code de transaction CCC

Structure des données

Les données sont transmises à cette API sous la forme d'une structure JSON. 

Les champs suivants sont prévus :

Nom du champDescription
SalesForceIDL'Id du dossier dans SalesForce.
jtelStatisticsPartAIDL'ID de l'enregistrement StatisticsPartA dans le système jtel.
AgentUID

L'UID de l'agent dans le système jtel.

Il est recommandé, par exemple, d'utiliser le champ "NickName" dans SalesForce pour faire correspondre les valeurs entre les systèmes, si l'UID de connexion ne peut être rendu égal.

bOutbound0 = appel entrant, 1 = appel sortant.
CallerIDL'identification de l'appelant ou de la partie appelée, au format E.164 (entièrement qualifié, y compris l'indicatif du pays) sans procédure +.
ServiceNumberLe numéro de service utilisé dans le système jtel, tel que configuré dans le champ "Service Number" (champ de la base de données ServiceNumbers.Name) dans le système jtel.
ServiceNameLe service utilisé dans le système jtel, tel que configuré dans le champ "Name" (champ de la base de données ServiceNumbers.Name2) dans le système jtel.
AcdAgentGroupsNameLe nom du groupe d'agents utilisé dans le système jtel.
AcdConfigurationGroupsNameLe nom du groupe de configuration utilisé dans le système jtel. Pour les groupes autonomes, ce sera le même que le nom du groupe d'agents.
dtCallStartLa date et l'heure du début de l'appel au format AAAA-MM-JJJh:mm:ss (heure locale du serveur jtel).
dtCallAlertLa date et l'heure de la sonnerie d'appel dans le format YYYY-MM-DDThh:mm:ss (heure locale du serveur jtel). Ce champ peut être vide, si aucune sonnerie ne se produit.
dtCallConnectLa date et l'heure de l'appel se connectent dans le format YYYY-MM-DDThh:mm:ss (heure locale du serveur jtel). Ce champ peut être vide, si aucune connexion ne se produit.
dtCallEndLa date et l'heure de la fin de l'appel dans le format YYYY-MM-DDThh:mm:ss (heure locale du serveur jtel). Ce champ peut être vide, si aucune sonnerie ne se produit.
nDurationDurée de l'appel en secondes. -1 signifie qu'il n'y a pas de connexion. 0 peut signifier une connexion très courte (< 500 ms) en effet.
CONNRES

Le résultat de l'appel

1 = lien avec l'agent
2 = Pas de réponse (Inbound = de l'agent, Outbound = du numéro composé)
3 = Occupé (Inbound = agent, Outbound = numéro composé)
4 = L'agent a refusé l'appel pendant l'annonce à voix basse, ou l'agent a refusé l'appel pendant la sonnerie
5 = cause ISDN (voir le champ Cause pour la raison exacte).
7 = Erreur

Cause

La cause de la fin de l'appel est le Q.850

Par exemple, 1 = numéro non valide, 16 = compensation normale, 17 = utilisateur occupé.

TransactionCodeExportKeySi un code de transaction a été enregistré pour l'appel, ce champ contiendra alors la clé d'exportation de ce code de transaction.

http Statut Codes

Les codes de statut suivants doivent être utilisés:

Statut CodeSignification

200 – OK

Les données ont été rédigées
409 – Conflict

Ecriture impossible en raison d'un conflit dans les données. Les données ne doivent pas être retransmises par le système jtel.

423 – LockedL'écriture n'est pas possible pour l'instant. Dans ce cas, les données seront retransmises par le système jtel.
404 - Not foundLe registre de la force de vente n'a pas été trouvé. Les données ne doivent pas être retransmises par le système jtel.