Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Content imported from a Scroll Translations translation file.
Sv translation
languageen

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.

Warning
titleCaution

This is not intended to be an expert guide on configuring the Swyx PBX system or a recommendation that "this is the one and only way" of doing things.

You should know your Swyx PBX well, and any configuration therein which is relevant.

You should also be familiar with the procedures involved here, particularly in the Swyx PBX.

You should also be capable of identifying steps which may be critical to your PBX installation, it's configuration or any routing involved, before you proceed.

The scenario below may need modifying to suit your needs!

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.



Sv translation
languagede

Status
colourRed
titleThis page is only available in English

Sv translation
languagefr

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.

Warning
titleAttention

Il ne s'agit pas d'un guide d'expert sur la configuration du système Swyx PBX ni d'une recommandation selon laquelle "c'est la seule et unique façon" de faire les choses.

Vous devez bien connaître votre Swyx PBX, et toute configuration qui s'y rapporte.

Vous devez également vous familiariser avec les procédures impliquées ici, en particulier dans le Swyx PBX.

Vous devez également être capable d'identifier les étapes qui peuvent être critiques pour l'installation de votre PBX, sa configuration ou tout routage impliqué, avant de procéder.

Le scénario ci-dessous devra peut-être être modifié en fonction de vos besoins !

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

Ajouter un nouveau groupe de troncsNouveau Tronc

  • Clic droit de la souris

Image Added

Passer à l'étape suivante

Image Added

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

Image Added

Type de groupe de troncs

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

Image Added

Paramètres SIP

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

Image Added

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

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.

Warning
titleCaution

This is not intended to be an expert guide on configuring the Swyx PBX system or a recommendation that "this is the one and only way" of doing things.

You should know your Swyx PBX well, and any configuration therein which is relevant.

You should also be familiar with the procedures involved here, particularly in the Swyx PBX.

You should also be capable of identifying steps which may be critical to your PBX installation, it's configuration or any routing involved, before you proceed.

The scenario below may need modifying to suit your needs!

First step: Add Trunk Group for jtel ACD

Add new trunk group

  • Right mouse click

Image Removed

Go to next step

Image Removed

Specify a trunk group name and a description

Image Removed

Trunk Group Type

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

Image Removed

SIP Settings

  • Disable sip registration and go to next step

Image Removed

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

Paramètres du serveur Stun

Server Settings

  • Disable Désactiver STUN

Encryption Settings

  • choose udp as a transport protocol 

Image Removed

Definition of Routing

  • Choose "Do not create initial Routing Records"

Image Removed

Location Profile

  • Application location profile : keep it to Default Location

Image Removed

Second step: Add Trunk for jtel ACD

Add new trunk

Image Removed

Go to next step

Image Removed

Paramètres de cryptage

  • choisir l'udp comme protocole de transport 

Image Added

Définition du routage

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

Image Added

Profil de localisation

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

Image Added


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

Ajouter un nouveau tronc

Image Added

Passer à l'étape suivante

Image Added

Nom du tronc

Trunk Name

  • Choose a trunk name and a description

Trunk Group Selection

Sélection des groupes de troncs

  • choisissez le groupe de troncs approprié créé ci-dessuschoose the the appropriate trunk group created above

Fournisseur de lignes SIP

Trunk Provider

/

User Data
  • No special settings required - go to the next step 

Image Removed

Subscriber Numbers

Données utilisateur

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

Image Added

Numéros d'abonnés

  • Mettre tous les champs vides Set all fields empty 

SIP URI

  • Set all fields empty Mettre tous les champs vides 

Codecs

  • Leave as defaultLaisser par défaut

Number of Channels

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 licenceSet 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

Nom de l'ordinateur

  • définir le nom de l'ordinateur sur lequel vous utilisez 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

Image Removed

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

Image Removed

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

Image Removed

Trunk Group Selection

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

Image Removed

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.

Image Removed

Fourth Step: Create a trunk group in the jtel System

Trunk Group

  • critical point: Swyx listens for incoming request on port 65002
  • 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

    Image Added

    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

    Image Added

    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

    Image Added

    Sélection des groupes de troncs

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

    Image Added

    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.

    Image Added

    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 :

    Image Added

    Trunc

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

    Image Added

    À 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

    create a trunk group with the following configuration :

    Image Removed

    Trunk

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

    Image Removed

    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 workingsur la machine Swyx, ce qui peut donner un aperçu des raisons pour lesquelles les choses ne fonctionnent pas.