Versions Compared

Old Version 14

changes.mady.by.user jtel Support

Saved on

compared with

New Version 15

changes.mady.by.user jtel Support

Saved on

Key

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

Enable SAP in the jtel Portal

To enable SAP in the jtel portal, connect to the portal as sysadmin and check if the resources "portal.Acd.AgentHome.SAP.Enable.MiniClient" and "portal.UserData.Clients.SAP.Visible" are allowed.

Make sure the SAP resource is executable in Client Administrators and/or Client Users.

Client Master Data

SAP Settings

The following settings are available in the Client Master Data screen in the jtel System, which control the way SAP is integrated with the jtel ACD.

These settings must be setup and correct, if the integration is to function correctly.

SettingExample ValueDescription
Authorization Token

VXXXXXYYYYZZZZZxxxxaaaabbbbQ=

The basic authorization token for the SAP REST API - this is the base64 encoding of Username:Password.

This is required for all REST queries made to the SAP interface.

onClickToDial

This section controls how outbound calls are made from the SAP system using the jtel ACD.

If activated, the jtel system will query SAP by REST before the outbound call is made.

This can be used to change the signalled number (the used service number) when the jtel system makes the outbound call.

SettingExample ValueDescription
REST URL

https://sap.crm.ondemand.com/sap/c4c/odata/v1/c4codataapi/IndividualCustomerCollection

The SAP REST API URL.
REST Parameters

Example1:

$filter=CustomerID eq '$SAPBusinessPartnerID'
$expand=IndividualCustomerSalesData

Example2:

$filter=NormalisedPhone eq '+$SAPPhoneNumber'
$expand=IndividualCustomerSalesData

The SAP REST API Parameters - must follow this format:

  • paramName=paramValue.
  • Parameters are separated by Carriage return.
  • Variables start with a dollar sign '$' e.g. $SAPBusinessPartnerID, $SAPPhoneNumber.
JSON ResultdistributionChannelCodeText=d.results[0].IndividualCustomerSalesData[0].DistributionChannelCodeText
countryCode=d.results[0].CountryCode

This specifies how the jtel System parses the JSON result received from SAP.

variableNameToParse=jsonPathToVariable

Multiple variables are separated by Carriage return.

The two main variables required, are distributionChannelCodeText and countryCode. These two values are concatenated, and used to search the jtel system for the service number to use when the outbound call is made.

jtel REST API onClickToDial active
If this option is selected, the onClickToDial REST endpoint will be queried before a click to dial request is performed.

getCallerInformation

This configuration is used by the IVR object SAP getCallerInformation

SettingExample ValueDescription
REST URL

https://sap.crm.ondemand.com/sap/c4c/odata/v1/c4codataapi/IndividualCustomerCollection

The SAP REST API URL.
REST Parameters Function CallerNumber$filter=NormalisedPhone eq '+%CallerNumber%'
$expand=IndividualCustomerSalesData

The SAP REST API Parameters if the CallerNumber function is chosen as a function in the IVR Object:

The variable used here is %CallerNumber%

REST Parameters Function CustomerID$filter=CustomerID eq '%CustomerID%'
$expand=IndividualCustomerSalesData

The SAP REST API Parameters if the CustomerID function is chosen as a function in the IVR Object:

The variable used here is %CustomerID%

The following screenshot shows an example configuration:


Sv translation
languagefr

Activer le SAP dans le portail Jtel

Pour activer le SAP dans le portail Jtel, connectez-vous au portail en tant qu'administrateur système et vérifiez si les ressources "portal.Acd.AgentHome.SAP.Enable.MiniClient" et "portal.UserData.Clients.SAP.Visible" sont autorisés.

Paramètres SAP

Les paramètres suivants sont disponibles dans l'écran Données de base du client dans le système Jtel, qui contrôlent la façon dont SAP est intégré avec l'ACD Jtel.

Ces paramètres doivent être configurés et corrects pour que l'intégration fonctionne correctement.


ParamètresExemple de ValeurDescription
Jeton d'autorisation

VXNlcm5hbWU6UGFzc3dvcmQ=

Le jeton d'autorisation de base pour l'API SAP REST qui est le codage base64 de Nom d'utilisateur:Mot de passe .

Deux sections principales sont disponibles : onClickToDial pour l'ACD et getCallerInformation pour l'objet IVR.

onClickToDial

ParamètresExemple de ValeurDescription
URL REST

https://sap.crm.ondemand.com/sap/c4c/odata/v1/c4codataapi/IndividualCustomerCollection

L'URL de l'API SAP REST.
Paramètres REST $filter=CustomerID eq '$SAPBusinessPartnerID'
$expand=IndividualCustomerSalesData

Les paramètres de l'API SAP REST - doivent suivre ce format :

  • paramName=paramValue.
  • Les paramètres sont séparés par retour chariot.
  • La variable commence par le signe dollar '$' e.g. $SAPBusinessPartnerID.
Résultat JSONdistributionChannelCodeText=d.results[0].IndividualCustomerSalesData[0].DistributionChannelCodeText
countryCode=d.results[0].CountryCode

Cela spécifiera comment analyser le résultat SAP JSON.

variableNameToParse=jsonPathToVariable

Les variables multiples sont séparées par le Carriage return.

jtel API REST onClickToDial active
Si cette option est sélectionnée, le terminal onClickToDial REST sera interrogé avant qu'une demande de "click to dial" ne soit effectuée.

getCallerInformation

ParamètresExemple de ValeurDescription
URL REST

https://sap.crm.ondemand.com/sap/c4c/odata/v1/c4codataapi/IndividualCustomerCollection

L'URL de l'API SAP REST.
Paramètres REST Fonction CallerNumber$filter=NormalisedPhone eq '+%CallerNumber%'
$expand=IndividualCustomerSalesData

Les paramètres de l'API SAP REST si CallerNumber est choisi comme fonction dans l'objet IVR:

La variable utilisée ici est % CallerNumber%

Paramètres REST Fonction CustomerID$filter=CustomerID eq '%CustomerID%'
$expand=IndividualCustomerSalesData

Paramètres de l'API SAP REST si CustomerID est choisi comme fonction dans l'objet IVR:

La variable utilisée ici est % CustomerID%


La capture d'écran suivante montre un exemple de configuration :


Sv translation
languagede

Status
colourRed
titleThis page is only available in English