Background

This guide describes one way of connecting the jtel ACD to the Swyx PBX system and routing calls to the jtel System.

The following principle applies to connecting the jtel System to the Swyx PBX:

• Incoming calls to the jtel System will be routed by SIP with RTP to the jtel ACD on Leg 1 by the PBX
• The jtel ACD will make outgoing calls to agents via SIP with RTP back down the same route back to the PBX on Leg 2
• For outbound, Leg 1 is to the agent first and Leg 2 to the destination.

The jtel System hence operates as a back to back user agent, the Swyx PBX is not aware that Leg 2 calls are associated with Leg 1.

Scenario

The following configuration scenario was performed after the following steps had been performed on the Swyx System:

• Install Swyx
• Get System up and running
• Configure and test internal users
  • Check telephony between users
• Configure a trunk to the outside world
  • Check outgoing calls from users
• Configure routing to internal users from outside
  • Check incoming calls via the trunk to internal users

After these steps, a basic PBX is configured with some users, internal calls working, and functionality to call inbound or outbound to / from the outside world.

First step: Add Trunk Group for jtel ACD

Add new trunk group

• Right mouse click

Go to next step

Specify a trunk group name and a description

Trunk Group Type

• It is important to specify the trunk group type: 
  • trunk Group type : SIP 
  • profile: <Customized SIP>

SIP Settings

• Disable sip registration and go to next step

SIP Settings

• The proxy address is the IP Address of the jtel System telephony server
• Specify port 5060 as standard (unless this has been changed deliberately on the jtel System)
• For the realm specify the ip address
• DTMF Mode = RFC 2833 Event

Stun Server Settings

• Disable STUN

Encryption Settings

• choose udp as a transport protocol 

Definition of Routing

• Choose "Do not create initial Routing Records"

Location Profile

• Application location profile : keep it to Default Location
  

Second step: Add Trunk for jtel ACD

Add new trunk

Go to next step

Trunk Name

• Choose a trunk name and a description

Trunk Group Selection

• choose the the appropriate trunk group created above

SIP Trunk Provider / User Data

• No special settings required - go to the next step 

Subscriber Numbers

• Set all fields empty 

SIP URI

• Set all fields empty 

Codecs

• Leave as default

Number of Channels

• Set number of simultaneous call to 4 (just for testing), or to the number of licensed channels (see your jtel ACD configuration - number of licensed SIP / RTP channels).

Computer Name

• set the name of the computer where you run swyx

Trunk - Trunk Group Settings

• after creating the trunk, edit the trunk
• specify the calling party and called party numbers as "Canonical with plus" for both inbound and outbound calls

Trunk - Rights

• Make sure that you specify "No call restrictions" in the calling right, if you want the jtel System to be able to make calls to users or destinations outside of the PBX

Third step: Modify the routing table

This is where you define which calls should be routed to the jtel ACD. In this case, we are specifying calls from an outside number, +49198112233* (* is a wildcard).

Add a new routing record

• Right mouse click

Trunk Group Selection

• Specify the Trunk Group for which the rule should be applied

Routing

• Specify a destination number - i.e. numbers which should be routed to this trunk
• Critical point: we need to specify a higher priority for the rule (e.g. 600) otherwise default routing rules in the PBX may apply. 
• Here it is important, that you know your Swyx installation and how calls are routed.

Fourth Step: Create a trunk group in the jtel System

Trunk Group

• critical point: Swyx listens for incoming request on port 65002
• create a trunk group with the following configuration :
  
  

Trunk

• Assign the trunk for the relevant machine ID to this trunk. 
• If it does not exist, create it first.

For debugging purposes

The usual call logging applies from the jtel side. It may be necessary to run a wireshark trace to see if calls are being routed to the jtel system at all.

You can access the swyx trace logs via: C:\ProgramData\Swyx\Traces on the Swyx machine which may give insight as to why things are not working.

Status
colour Red title This page is only available in English

Informations générales

Ce guide décrit une façon de connecter le ACD de jtel au système PBX Swyx et de router les appels vers le système jtel.

Le principe suivant s'applique à la connexion du système jtel au Swyx PBX :

• Les appels entrants vers le système jtel seront routé par SIP avec RTP vers l'ACD jtel sur le tronçon 1 par le PBX
• L'ACD de jtel effectuera les appels sortants vers les agents via SIP avec RTP par la même route pour revenir au PBX sur le tronçon 2
• Pour l'aller, l'étape 1 est destinée à l'agent en premier et l'étape 2 à la destination.

Le système jtel fonctionne donc comme un agent utilisateur dos à dos, le Swyx PBX n'est pas au courant que les appels de la branche 2 sont associés à la branche 1.

Scénario

Le scénario de configuration suivant a été réalisé après que les étapes suivantes aient été effectuées sur le système Swyx :

