Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Sv translation
languageen

Status
colourBlue
titleFROM RELEASE 3.34

Using the API in the jtel system involves using the genericQuery object in a routing application.

A sample routing application is shown here which can be used in combination with the task scheduler to retrieve tasks from Salesforce at regular intervals.

genericQuery

This object performs calls the REST API genericQuery in the SalesForce instance. 

Note: because the endpoint is configurable, there can be many genericQuery endpoints in the Salesforce instance for different use-cases.

The following parameters are provided:


ParameterDescription
Param1The 1st parameter passed to the service.
Param2The 2nd parameter passed to the service.
Param3The 3rd parameter passed to the service.
Param4The 4th parameter passed to the service.
QueryThe query parameter passed to the service.

Return Data

The return data should be valid JSON.

Note: all fields returned from the sales force query, will be available in the GUI as variables in the form: $SalesForce.<FIELD_NAME>

Bei der Verwendung der API im Jtel-System wird das getCallerInformation-Objekt in einer Routing-Anwendung verwendet.

Ein Beispiel für eine Routing-Anwendung wird hier gezeigt:

Image Removed

getCallerInformation

Dieses Objekt führt Aufrufe der REST-API getCallerInformation in der SalesForce-Instanz aus. 

Die folgenden Parameter werden zur Verfügung gestellt:

Image Removed

Hinweis: Alle Felder, die von der Sales Force abfrage zurückgegeben werden, sind in dem GUI in der Form verfügbar: $SalesForce.<FIELD_NAME>

Speichern Zusatzinfo. und Benutzer Daten

Dieses Objekt wird verwendet, um die Daten aus der Abfrage zu speichern. Die wichtigsten Schritte sind:

  • Speichern Sie die ID des Sales Force Datensatzes unter Benutzerdaten
  • (Optional) die URL für den Zugriff auf den Datensatz unter der CRM-URL speichern

Image Removed

Ergebnisse

Im Folgenden werden die Ergebnisse bei einem eingehenden Anruf im Jtel-System gezeigt. Der CRM-Link enthält einen Link auf den SalesForce-Datensatz, und die Benutzerdaten enthalten die SalesForce-Id. 

Image Removed

Sv translation
languagede
ParameterBeispielswertBeschreibung
Servicerufnummer$servicenumberDie Servicerufnummer, die im Jtel-System angerufen wurde. Dieser Parameter wird nur benötigt, wenn der REST-Service die Servicenummer in der Abfrage verwendet.
Servicename$servicename2Der Servicename, der im Jtel-System angerufen wurde. Dieser Parameter ist nur erforderlich, wenn der REST-Service den Servicenamen in der Abfrage verwendet.
Anrufernummer$callerDie Nummer des Anrufers (Anrufer-ID). Dieser Parameter wird fast immer erforderlich sein. $caller enthält die Nummer des Anrufers im voll qualifizierten Format.
ParameterBeispielswertBeschreibung
ZusatzinformationDieser Wert wird als "Zusatzinformation" im Jtel-Client angezeigt. Alle von SalesForce zurückgegebenen Felder können hier verwendet werden.
Benutzer Daten$SalesForce.IdDieser Wert wird in den Statistiken der ACD verwendet (insbesondere wird er in der Tabelle StatisticsPartA gespeichert). Außerdem wird dieser Wert verwendet, um die Bildschirm-Pop-Routine in SalesForce vom Micro Client aus aufzurufen.
Benutzer Daten 2Optional können hier zusätzliche Werte gespeichert werden. Diese Werte werden in der Tabelle StatisticsPartA in der Jtel-Datenbank gespeichert.Benutzer Daten 3Optional können hier zusätzliche Werte gespeichert werden. Diese Werte werden in der Tabelle StatisticsPartA in der Jtel-Datenbank gespeichert.
CRM-URL$SalesForce.InstanceURL/$SalesForce.IdDiese URL wird im Miniclient und im vollständigen Client bereitgestellt, um auf den SalesForce-Datensatz zuzugreifen. Wenn diese Option aktiviert ist, wird der Datensatz im aktiven SalesForce-Fenster automatisch vom Micro-Client eingeblendet.

