MaxiPBX
Administration

Routes sortantes

Routes sortantes

La page Routes sortantes (/admin/outcalls) définit par où partent les appels sortants : selon le numéro composé, une règle décide du trunk emprunté, des préfixes à ajouter/retirer, de l'identité affichée et de l'horaire applicable.

Sans route sortante, personne ne peut appeler vers l'extérieur. Les actions dépendent du client sélectionné (« Sélectionne un client en haut »).

En-tête et actions

L'en-tête affiche le titre et « N routes · client ». Deux boutons :

  • Routes par défaut — crée les routes International + National si elles n'existent pas encore. Infobulle : « Crée les routes International + National si elles n'existent pas ».
  • Créer une route — ouvre la modale de création.

À l'utilisation de Routes par défaut :

  • « N route(s) créée(s) : noms » (avec « · N ignorée(s) (déjà existantes) » si certaines existaient) ;
  • ou « Les 2 routes par défaut existent déjà. »

Liste des routes

Chaque ligne montre : le nom, les règles (extensions, en mono), un compteur de trunks (« # trunk(s) »), un badge CID si un Caller ID par défaut est défini, un badge Horaire le cas échéant, et un badge d'état : active (vert) ou désactivée.

Au survol : Éditer (« Éditer (nom, description, trunk, enabled) ») et Supprimer.

État vide

« Aucune route sortante configurée » + conseil : « Sans route, les utilisateurs ne peuvent pas appeler vers l'extérieur. Crée au moins une route avec la règle _X. (tout numéro) + un trunk SIP. »

Erreurs de chargement

Encart rouge listant les ressources non chargées : routes sortantes, trunks SIP, horaires (avec détail).

Créer une route

Modale « Nouvelle route sortante » : « Quand un utilisateur compose un numéro qui correspond à cette règle, l'appel part par le trunk choisi. » Onglets essentiel et avancé.

Onglet essentiel

Champ Type Obligatoire Détails
Nom texte Oui Ex. « Sortie nationale ».
Description texte Non Note interne optionnelle.
Règle de numéro liste de presets + texte Oui Choisissez un preset ou saisissez une règle Asterisk. Défaut : _X..
Trunks SIP cases à cocher Oui Un ou plusieurs trunks. Avertissement si aucun : « ⚠️ Aucun trunk créé. Crée d'abord un trunk dans Téléphonie > Trunks SIP. »
Horaire liste Non « — Aucun horaire — » par défaut.
Route activée case Cochée par défaut.

Aide sur la règle : « Syntaxe Asterisk : _ = début de règle, X = chiffre 0-9, . = un ou plusieurs caractères, [1-9] = liste. Ex : _0[1-9]X. = numéros nationaux qui commencent par 0 puis un chiffre non-zéro. »

Presets de règle disponibles :

Preset Règle
Tout numéro (universel) _X.
International (00…) _00X.
National Suisse (0…) _0[1-9]X.
Mobile Suisse (079/078/076/077/075/074) _07[456789]XXXXXXX
Numéros surtaxés (0900/089) _0[89]X.

Onglet avancé

Champ Type Détails
Caller ID par défaut texte (mono) Numéro affiché en sortant quand l'extension appelante n'a pas de Caller ID externe. Ex. 0315210372. Vide = ne rien forcer.
Durée de sonnerie nombre Secondes avant abandon. Vide = valeur par défaut du PBX.
Routine avancée avant appel texte (mono) Champ officiel avancé. Défaut maxipbx-caller-id-hook (applique le Caller ID par défaut). Vide si aucune routine.
Utiliser l'identité interne case Présente l'identité interne en sortie.

Boutons : Annuler et Créer la route.

Validation à la création : « Nom + règle + trunk obligatoires » ; « La durée de sonnerie doit être un entier positif. » ; « Choisis un horaire valide. » ; « Aucune plage d'appels sortants n'est disponible pour ce client. »

Modifier une route

Modale « Modifier la route : nom » indiquant « Règle actuelle : pattern ». Onglets essentiel et avancé. En plus de la création, on peut gérer plusieurs règles (patterns).

Règles de numéros (patterns)

« Chaque règle peut modifier le numéro composé avant l'envoi: préfixe, chiffres à retirer, préfixe externe ou identité affichée. » Un bouton Ajouter une règle ajoute une ligne ; Retirer la règle la supprime. Pour chaque règle :

Champ Type Détails
Règle texte (mono) Le pattern Asterisk (ex. _X.).
Contexte texte (mono) Contexte de l'extension (rempli automatiquement).
Préfixe demandé texte (mono) Préfixe que l'utilisateur compose (déclencheur).
Chiffres retirés nombre Nombre de chiffres retirés en tête. Doit être un entier ≥ 0.
Préfixe envoyé texte (mono) Préfixe ajouté avant l'envoi à l'opérateur.
Identité affichée texte (mono) Caller ID propre à cette règle.

Les préfixes ne doivent contenir que des chiffres, *, # ou +, sinon : « Les préfixes doivent contenir uniquement des chiffres, *, # ou +. Le pattern de route reste dans le champ Règle. » Les chiffres retirés invalides déclenchent : « Le nombre de chiffres retirés doit être un entier positif ou zéro. »

Autres champs

  • Nom, Description ;
  • Trunks SIP (cases ; option « libellé (trunk #id) »). Avertissements si aucun trunk : « Aucun trunk PBX disponible. », puis « Crée d'abord un trunk dans la page Trunks. » ou « Recharge la page si tu viens de créer le trunk. » ;
  • Horaire, Route activée ;
  • onglet avancé : Caller ID par défaut, Durée de sonnerie, Routine avancée avant appel, Utiliser l'identité interne.

Boutons : Annuler et Enregistrer (« Sauvegarde… » pendant l'opération).

Messages de succès : « Route sortante créée » / « Route mise à jour ».

Supprimer une route

Confirmation : « Supprimer nom ? » — « La route et ses extensions/associations seront supprimées. Les règles ne routeront plus. »

Pour qu'une route fonctionne, elle doit pointer vers un trunk SIP opérationnel. Créez le trunk d'abord, puis assignez-le ici.