Cette API fonctionne avec un objet IVR dans le système jtel, qui peut être utilisé pour rechercher des enregistrements dans SalesForce lorsque lors des appels sont reçusentrants. Les résultats de la recherche effectuée sont disponibles sous forme de variables, et peuvent être utilisés pour influencer le routage dans le système jtel, par exemple pour router vers un agent particulier, ou vers un groupe ACD particulier. 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. GET Les paramètres suivants sont fournis dans la requête REST: | Nom du paramètre | De jtel Release | Description |
|---|
| CallerID |
| Le numéro de l'appelant dans le format E.164 (pleinement qualifié sans +). | | ServiceNumber |
| Le numéro de service appelé (champ jtel ServiceNumbers.Name). | | ServiceName |
| Le nom du service appelé (champ jtel ServiceNumbers.Name2). | | Fonction | | Status |
|---|
| subtle | vrai |
|---|
| colour | Blue |
|---|
| title | 3.25 / 2021-07-02 vers le haut |
|---|
|
| La fonction à exécuter. Ce paramètre peut être utilisé pour différencier l'action requise et pourrait être utilisé pour de nombreux cas d'affaires. Par exemple, pour rechercher un billet. Ou événement pour mettre à jour SalesForce et créer un objet. | | UserData | | Status |
|---|
| subtle | vrai |
|---|
| colour | Blue |
|---|
| title | 3.25 / 2021-07-02 vers le haut |
|---|
|
| Un paramètre définissable défini par l'utilisateur qui peut contenir n'importe quelle information. | | UserData2 | | Status |
|---|
| subtle | vrai |
|---|
| colour | Blue |
|---|
| title | 3.25 / 2021-07-02 vers le haut |
|---|
|
| Un paramètre définissable défini par l'utilisateur qui peut contenir n'importe quelle information. | | UserData3 | | Status |
|---|
| subtle | vrai |
|---|
| colour | Blue |
|---|
| title | 3.25 / 2021-07-02 vers le haut |
|---|
|
| Un paramètre définissable défini par l'utilisateur qui peut contenir n'importe quelle information. |
Les codes de statut suivants doivent être utilisés: | De jtel Release | |
|---|
200 – OK |
| Un enregistrement a été trouvé et retourné. | | 300 - Choix multiples | | Status |
|---|
| |
|---|
| subtle | true |
|---|
| colour | Yellow |
|---|
| title | 3.29 / 2022-08-08 ET ANTÉRIEURS |
|---|
|
| De nombreux documents ont été trouvés. (Aucun dossier ne doit être retourné dans ce cas). | 300 - Choix multiples | | Status |
|---|
| |
|---|
| subtle | true |
|---|
| colour | Blue |
|---|
| title | 3.30 / 2022-08-08 ET ULTÉRIEUR |
|---|
|
| Plusieurs enregistrements ont été trouvés. La classe Apex peut soit : - ne renvoyer aucun enregistrement
- renvoyer l'un des enregistrements trouvés
Dans ce cas, si l'enregistrement doit être utilisé pour un screen-pop (en remplissant le champ UserData), il convient de fournir à l'agent des informations indiquant que plusieurs enregistrements existent en fait, par exemple dans le champ d'informations supplémentaires. - retourner tous les enregistrements trouvés dans un tableau.
Dans le dernier cas, la logique de l'application de routage sera d'autant plus difficile, mais l'application de routage aura accès à tous les enregistrements retournés dans des variables avec une indexation supplémentaire. Par exemple $SalesForce.0.ID ... $SalesForce.1.ID et ainsi de suite.
| | 404 - Not found |
| Aucun enregistrement n'a été trouvé. |
La structure de retour doit être JSON, mais sinon tous les champs et tout le contenu peuvent être retournés. Le système jtel analysera les données en variables pour l'interface graphique jtel IVR, de la forme $SalesForce.FieldName Si les structures sont imbriquées, la variable sera nommée en conséquence: $SalesForce.Entity.FieldName L'examen du journal des appels vous indiquera les noms exacts des champs retournés. | 