Cette API est appelée lorsqu'un clic de numérotation est demandé par les agents utilisant SAP. L'API peut être utilisée pour décider si l'appel peut être effectué, poursuivi et quel numéro de l'appelant service 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 point terminal de terminaison REST doit être fourni dans SAP pour que le système Jtel jtel puisse y accéder. Les pages suivantes décrivent un exemple de mise en œuvreCe qui suit décrit un exemple d'implémentation. 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 |
---|
Jeton d'autorisation | Le jeton d'authentification de base qui est la base 64 codée du nom d'utilisateur:mot de passe | Paramètres REST | Ces paramètres sont séparés par le retour chariot. Toutes les variables commencent par le signe dollar '$' e.g. $filter=CustomerID eq '$SAPBusinessPartnerID' $expand=IndividualCustomerSalesData | SAPBusinessPartnerID | L'ID de l'enregistrement dans SAP qui doit être appelé (celui sur lequel l'utilisateur a cliqué). | SAPPhoneNumber | Le numéro à appeler (le numéro sur lequel vous avez cliqué dans SAP, nettoyé pour supprimer les caractères inutiles, la ponctuation et les caractères qui ne peuvent pas être composés). |
codes de statut httpLes codes de statut suivants doivent être utilisés: Statut Code | Signification |
---|
200 – OK | OK, la composition peut se poursuivre en utilisant les informations fournies. | 200 - REST HTTP Aucun résultat trouvé 400 - Bad Request | Paramètre d'entrée incorrect, par exemple enregistrement SAP introuvable. Le système jtel refusera de passer l'appel si ce code est renvoyé. | 403 – Forbidden | Mauvais identifiant et Les appels ne sont pas autorisés. Le système jtel refusera de passer l'appel n'est pas autorisési ce code est renvoyé. | 404 - Not found | Enregistrement SAP introuvable. Le système | Jtel 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 Il devrait être possible d'extraire les champs suivants doivent être fournis du résultat: Nom du champ | Description |
---|
distributionChannelCodeText | Ce paramètre sera analysé à partir du chemin du résultat JSON et sera utilisé pour correspondre à un numéro de service. | countryCode | Ce paramètre sera analysé à partir du chemin du résultat JSON et sera utilisé pour correspondre à un numéro de service. |
Le système Jtel jtel tentera de faire correspondre un numéro de service basé sur le numéro de contrat, en concaténant la distribution ChannelCodeText et countryCode dans la configuration du numéro de service jtel. Le ServiceNumber trouvé sera utilisé pour signaler l'appel sortant. |