Versions Compared

Key

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

The jtel MiniClient EXE provides APIs which can be used to integrate external systems.

These cover the following use-cases:

  • Automatically calling a REST service from the mini-client when an incoming call is received
  • Automatically calling a windows executable (.EXE) when an incoming call is received
  • Making an outbound call by calling the mini client .EXE using parameters

See also Mini Client MiniClient Settings for all required settings.

Automatic REST Call

An automatic REST call can be made by the Mini-Client when an incoming call is received. 

To use this feature, the CRM URL must be passed via the standard ACD features (CRM URL in the ACD Group, or via an IVR Application, using the IVR Object "Save additional info and user data".

The following must be configured in the MiniClient configuration:

  • AutomaticRESTCRMUrl - Set to True
  • CurlRESTCommand - if necessary, alter this command as required. The parameters which are influenced by the ACD, i.e. the $crmurl variable, must be passed by GET (i.e. in the URL). 
  • Additional parameters can be added after $crmurl as necessary, or passed as additional POST parameters (a lot, but not all REST services will accept a combination of GET and POST parameters).

Automatic .EXE Call

Status
colourGreen
titleMini Client Release 3.31 or higher

The following parameters must be set:

  • AutomaticEXECallCommand - Set this to the name of the executable to be called.

  • AutomaticEXECallParameters - Set these to the parameters to be passed to the executable. The following variables are available:

    • $ANumber - the called number
    • $GroupName - the name of the ACD group
    • $CRMLink - the complete CRM link provided by the ACD
    • $ServiceNumber - the service number called
    • $ServiceName - the name of the service number called
    • $CallID - the jtel CallID (currently not supported, will be supported in a future release)
    • $UsersUID - the ID of the User logged into the jtel system

Outbound Call - Start Mini-Client with Dial Parameter

To request the MiniClient to dial a number, call it as follows from the command line. 

Translations Ignore


Code Block
AcdAgentMiniClient.exe --dial <number>


Note: an instance of the mini client must already be running for a logged in ACD user.

Sv translation
languagede

Der jtel MiniClient EXE bietet APIs, die zur Integration externer Systeme verwendet werden können.

Diese decken die folgenden Anwendungsfälle ab:

  • Automatischer Aufruf eines REST-Dienstes vom Mini-Client aus, wenn ein eingehender Anruf empfangen wird
  • Automatischer Aufruf einer ausführbaren Windows-Datei (.EXE), wenn ein eingehender Anruf empfangen wird
  • Outbound Anruf durch Aufruf des Mini-Clients .EXE mit Parametern

Sehen Sie auch Mini Client Einstellungen für alle erforderlichen Einstellungen.

Automatischer REST-Anruf

Ein automatischer REST-Anruf kann durch den Mini-Client erfolgen, wenn ein eingehender Anruf empfangen wird. 

Um diese Funktion nutzen zu können, muss die CRM-URL über die Standard-ACD-Funktionen (CRM-URL in der ACD-Gruppe) oder über eine IVR-Anwendung mit dem IVR-Objekt "Speichern Zusatzinfo. und Benutzerdaten" übergeben werden.

In der MiniClient-Konfiguration muss Folgendes konfiguriert werden:

  • AutomaticRESTCRMUrl - Auf True setzen
  • CurlRESTCommand - Falls erforderlich, ändern Sie diesen Befehl nach Bedarf. Die Parameter, die von der ACD beeinflusst werden, d.h. die Variable $crmurl, müssen per GET (d.h. in der URL) übergeben werden. 
  • Zusätzliche Parameter können bei Bedarf nach $crmurl hinzugefügt oder als zusätzliche POST-Parameter übergeben werden (eine Menge, aber nicht alle REST-Dienste akzeptieren eine Kombination von GET- und POST-Parametern).

Automatischer .EXE Call

Status
colourGreen
titleMini Client Release 3.31 or higher

Die folgenden Parameter müssen eingestellt werden:

  • AutomaticEXECallCommand - Set this to the name of the executable to be called.

  • AutomaticEXECallParameters - Set these to the parameters to be passed to the executable. The following variables are available:

    • $ANumber - the called number
    • $GroupName - the name of the ACD group
    • $CRMLink - the complete CRM link provided by the ACD
    • $ServiceNumber - the service number called
    • $ServiceName - the name of the service number called
    • $CallID - the jtel CallID (currently not supported, will be supported in a future release)
    • $UsersUID - the ID of the User logged into the jtel system

Abgehend Telefonieren - Aufruf vom Mini-Client mit Dial Parameter

Um mit dem MiniClient einen Anruf zu tätigen, rufen Sie den Mini-Client mit folgende Kommandozeile auf.

Translations Ignore


Code Block
AcdAgentMiniClient.exe --
Anrufen <Nummer>
dial <number>


Voraussetzung ist, für den angemeldeten ACD-Benutzer läuft bereits eine Instanz vom Mini-Client.

Sv translation
languagefr

Le MiniClient EXE de jtel fournit des API qui peuvent être utilisées pour intégrer des systèmes externes.

Ceux-ci couvrent les cas d'utilisation suivants :

  • Appeler automatiquement un service REST depuis le mini-client lorsqu'un appel entrant est reçu
  • Appel automatique d'un exécutable Windows (.EXE) lorsqu'un appel entrant est reçu
  • Effectuer un appel sortant en appelant le mini-client .EXE à l'aide de paramètres

Voir aussi Mini Client MiniClient Settings pour tous les réglages requis.

Appel automatique REST

Un appel REST automatique peut être effectué par le mini-client lorsqu'un appel entrant est reçu. 

Pour utiliser cette fonctionnalité, l'URL du CRM doit être transmise via les fonctionnalités standard de l'ACD (URL CRM dans le groupe ACD, ou via une application IVR, en utilisant l'objet IVR "Enregistrer des informations supplémentaires et des données utilisateur".

Les éléments suivants doivent être configurés dans la configuration du MiniClient :

  • AutomaticRESTCRMUrl - Réglé sur Vrai
  • CurlRESTCommand - si nécessaire, modifiez cette commande selon les besoins. Les paramètres qui sont influencés par l'ACD, c'est-à-dire la variable $crmurl, doivent être passés par GET (c'est-à-dire dans l'URL). 
  • Des paramètres supplémentaires peuvent être ajoutés après $crmurl si nécessaire, ou passés comme paramètres POST supplémentaires (beaucoup, mais pas tous les services REST acceptent une combinaison de paramètres GET et POST)

Automatic appel .EXE

Status
colourGreen
titleMini Client Release 3,31 ou supérieur

Les paramètres suivants doivent être définis :

  • AutomaticEXECallCommand - Définissez ce paramètre sur le nom de l'exécutable à appeler.

  • AutomaticEXECallParameters - Définissez les paramètres à transmettre à l'exécutable. Les variables suivantes sont disponibles :

    • $ANumber - le numéro appelé
    • $GroupName - le nom du groupe ACD
    • $CRMLink - le lien CRM complet fourni par l'ACD
    • $ServiceNumber - le numéro de service appelé
    • $ServiceName - le nom du numéro de service appelé
    • $CallID - le CallID de jtel (actuellement non supporté, sera supporté dans une prochaine version)
    • $UsersUID - l'ID de l'utilisateur connecté au système jtel

Appel sortant en utilisant la numérotation

Pour demander au MiniClient de composer un numéro, appelez-le comme suit (en supposant qu'une instance est déjà en cours d'exécution pour un utilisateur ACD connecté) :

Translations Ignore

AcdAgentMiniClient.exe --dial <number>