Connecter votre trunk SIP : configuration BYOC

Réponse rapide

Pour connecter votre propre trunk SIP dans DialerBee, allez dans Console d'administration → Passerelles → Ajouter une passerelle. Le formulaire comporte six onglets. Dans Général, nommez la passerelle, choisissez le modèle de déploiement et le protocole de transport (UDP par défaut), puis saisissez l'hôte et le port de l'opérateur (5060 par défaut). Dans Authentification, choisissez le mode d'authentification (Aucune par défaut, avec Par IP, Digest Auth et Certificat TLS comme alternatives). Dans Codecs, conservez ou modifiez l'ordre par défaut PCMA, PCMU et G729 et réglez le mode DTMF, par défaut RFC 2833. Dans Média, configurez SRTP, la traversée NAT et la plage de ports RTP. Dans Routage, définissez le nombre maximal d'appels simultanés (100 par défaut), la limite de CPS (20 par défaut), la priorité, le poids et une passerelle de secours, puis cliquez sur Tester la connexion. Dans Numéro présenté, définissez la façon dont l'identité est présentée. Enregistrez, puis validez avec un vrai appel.

Avec le BYOC (Bring Your Own Carrier), la plateforme ne s'interpose jamais entre vous et votre facture opérateur. Notre explication du BYOC détaille pourquoi c'est important sur le plan commercial, et notre guide indépendant des opérateurs, guide pas à pas de configuration d'un trunk SIP , liste les paramètres à recueillir auprès de n'importe quel fournisseur. Ce guide en est le troisième volet : l'enchaînement des écrans et des champs de la console d'administration DialerBee, avec les valeurs par défaut du formulaire.

Avant de commencer

À demander à votre opérateur : l'hôte et le port de signalisation, la méthode d'authentification attendue, le nombre de canaux et la limite d'appels par seconde, les codecs acceptés, le mode DTMF et les numéros autorisés comme numéros présentés. Si vous utilisez l'authentification par IP, l'opérateur a aussi besoin des adresses de la plateforme à autoriser.

Étape 1 : ouvrir le formulaire de passerelle

Allez dans Console d'administration → Passerelles, sous-titré « Gérer les passerelles SIP, les trunks et la configuration du routage », avec quatre cartes au-dessus de la liste : Total passerelles, Opérationnelles, Appels actifs et Total CPS. Cliquez sur Ajouter une passerelle, ou Ajouter votre première passerelle sur un nouveau tenant.

La fenêtre modale comporte six onglets : Général, Authentification, Codecs, Média, Routage et Numéro présenté. Remplissez-les dans l'ordre.

Étape 2 : Général

Nom de la passerelle, un nom lisible. Nommez-la d'après l'opérateur et la région pour que le routage reste lisible.
Description, facultative et interne.
Modèle de déploiement, qui vaut par défaut A - Opérateur direct, avec B - PBX du tenant et C - Trunk tiers comme alternatives.
Protocole de transport, qui vaut par défaut UDP, avec TCP, TLS et WSS (WebSocket Secure) comme autres options. Privilégiez TLS dès que l'opérateur le prend en charge.
Hôte / adresse IP et Port. Le port par défaut est 5060.

Étape 3 : Authentification

Mode d'authentification est réglé par défaut sur Aucun, avec Par IP, Digest Auth et Certificat TLS comme autres choix. Choisissez celui que votre opérateur a demandé.

Avec l'authentification par IP, l'opérateur fait confiance au trafic provenant des adresses de la plateforme : il n'y a rien à stocker. Avec Digest Auth, vous renseignez Nom d'utilisateur d'authentification, Mot de passe d'authentification et Domaine SIP / Realm, et si l'opérateur attend un enregistrement, vous activez Enregistrement auprès du fournisseur, désactivé par défaut, et laissez Intervalle d'enregistrement (secondes) à 3600, sauf indication contraire.

Pour TLS, Version TLS propose TLS 1.2 et TLS 1.3, et Vérifier le certificat TLS est activé par défaut. Laissez-le activé. Profil SIP propose Internal, External et NAT, avec External par défaut pour un trunk tourné vers l'opérateur.

Étape 4 : Codecs

Préférences de codecs est livré dans l'ordre PCMA, PCMU, G729. Le sélecteur regroupe les codecs en Bande étroite (8 kHz), Bande large (16 kHz) et Vidéo (à venir), et les nomme comme le fait un opérateur, par exemple « G.711 A-law (PCMA) ». Convenez avec votre opérateur d'au moins un codec commun pour chaque destination que vous appelez.

