Cette API est appelée lorsqu'un clic de numérotation est demandé par les agents utilisant SalesForce. L'API peut décider si l'appel peut être effectué, et quel numéro de l'appelant doit être utilisé lors de l'appel. Par exemple, appeler un client peut nécessiter la transmission du numéro de téléphone de la hotline, tandis qu'appeler un fournisseur peut nécessiter l'utilisation du numéro de poste de l'agent. Pour utiliser cette API, un terminal REST doit être fourni dans SalesForce pour que le système jtel puisse y accéder. Les pages suivantes décrivent un exemple de mise en œuvre. DemandeGET ParamètresLes données sont transmises à cette API en tant que paramètres dans la requête GET. Les paramètres suivants sont fournis : Nom de domaine | Description |
---|
SalesForceID | L'Id de l'enregistrement dans SalesForce qui doit être appelé. | CallerID | Le numéro à appeler (le numéro sur lequel on a cliqué dans SalesForce, nettoyé pour supprimer les caractères inutiles, la ponctuation et les caractères qui ne peuvent être composés). | AgentUID | L'UID de l'agent est actuellement connecté au système de 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. |
http Status CodesLes codes de statut suivants doivent être utilisés: Statut Code | Signification |
---|
200 – OK | OK, la composition peut se poursuivre en utilisant les informations fournies. | 400 - Bad Request | Mauvais paramètre d'entrée, par exemple enregistrement SalesForce non trouvé. | 403 – Forbidden | Les appels ne sont pas autorisés. Le système jtel refusera de passer l'appel si ce code est renvoyé. | 404 - Not found | L'enregistrement de la force de vente n'a pas été trouvé. Le système jtel refusera de passer l'appel si ce code est renvoyé. |
Retour des donnéesLes données doivent être renvoyées à partir de cette demande au format JSON. Les champs suivants doivent être fournis : Nom du champ | Description |
---|
ServiceNumber | Le numéro de service à utiliser (champ jtel ServiceNumbers.Name). | ServiceNumberName | Le nom du numéro de service à utiliser (jtel field ServiceNumbers.Name2). |
Le système de jtel tentera une correspondance sur le ServiceNumbernuméro de service, puis sur le Nomnom. Le numéro de service ServiceNumber trouvé sera utilisé pour signaler l'appel sortant. |