MaxiPBX
Administration

SVI (menus vocaux)

SVI (menus vocaux)

La page SVI (menus vocaux) (/admin/ivr) gère les menus interactifs « Tapez 1 pour les ventes, tapez 2 pour le support… ». Un SVI joue une annonce, attend une touche DTMF et route l'appel selon le choix, avec des destinations de secours quand l'appelant se trompe, ne répond pas, ou abuse des essais.

En-tête : titre « SVI (menus vocaux) » et sous-titre « {count} menus · {client} ». Le bouton Créer un SVI est désactivé tant qu'aucun client n'est sélectionné.

La liste des SVI

Chaque ligne affiche : icône, nom du SVI, description (si présente), badge {count} choix, et au survol les actions Éditer et Supprimer.

État Affichage
Aucun client « Sélectionne un client en haut ».
Erreur « Impossible de charger les SVI : {erreur} ».
Aucun SVI « Aucun SVI configuré » + bouton Créer le premier.

Créer un SVI

Le bouton Créer un SVI ouvre une fenêtre à deux onglets (Essentiel / Avancé).

Onglet Essentiel

Champ Type Obligatoire Détails
Nom Texte Oui Nom du SVI (placeholder « Accueil principal »). Vide → « Nom obligatoire ».
Annonce du menu Liste de sons Oui Son joué en boucle (« Tapez 1 pour les ventes… »). Vide → « Annonce du menu obligatoire (uploade un son d'abord) ».

Si aucun son n'est uploadé, la liste est vide et un message renvoie vers Sons & musique : « Aucun son uploadé. Va dans « Sons & musique » pour uploader le fichier « Tapez 1 pour… ». » En cas d'erreur de chargement des sons, un encart l'indique. Un encart « Comment l'atteindre » rappelle qu'un SVI se joint via une DID entrante.

Onglet Avancé

Champ Type Détails
Description Texte Description interne (placeholder « SVI général de la société »).

Succès : « SVI créé ». À la création, le timeout est fixé à 5 s ; les choix se définissent ensuite en édition.

Modifier un SVI

L'édition ouvre une fenêtre à cinq onglets : Général, Menu, Destinations défaut, Avancé, Comment l'atteindre.

Onglet Général

Champ Type Détails
Nom Texte Nom du SVI (obligatoire).
Annonce d'accueil Liste de sons Jouée une fois en début d'appel. Optionnelle (« Aucun »).
Annonce du menu Liste de sons « Tapez 1 pour… », en boucle jusqu'à saisie. Obligatoire (pas d'option « Aucun »).

Onglet Menu ({count})

« Chaque choix DTMF redirige vers une destination. Utilise 0-9, *, #, plusieurs chiffres ou une règle avancée. »

Bouton Ajouter un choix (propose automatiquement la prochaine touche libre 1→9, 0, *, #). Vide → « Aucun choix défini. Ajoute au moins une touche pour que le menu serve à quelque chose. »

Chaque ligne de choix contient :

Élément Type Détails
Touche Texte Touche(s) DTMF. Doit respecter le format : 0-9, *, #, plusieurs chiffres, ou une règle avancée (motif Asterisk _…).
Type Liste Type de destination (utilisateur, groupe, file, SVI, boîte vocale, standard, conférence, route sortante, application, commande, son, extension, raccrocher).
Cible Variable Champs spécifiques au type choisi (utilisateur + MoH, file, etc.).
🗑 Bouton Retire le choix.

Pour les types utilisateur / groupe / file, un volet Avancé dépliable permet de fixer une durée de sonnerie. Pour une file, on peut aussi choisir une règle de compétence et saisir des variables de compétence.

Erreurs possibles à la sauvegarde : « Le choix « {key} » n'est pas valide… », « Le choix « {key} » est défini plusieurs fois. », « Le choix « {key} » n'a pas de destination configurée. Choisis-en une ou retire-le. »

Onglet Destinations défaut

Trois destinations de secours (chacune avec son sélecteur de destination) :

Destination Quand ?
Touche invalide / hors menu L'appelant a tapé une touche non prévue → annonce « invalide » puis route ici.
Timeout sans saisie L'appelant n'a rien tapé → route ici si défini.
Abandon après trop d'essais Nombre maximal d'essais atteint → annonce d'abandon puis route ici, ou raccroche si rien.

Onglet Avancé

Champ Type Plage / Défaut Détails
Description Texte Description interne.
Annonce option invalide Liste de sons Jouée quand l'appelant tape une touche non prévue.
Annonce timeout/abandon Liste de sons Jouée à l'abandon.
Timeout après menu (s) Nombre 0–3600 / 5 Attente après l'annonce avant de rejouer le menu, router vers timeout, ou abandonner.
Nombre d'essais Nombre 0–100 / 3 Timeouts et touches invalides comptés. Au-delà → destination d'abandon.

Onglet Comment l'atteindre

Rappelle qu'un SVI n'a pas d'extension interne directe. Trois façons de l'atteindre :

  1. DID entrant : pointer un numéro public sur ce SVI (page Numéros entrants).
  2. Fallback de groupe ou de file : choisir « Menu SVI » en fallback sans réponse.
  3. Choix d'un autre SVI : une touche d'un menu parent pointe sur ce SVI (cascade).

Conseil affiché : « Pour tester rapidement : crée temporairement un numéro entrant dédié et appelle-le. »

Le bouton Enregistrer affiche « Sauvegarde… » ; succès : « SVI sauvegardé ».

Supprimer un SVI

Confirmation : « Supprimer {nom} ? » — « Le SVI et ses choix de menu seront supprimés. Les routages qui pointent dessus devront être corrigés. »