Trunks SIP

La page Trunks SIP (/admin/trunks) gère les comptes opérateur SIP d'un client : connexion à un fournisseur, identifiants, numéros (DDI), état d'enregistrement et options de routage avancées.

Accès réservé à l'administrateur système. Les actions dépendent du client sélectionné en haut de l'administration ; sans client, la page affiche « Sélectionnez un client ».

En-tête et rappel important

L'en-tête montre le titre, un sous-titre « N trunks · nom du client » et le bouton Connecter un opérateur.

Avertissement permanent (bandeau orange) : « N'oublie pas : un trunk ne sert à rien tant qu'il n'est pas assigné à au moins une route sortante. Les nouveaux clients ont 2 routes par défaut (International, National) — ouvre-les et assigne ton trunk. » Un lien Routes sortantes mène directement à Routes sortantes.

Liste des trunks

Chaque trunk apparaît en ligne avec :

• son libellé ;
• le modèle d'opérateur (template_id) ;
• une pastille DDI (numéro principal) au format DDI <numéro> ;
• une pastille d'état d'enregistrement SIP (voir ci-dessous) ;
• des actions au survol.

Pastilles d'état d'enregistrement

Pastille	Signification
Enregistré (vert)	Le trunk est enregistré auprès de l'opérateur.
Refusé (rouge)	L'opérateur a rejeté l'enregistrement (identifiants ?).
Non enregistré (orange)	Pas encore enregistré.
Inconnu / valeur brute	État non déterminé (— si aucune information).

Actions par trunk (au survol)

Action	Icône	Effet
Retester l'enregistrement SIP	flèches circulaires	Relance la vérification de l'état d'enregistrement.
Ré-appliquer le modèle	clé à molette	Régénère/réapplique les surcharges du modèle d'opérateur.
Éditer	crayon	Ouvre la modale de modification.
Supprimer	corbeille	Ouvre la confirmation de suppression.

État vide

Si aucun trunk n'existe : icône de câble + message « Aucun trunk configuré ».

Erreurs de chargement

Un encart rouge liste les chargements en échec : modèles de trunks, trunks, état SIP live, transports SIP, aide PJSIP (chacun avec le détail de l'erreur).

Assistant « Connecter un opérateur »

Le bouton Connecter un opérateur ouvre un assistant en 2 étapes.

Étape 1 — Choisir l'opérateur

Grille de cartes, une par modèle d'opérateur disponible : nom affiché, badge pays, et description (toute mention de la plateforme technique sous-jacente y est masquée et remplacée par « plateforme »). Cliquer sur une carte sélectionne le modèle et passe à l'étape 2. Le bouton Annuler ferme l'assistant.

Étape 2 — Vos identifiants

Un badge rappelle le modèle choisi. Le formulaire est organisé en deux onglets : Réglages essentiels et Paramètres avancés.

Champs communs (essentiels)

Champ	Type	Obligatoire	Détails
Nom du trunk (interne)	texte	Oui	Libellé interne, ex. « MaxiConnect prod ».
Numéros (DDI) (DDI principal)	texte	Oui	DDI principal, ex. 0315210374.
DDIs supplémentaires (séparés par virgule)	texte	Non	Ex. 0315210375, 0315210376. Dédoublonnés avec le DDI principal.

Le nom et le numéro principal sont obligatoires : sinon « Le nom et le numéro principal sont obligatoires. »

Identifiants de l'opérateur

Sous les champs communs, l'assistant affiche les champs d'identifiants propres au modèle choisi (login, mot de passe, hôte SIP, etc.). Leur libellé, leur type (texte, mot de passe, nombre, liste, zone de texte) et leur aide proviennent du modèle. Si un champ obligatoire manque ou est invalide : « Renseigne tous les identifiants obligatoires de l'opérateur. »

Cas du modèle générique (« SIP générique »)

Pour le modèle générique, les identifiants sont découpés en sections :

• Réglages essentiels : hôte SIP, port SIP, enregistrement activé, authentification activée, nom d'utilisateur, nom d'authentification, mot de passe — suffisant pour la majorité des opérateurs.
• Une case Options SIP/PJSIP avancées ouvre des onglets experts :
  • Routage et identification : transport, proxy, identité SIP, règles d'entrée par IP ou header.
  • Média, NAT et fax : codecs, DTMF, RTP, chiffrement, timers, options fax.
  • Enregistrement et supervision : URI, expiration, tentatives, supervision, contacts AOR.
  • Autres paramètres (si présents).
  • Options libres officielles : ajout d'options clé/valeur dans les sections PJSIP officielles (avec suggestions issues de la documentation PJSIP). Ces valeurs surchargent les réglages guidés.

Le champ Transport propose la liste des transports SIP disponibles ; l'option « Transport par défaut » laisse la plateforme choisir.

Paramètres avancés (onglet)

Champ	Type	Détails
Format du numéro sortant	liste	+E164, E164, ou National. Défaut : +E164.
Routage entrant personnalisé	texte	Contexte d'entrée. Vide = Automatique.
Utiliser les règles d'entrée Twilio	interrupteur (case)	Active le routage entrant spécifique Twilio.

Aide : « Laisse vide sauf si ton opérateur demande explicitement un réglage particulier. »

Le bouton Connecter le trunk valide et crée le trunk. Retour revient au choix de l'opérateur.

Modifier un trunk

La modale Modifier le trunk (« Modifie le libellé, les DDIs, ou (en cochant ci-dessous) les identifiants SIP — les fichiers PJSIP seront régénérés et PJSIP sera rechargé automatiquement. ») reprend deux onglets.

Onglet essentiel

Champ	Type	Obligatoire	Détails
Nom (label)	texte	Oui	Libellé du trunk.
DDI principal	texte	Oui	Numéro principal.
DDIs supplémentaires (séparés par virgule)	texte	Non	Ex. 0315210375, 0315210376.
Mettre à jour les identifiants SIP	case	Non	À cocher uniquement si le mot de passe a changé chez l'opérateur.

En cochant Mettre à jour les identifiants SIP, le formulaire d'identifiants du modèle réapparaît (mode compact). « Cela régénère les fichiers PJSIP et recharge PJSIP (~10s). »

Onglet avancé

Mêmes options que la création : Format du numéro sortant, Routage entrant personnalisé, Utiliser les règles d'entrée Twilio.

Boutons : Annuler et Enregistrer.

Supprimer un trunk

Confirmation : « Supprimer le trunk libellé ? »

« Le compte SIP, les fichiers de téléphonie et l'enregistrement seront supprimés. Le service téléphonique va se recharger. Les appels en cours via ce trunk seront coupés. »

Conseils

Après avoir créé un trunk, allez immédiatement dans Routes sortantes pour l'assigner, sinon aucun appel sortant ne pourra l'emprunter.