Mode DTMF est réglé par défaut sur RFC 2833 (telephone-event), avec Inband (audio), SIP INFO et Détection automatique comme autres options. Une mauvaise gestion du DTMF reste invisible jusqu'à ce qu'un agent ne puisse plus naviguer dans un SVI ou qu'une désinscription par touche échoue : testez-la explicitement.

Étape 5 : Média

Cet onglet détermine si l'audio passe réellement. Les valeurs par défaut conviennent à un trunk d'opérateur public : ne les modifiez qu'avec une bonne raison. Transcodage activé, dans l'onglet Codecs, est désactivé par défaut et doit le rester, sauf si les deux côtés n'ont aucun codec en commun.

Génération de bruit de confort, Annulation d'écho et Masquage des pertes de paquets : tous activés.
Taille du tampon de gigue, un curseur de 20 ms à 200 ms par pas de 10, réglé par défaut sur 60 ms.
Mode SRTP, Disabled par défaut, avec Optional et Required. Utilisez Required avec le transport TLS pour chiffrer les médias.
Traversée NAT, None par défaut, avec STUN, TURN et ICE (STUN + TURN). Un champ Serveur STUN/TURN apparaît dès que vous en choisissez un.
Plage de ports RTP, par défaut de 16384 à 32768. Ce sont les ports que l'opérateur doit pouvoir joindre.
Media Bypass / Direct Media, désactivé par défaut. Le laisser désactivé maintient les médias sur la plateforme, ce dont dépend l'enregistrement.
Intervalle de keepalive (s) 30, Session Timer (s) 1800, et un champ facultatif Proxy sortant.

Étape 6 : Routage et capacité

Dimensionnez le trunk sur votre pic, pas sur votre moyenne. Une campagne prédictive lance plusieurs appels pour chaque agent libre : c'est donc la simultanéité en début d'heure qui compte.

Nombre maximal d'appels simultanés, par défaut 100.
Limite CPS (appels/seconde), 20 par défaut. Réglez-la au niveau de la limite de l'opérateur ou en dessous, car un dialer émet ses plus fortes rafales au démarrage d'une campagne et à la connexion d'une équipe.
Priorité (1 = la plus élevée), 1 par défaut, valeurs acceptées de 1 à 10.
Poids (1-100), 100 par défaut, plage de 1 à 100 ; il répartit le trafic entre passerelles de même priorité.
Passerelle de secours, vide par défaut : choisissez ici le trunk de secours.
Intervalle de contrôle d'état (s) 30, Nombre max. de tentatives avant bascule 3, Délai INVITE (s) 60.

Cliquez ensuite sur Tester la connexion dans le même onglet, avant d'affecter la moindre campagne au trunk.

Étape 7 : Numéro présenté

Type de numéro présenté est réglé par défaut sur Détection automatique, avec Remote-Party-ID (RPID), P-Asserted-Identity (PAI) et l'en-tête From comme autres options. Votre opérateur vous dira quel en-tête il lit. Mode de confidentialité est réglé par défaut sur « Aucun - numéro présenté visible », avec un mode restreint et un mode entièrement anonyme. Remplacement du numéro présenté par défaut définit un numéro de secours pour cette passerelle.

Chaque passerelle porte aussi ses propres DID et numéros présentés. Dépliez la ligne de la passerelle jusqu'à DID et numéros présentés et cliquez sur Ajouter un DID pour ouvrir la boîte de dialogue Ajouter un DID / numéro présenté , qui demande le numéro DID et une Juridiction parmi UAE (TDRA), KSA (CITC), Egypt (NTRA), Jordan (TRC), Global ou Other, et attribue à chaque numéro une action Vérifier . Les numéros doivent aussi être autorisés sur le compte opérateur, car les opérateurs rejettent les appels qui présentent un numéro non provisionné sur le trunk.

Valeurs par défaut et limites

Champ	Onglet	Valeur par défaut	Valeurs acceptées
Modèle de déploiement	Général	A - Opérateur direct	A, B - PBX du tenant, C - Trunk tiers
Protocole de transport	Général	UDP	UDP, TCP, TLS, WSS
Mode d'authentification	Authentification	Aucun	Aucune, Par IP, Digest Auth, Certificat TLS
Préférences de codecs	Codecs	PCMA, PCMU, G729	liste de codecs bande étroite et bande large
Mode DTMF	Codecs	RFC 2833 (telephone-event)	RFC 2833, Inband, SIP INFO, Détection automatique
Taille du tampon de gigue	Média	60 ms	20 à 200 ms, par pas de 10
Mode SRTP	Média	Disabled	Disabled, Optional, Required
Nombre maximal d'appels simultanés	Routage	100	comme indiqué à l'écran
Limite CPS	Routage	20	comme indiqué à l'écran
Priorité / Poids	Routage	1 / 100	1 à 10 / 1 à 100
Type de numéro présenté	Numéro présenté	Détection automatique	Détection automatique, RPID, PAI, en-tête From

