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 The following pages describe an example implementation. RequestPOST Data StructureData is passed to this API as a JSON structure. The following fields are provided: Les pages suivantes décrivent un exemple de mise en œuvre. DemandePOST Enregistrements de donnéesUn 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 API | StatisticsPartA | AcdStatisticsPartB | StatisticsPartB | AcdStatisticsTransactionCodes |
---|
1 | Un appel | Acheminé vers le groupe ACD 1 | Tentative d'appel de l'agent W | Pas de données | 2 | Tentative d'appel de l'agent X | Pas de données | 3 | Acheminé vers le groupe 2 de l'ACD | Appel réussi avec l'agent Y | Code de transaction AAA | 4 | Transfert à l'agent Z | Code de transaction BBB | 5 | Code de transaction CCC |
Structure des donnéesLes données sont transmises à cette API sous la forme d'une structure JSON. Les champs suivants sont prévus : Field Name | Description |
---|
SalesForceID | The Id of the record in SalesForce. | jtelStatisticsPartAID | The ID of the StatisticsPartA record in the jtel system. | AgentUID | The UID of the agent in the jtel system. It is recommended, that for example the "NickName" field in SalesForce be used to map values between the systems, if the login UID cannot be made equal. | bOutbound | 0 = Inbound Call, 1 = Outbound Call. | CallerID | The caller ID of the caller or called party, in E.164 format (fully qualified including country code) without a proceeding +. | ServiceNumber | The used service number in the jtel system, as configured in the "Service Number" field (database field ServiceNumbers.Name) in the jtel system. | ServiceName | The used service in the jtel system, as configured in the "Name" field (database field ServiceNumbers.Name2) in the jtel system. | AcdAgentGroupsName | The name of the agent group used in the jtel system. | AcdConfigurationGroupsName | The name of the configuration group used in the jtel system. For standalone groups, this will be the same as the agent group name. | dtCallStart | The date and time of the start of the call in the format YYYY-MM-DDThh:mm:ss (local jtel server time). | dtCallAlert | The date and time of call ringing in the format Nom du champ | Description |
---|
SalesForceID | L'Id du dossier dans SalesForce. | jtelStatisticsPartAID | L'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. | bOutbound | 0 = appel entrant, 1 = appel sortant. | CallerID | L'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 +. | ServiceNumber | Le 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. | ServiceName | Le 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. | AcdAgentGroupsName | Le nom du groupe d'agents utilisé dans le système jtel. | AcdConfigurationGroupsName | Le 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. | dtCallStart | La date et l'heure du début de l'appel au format AAAA-MM-JJJh:mm:ss (heure locale du serveur jtel). | dtCallAlert | La date et l'heure de la sonnerie d'appel dans le format | local jtel server time). This field can be empty, if no ringing occursheure locale du serveur jtel). Ce champ peut être vide, si aucune sonnerie ne se produit. | dtCallConnect | The date and time of call connect in the format La date et l'heure de l'appel se connectent dans le format YYYY-MM-DDThh:mm:ss ( | local jtel server time). This field can be empty, if no connect occursheure locale du serveur jtel). Ce champ peut être vide, si aucune connexion ne se produit. | dtCallEnd | The date and time of call end in the format La date et l'heure de la fin de l'appel dans le format YYYY-MM-DDThh:mm:ss ( | local jtel server time). This field can be empty, if no ringing occurs.heure locale du serveur jtel). Ce champ peut être vide, si aucune sonnerie ne se produit. | nDuration | Durée de l'appel en secondes. -1 signifie qu'il n'y a pas de connexion. 0 peut signifier une connexion très courte |
nDuration | Duration of the call in seconds. -1 means no connection. 0 can mean a very short connection indeedThe result of the callLe résultat de l'appel 1 = | Connection with No answer Pas de réponse (Inbound = | from from dialled number Busy Occupé (Inbound = agent, Outbound = | dialled number Agent refused call during whisper announcement, or agent refused call during ringingL'agent a refusé l'appel pendant l'annonce à voix basse, ou l'agent a refusé l'appel pendant la sonnerie 5 = cause ISDN | cause see Cause field for exact reasonvoir le champ Cause pour la raison exacte). 7 = | ErrorThe La cause de la fin de l'appel est le Q.850 | cause for the end of the call.For example invalid number normal clearingcompensation normale, 17 = | user busyutilisateur occupé. | TransactionCodeExportKey |
If a transaction code was recorded for the call, then this field will contain the export key of that transaction code. | http Status CodesThe following status codes should be used: Si 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 CodesLes codes de statut suivants doivent être utilisés: Statut Code | Signification |
---|
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 |
Status Code | Meaning |
---|
200 – OK | Data was written | 409 – Conflict | Writing not possible due to a conflict in the data. Data should not be re-transmitted by the jtel systemWriting not possible at this time. Data will be re-transmitted by the jtel system in this caseData should not be re-transmitted by the jtel systemL'écriture n'est pas possible pour l'instant. Dans ce cas, les données seront retransmises par le système jtel. | 404 - Not found | Sales Force record not found. Le registre de la force de vente n'a pas été trouvé. Les données ne doivent pas être retransmises par le système jtel. |
|