Status
colourRed
titleThis page is only available in english

Remarque : tous les champs renvoyés par la requête de la force de vente seront disponibles dans l'interface graphique en tant que variables sous la forme : $SalesForce.<FIELD_NAME>.

Enregistrer des informations supplémentaires et des données utilisateur

Cet objet est utilisé pour sauvegarder les données de la requête. Les étapes les plus importantes sont:

  • Sauvegarder l'ID de l'enregistrement de la force de vente dans les données de l'utilisateur
  • (Optionnellement) sauvegarder l'URL pour accéder à l'enregistrement à l'URL du CRM

Image Removed

Résultats

Ce qui suit montre les résultats d'un appel entrant dans le système jtel. Le lien CRM contient un lien vers l'enregistrement SalesForce et les données utilisateur contiennent l'ID SalesForce. 

Image Removed

Sv translation
languagefr

Status
colourRed
titleThis page is only available in english

Sv translation
languagefr

L'utilisation de l'API dans le système jtel implique l'utilisation de l'objet getCallerInformation dans une application de routage.

Un exemple d'application de routage est présenté ici :

Image Removed

getCallerInformation

Cet objet effectue des appels à l'API REST getCallerInformation dans l'instance SalesForce. 

Les paramètres suivants sont fournis :

Image Removed

ParamètreDe ReleaseExemple de ValeurDescription
Numéro de service$servicenumberLe numéro de service qui a été appelé dans le système jtel. Ce paramètre ne sera requis que si le service REST utilise le numéro de service dans la requête.Nom de service$servicename2Le nom du service qui était appelé dans le système jtel. Ce paramètre ne sera requis que si le service REST utilise le nom du service dans la requête.Numéro de l'appelant$callerLe numéro de l'appelant (caller ID). Ce paramètre sera presque toujours requis. $ caller contient le numéro de l'appelant au format pleinement qualifié.
Fonction

Status
subtlevrai
colourBlue
title3.25 / 2021-07-20 et suivantes

searchForTicket

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
subtlevrai
colourBlue
title3.25 / 2021-07-20 et suivantes

$myTicketNumber

Un paramètre définissable par l'utilisateur qui peut contenir n'importe quelle information.
UserData2

Status
subtlevrai
colourBlue
title3.25 / 2021-07-20 et suivantes

myUserData2

Un paramètre définissable par l'utilisateur qui peut contenir n'importe quelle information.
UserData3

Status
subtlevrai
colourBlue
title3.25 / 2021-07-20 et suivantes

myUserData3

Un paramètre définissable par l'utilisateur qui peut contenir n'importe quelle information.
ParamètreExemple de ValeurDescription
Informations complémentairesCette valeur sera affichée comme "Informations supplémentaires" dans le client jtel. Tous les champs renvoyés par SalesForce peuvent être utilisés ici.
Données utilisateur$SalesForce.IdCette valeur sera utilisée dans les statistiques de l'ACD (en particulier, elle sera sauvegardée dans le tableau StatisticsPartA). En outre, cette valeur est utilisée pour appeler la routine de saisie d'écran dans SalesForce à partir du Micro Client.
Données utilisateur 2Facultativement, des valeurs supplémentaires peuvent être enregistrées ici. Ces valeurs sont sauvegardées dans le tableau StatisticsPartA de la base de données jtel.Données utilisateur 3Facultativement, des valeurs supplémentaires peuvent être enregistrées ici. Ces valeurs sont sauvegardées dans le tableau StatisticsPartA de la base de données jtel.
CRM-URL$SalesForce.InstanceURL/$SalesForce.IdCette URL est fournie dans le mini-client et le client complet, pour accéder à l'enregistrement de SalesForce. Si cette option est activée, le micro-client affichera automatiquement l'enregistrement dans la fenêtre active de SalesForce.