Vérifier que tout fonctionne

Les colonnes de la liste des passerelles sont Nom, Hôte / IP, Protocole, Modèle, Statut, Appels, CPS, MOS et Actions, et les valeurs de statut sont Non vérifiée, Opérationnelle, Dégradée et Hors service. Une métrique non mesurée affiche un tiret plutôt qu'un zéro : un tiret n'est donc pas une panne.

Enregistrez la passerelle et vérifiez que le statut passe de Non vérifiée to Opérationnelle.
Dépliez la ligne et lisez le panneau Indicateurs de qualité : ASR, ACD, MOS, Latence, Gigue, Perte de paquets et Actifs.
Passez un appel test sortant, vérifiez qu'il aboutit et que l'audio passe dans les deux sens. Un audio unidirectionnel vient presque toujours de la plage de ports RTP ou d'un pare-feu, pas du trunk.
Vérifiez que le numéro affiché est bien celui que vous avez provisionné.
Si vous enregistrez les appels, générez le rapport enregistrements d'appels et réécoutez un enregistrement de bout en bout, avant le premier litige plutôt qu'après.
Désactivez la passerelle principale et vérifiez que le trafic est redirigé vers la passerelle de secours.

Dépannage

Chaque appel échoue immédiatement. Problème d'authentification. Comparez le mode avec la configuration de l'opérateur, et vérifiez qu'il a autorisé les adresses de la plateforme si vous avez choisi Par IP.
L'appel est établi mais il n'y a pas d'audio, ou l'audio ne passe que dans un sens. Le RTP ne passe pas. Vérifiez que la plage de ports RTP est ouverte dans les deux sens et que la traversée NAT correspond à votre réseau.
Appels rejetés avec une erreur de numéro présenté. Le numéro présenté n'est pas provisionné sur le trunk de l'opérateur. Ajoutez-le chez l'opérateur, ainsi que dans DID et numéros présentés sur la passerelle.
Une vague d'échecs au démarrage de la campagne. Vous dépassez la limite d'appels par seconde de l'opérateur. Abaissez la limite CPS ou demandez à l'opérateur de relever la sienne.
Les enregistrements sont muets ou manquants. Media Bypass / Direct Media est activé : les médias n'atteignent donc jamais la branche d'enregistrement.

Questions fréquentes

Où ajouter un trunk SIP dans DialerBee ?

Console d'administration, puis Passerelles, puis Ajouter une passerelle. Le formulaire comporte six onglets : Général, Authentification, Codecs, Média, Routage et Numéro présenté. Un bouton Tester la connexion se trouve dans l'onglet Routage.

Quels transport et port le formulaire de passerelle utilise-t-il par défaut ?

Le protocole de transport est UDP par défaut, avec TCP, TLS et WSS disponibles, et le port est 5060 par défaut. Privilégiez TLS lorsque votre opérateur le prend en charge, et associez-le à SRTP réglé sur Required si vous chiffrez les médias.

Quel mode d'authentification dois-je choisir ?

Celui que votre opérateur a demandé. Le champ vaut Aucune par défaut et propose Par IP, Digest Auth et Certificat TLS. Par IP ne nécessite aucun identifiant stocké ; Digest Auth nécessite un nom d'utilisateur, un mot de passe et un realm SIP, ainsi qu'un enregistrement si l'opérateur en attend un.

Quels sont les codecs par défaut et le mode DTMF ?

Les préférences de codecs sont livrées dans l'ordre PCMA, PCMU et G729, et le mode DTMF est réglé par défaut sur RFC 2833 avec la charge utile telephone-event. Vérifiez les deux par rapport aux destinations que vous appelez réellement, et pas seulement par rapport à l'opérateur en général.

Comment dimensionner le trunk pour la numérotation prédictive ?

Réglez le nombre maximal d'appels simultanés sur votre pic de simultanéité plutôt que sur votre moyenne, et la limite CPS au niveau de la limite d'appels par seconde fixée par votre opérateur, ou en dessous. Les valeurs par défaut du formulaire sont 100 appels simultanés et 20 appels par seconde.

Comment fonctionne la bascule entre trunks ?

Choisissez une passerelle de secours dans l'onglet Routage et réglez l'intervalle de contrôle d'état, le nombre max. de tentatives avant bascule et le délai INVITE sur des valeurs convenues avec votre opérateur. Puis vérifiez : désactivez la passerelle principale et assurez-vous que les appels passent sur la passerelle de secours.

Comment connecter votre trunk SIP (configuration BYOC)