Flux d'appels

La page Flux d'appels (/admin/call-flows) est le Call Flow Designer : un éditeur visuel qui vous laisse voir et modifier le routage réel d'un numéro entrant (SDA). Pour chaque SDA, vous composez un enchaînement simple — éventuellement un horaire, éventuellement une annonce, puis une destination finale — et la sauvegarde écrit directement la route entrante officielle de votre MaxiPBX.

Sous-titre affiché : « Sélectionne une SDA, visualise son routage réel et mets à jour la route PBX officielle. » Le bloc « Source de vérité » rappelle que cette vue lit et écrit la vraie route entrante ; ce n'est pas une maquette.

Si aucun client n'est sélectionné, la page affiche « Sélectionne un client dans la barre du haut. » et rien d'autre.

Disposition de l'écran

L'écran se découpe en trois colonnes :

Colonne	Rôle
Gauche	Sélecteur de SDA, état de la route, rappel « Source de vérité ».
Centre	Barre d'actions (ajouter/retirer horaire et annonce, enregistrer) et canevas affichant le graphe de la route.
Droite	Inspecteur : édite le bloc sélectionné ; aperçu des branches SVI le cas échéant.

Choisir la SDA (colonne gauche)

Champ	Type	Détails
Numéro entrant / SDA	Liste déroulante	Liste fusionnée des routes entrantes existantes et des numéros déclarés (numéros entrants). Un numéro déjà routé s'affiche avec son libellé (numéro - libellé). La première SDA est présélectionnée automatiquement.

S'il n'existe aucune SDA, un encart « Aucune SDA trouvée pour ce client pour le moment. » s'affiche. Déclarez d'abord des numéros entrants.

État de la route

Un badge résume la situation de la SDA choisie :

Badge	Signification
Configurée	Une route entrante existe et n'a pas été modifiée.
Modifications non enregistrées	Vous avez changé le graphe sans encore enregistrer.
Non configurée	Cette SDA n'a pas encore de route ; l'enregistrement la créera.

Le graphe (canevas central)

Le canevas montre la route sous forme de blocs reliés de gauche à droite par des flèches. Les blocs possibles :

Bloc	Toujours présent ?	Rôle
Entrée	Oui	Point de départ = la SDA sélectionnée (lecture seule).
Horaire	Optionnel	Applique un horaire d'ouverture à la route.
Annonce	Optionnel	Joue un son d'accueil avant la destination.
Destination	Oui	Destination finale de l'appel (utilisateur, file, SVI…).

Cliquez un bloc pour le sélectionner ; l'inspecteur de droite affiche alors ses réglages.

Barre d'actions

Bouton	Effet
Ajouter horaire / Retirer horaire	Insère ou retire le bloc Horaire entre l'entrée et la suite.
Ajouter annonce / Retirer annonce	Insère ou retire le bloc Annonce juste avant la destination.
Enregistrer la route SDA	Sauvegarde la route. Désactivé tant qu'aucune SDA n'est choisie ou pendant l'enregistrement.

L'inspecteur (colonne droite)

Le contenu dépend du bloc sélectionné.

Bloc Entrée

Affiche le Numéro entrant en lecture seule. Texte : « Le point d'entrée est fixé par le sélecteur SDA. Change de SDA pour modifier une autre route. »

Bloc Horaire

Champ	Type	Détails
Horaire	Liste déroulante	Choisit un horaire existant du client (option vide = « Choisir une destination »). Hors plage d'ouverture, c'est le routage défini sur l'horaire qui s'applique.

Bloc Annonce

Champ	Type	Détails
Son	Liste déroulante	Son joué une fois en début d'appel. Liste des sons uploadés du client ; si la route pointe un son inconnu, il reste affiché.

Bloc Destination

La destination s'édite via le sélecteur de destination commun (voir ci-dessous). Un encart « Comportement des branchements » explique, selon le type :

• SVI : « Le SVI sélectionné porte ses branches DTMF, destination invalide et timeout. Ces choix se modifient dans l'objet SVI. »
• File / Groupe : « Cette destination porte ses fallbacks et comportements de débordement. Ils se modifient dans la page dédiée de l'objet. »
• Autre : « Cette destination est une route terminale directe pour cette SDA. »

Si la destination est un SVI, un panneau « Branches SVI » liste ses choix DTMF (touche → type de destination) et propose Modifier les choix, qui ouvre l'éditeur de SVI sans quitter la page.

Le sélecteur de destination

C'est le composant réutilisé partout pour choisir « où va l'appel ». Les types disponibles dans les flux d'appels :

Type	Cible à renseigner
Utilisateur	L'utilisateur + musique d'attente optionnelle + durée de sonnerie.
File d'attente	La file (durée de sonnerie, règle de compétence et variables en option).
Boîte vocale	La boîte (annonce occupé/indisponible, ignorer les instructions).
Menu SVI (IVR)	Le SVI cible.
Groupe d'appel	Le groupe + durée de sonnerie.
Standard opérateur	Le standard (switchboard).
Conférence	La salle de conférence.
Route sortante	La route sortante + numéro à composer.
Application avancée	Annuaire, portail voicemail, DISA, callback DISA, fax vers email, application personnalisée (selon le cas : plan de numérotation, PIN, email, application).
Commande personnalisée (avancé)	Une commande dialplan (ex. Playback(message)).
Jouer un son	Un son + options « Jouer sans répondre » et « Ignorer si l'appel n'est pas répondu ».
Extension personnalisée	Un numéro + plan de numérotation.
Raccrochage forcé	Cause Normal, Occupé ou Congestion (+ délai avant raccrochage si occupé/congestion).

Dans un flux d'appels, une destination vide est convertie automatiquement en Raccrocher (cause normale).

Enregistrer

Au clic sur Enregistrer la route SDA :

• La destination est validée. Si elle est absente ou invalide : « Choisis une destination valide avant de sauvegarder. »
• Si un bloc Horaire est présent mais sans horaire valide : « Choisis un horaire valide avant de sauvegarder. »
• Si la SDA avait déjà une route, elle est mise à jour ; sinon elle est créée.
• Succès : « Route SDA enregistrée. » En cas d'erreur API, le message renvoyé par le serveur s'affiche.

États particuliers

Situation	Comportement
Aucun client sélectionné	Carte « Sélectionne un client dans la barre du haut. »
Aucune SDA	Encart « Aucune SDA trouvée pour ce client pour le moment. »
SDA jamais routée	« Cette SDA n'a pas encore de route entrante. La sauvegarde va la créer. »