• Installer Swyx
• Mettre le système en place et le faire fonctionner
• Configurer et tester les utilisateurs internes
  • Vérifier la téléphonie entre utilisateurs
• Configurer un tronc vers le monde extérieur
  • Vérifier les appels sortants des utilisateurs
• Configurer le routage vers les utilisateurs internes depuis l'extérieur
  • Vérifier les appels entrants via le tronc aux utilisateurs internes

Après ces étapes, un PBX de base est configuré avec quelques utilisateurs, les appels internes fonctionnent, et la fonctionnalité pour appeler en entrée ou en sortie vers / depuis le monde extérieur.

Première étape : Ajouter le groupe Tronc pour jtel ACD

Ajouter un nouveau groupe de troncsNouveau Tronc

• Clic droit de la souris

Passer à l'étape suivante

Préciser un nom de groupe de troncs et une description

Type de groupe de troncs

• Il est important de préciser le type de groupe de troncs : 
  • tronc Type de groupe : SIP 
  • profil: <Customized SIP>

Paramètres SIP

• Désactiver l'enregistrement de sip et passer à l'étape suivante

Paramètres SIP

• L'adresse proxy est l'adresse IP du serveur de téléphonie du système jtel
• Spécifier le port 5060 comme standard (à moins que cela n'ait été délibérément modifié sur le système jtel)
• Pour le domaine, précisez l'adresse IP
• DTMF Mode = RFC 2833 Event

Paramètres du serveur Stun

• Désactiver STUN

Paramètres de cryptage

• choisir l'udp comme protocole de transport 

Définition du routage

• Choisissez "Ne pas créer de fiches de routage initiales".

Profil de localisation

• Profil de localisation de la demande : conserver le profil de localisation par défaut
  

Deuxième étape : Ajouter un tronc pour jtel ACD

Ajouter un nouveau tronc

Passer à l'étape suivante

Nom du tronc

• Choose a trunk name and a description

Sélection des groupes de troncs

• choisissez le groupe de troncs approprié créé ci-dessus

Fournisseur de lignes SIP / Données utilisateur

• Aucun réglage particulier n'est nécessaire - passez à l'étape suivante 

Numéros d'abonnés

• Mettre tous les champs vides 

SIP URI

• Mettre tous les champs vides 

Codecs

• Laisser par défaut

Nombre de canaux

• Réglez le nombre d'appels simultanés sur 4 (juste pour tester), ou sur le nombre de canaux sous licence (voir votre configuration ACD jtel - nombre de canaux SIP / RTP sous licence).

Nom de l'ordinateur

• définir le nom de l'ordinateur sur lequel vous utilisez swyx

Trunc - Paramètres du Groupe de tronc

• après avoir créé le tronc, modifier le tronc
• spécifier les numéros de l'appelant et de l'appelé comme "Canonical avec plus" pour les appels entrants et sortants

Tronc - Droits

• Assurez-vous que vous spécifiez "Pas de restrictions d'appel" dans le droit d'appel, si vous voulez que le système jtel puisse passer des appels vers des utilisateurs ou des destinations en dehors du PBX

Troisième étape : Modifier le tableau de routage

C'est là que vous définissez quels appels doivent être routés vers le ACD de jtel. Dans ce cas, nous spécifions les appels provenant d'un numéro extérieur, le +49198112233* (* est un caractère de remplacement).

Ajouter une nouvelle fiche de routage

• Clic droit de la souris

Sélection des groupes de troncs

• Préciser le groupe de tronc pour lequel la règle doit être appliquée

Routage

• Indiquer un numéro de destination - c'est-à-dire les numéros qui doivent être routés vers ce tronc
• Point critique : nous devons spécifier une priorité plus élevée pour la règle (par exemple 600), sinon les règles de routage par défaut dans le PBX peuvent s'appliquer. 
• Il est important que vous connaissiez votre installation Swyx et la façon dont les appels sont routés.

Quatrième étape : Créer un groupe de troncs dans le système jtel

Groupe de tronc

• point critique : Swyx écoute les demandes entrantes sur le port 65002
• créer un groupe de troncs avec la configuration suivante :
  
  

Trunc

• Attribuez le tronc l'ID de la machine concernée à ce tronc. 
• S'il n'existe pas, créez-le d'abord.

À des fins de débogage

L'enregistrement habituel des appels s'applique du côté de jtel. Il peut être nécessaire d'effectuer un traçage de type "wirehark" pour vérifier si les appels sont bien routés vers le système de jtel.

Vous pouvez accéder aux journaux de trace swyx via : C:\ProgramData\Swyx\Traces sur la machine Swyx, ce qui peut donner un aperçu des raisons pour lesquelles les choses ne fonctionnent pas.