Utilisateurs
Utilisateurs
La page Utilisateurs (/admin/users) est le cœur de l'administration MaxiPBX. Elle permet de créer, configurer et supprimer les comptes téléphoniques d'un client (tenant), de gérer leurs identifiants, leur messagerie vocale, leurs renvois, leurs touches programmables, leurs permissions, leur profil agent de centre d'appels, et bien plus.
Cette page travaille toujours dans le contexte d'un client (tenant). Sélectionnez d'abord un client dans la barre du haut. Tant qu'aucun client n'est sélectionné, la liste affiche « Sélectionnez un client » et les actions sont désactivées.
Vue d'ensemble : la liste des utilisateurs
En-tête de page
- Titre : « Utilisateurs ».
- Sous-titre : «
{count}utilisateurs ·{tenant}» — nombre total d'utilisateurs et nom du client courant.
La carte « Licences du client »
Au-dessus de la liste, une carte « Licences du client » indique la consommation de licences. Elle devient rouge si la création est bloquée.
| Élément | Détails |
|---|---|
| Source | « Source : ControlPlane » (licence centrale) ou « Source : quota local PBX ». |
Personnes {used}/{licensed} |
Nombre d'utilisateurs de type Personne consommés / nombre licencié (∞ si illimité). |
Restantes {count} |
Licences personnes encore disponibles (∞ si illimité). |
Équipements {count} |
Nombre d'utilisateurs de type Équipement (ne consomment pas de licence payante). |
| « Création bloquée » | Badge rouge affiché si le quota est atteint : la création de nouvelles personnes est interdite. |
La liste
Chaque ligne représente un utilisateur :
| Colonne | Détails |
|---|---|
| Pastille de statut | Petit rond coloré indiquant l'état de la ligne SIP. Vert = en ligne / enregistré. Orange clignotant = en communication (« In use », « Busy » ou « Ringing »). Gris = hors ligne / non enregistré. Le survol affiche l'état brut (ou « unknown »). |
| Nom | Prénom + Nom en gras. |
| Affiché en gris à côté du nom (masqué sur petit écran). | |
| Badge extension | ext {numéro} (police monospace). |
| Badge « Équipement » | Affiché uniquement si l'utilisateur est de type Équipement. |
| Badge notification push | État du dernier push mobile : « Push OK » (vert), « Push échec » (rouge) ou « Aucun push » (gris, aucun événement). Le survol détaille source, statut et horodatage. |
Si l'état SIP ou l'état des lignes ne peut être récupéré, une carte d'avertissement orange s'affiche avec le détail de l'erreur, juste sous l'en-tête.
États particuliers
- Aucun client sélectionné : carte « Sélectionnez un client ».
- Chargement : 4 lignes grises animées.
- Erreur : carte rouge avec le détail de l'erreur API.
- État vide (aucun utilisateur) : carte centrée avec une icône de téléphone et le texte « Aucun utilisateur pour l'instant ».
Actions au survol d'une ligne
En passant la souris sur une ligne (ou via le focus clavier), cinq boutons apparaissent à droite :
| Bouton (icône) | Effet |
|---|---|
| Réinitialiser le mot de passe (clé) | Ouvre la confirmation de réinitialisation du mot de passe de connexion. |
| Renvoyer le message de bienvenue (enveloppe) | Ouvre la confirmation d'envoi du message de bienvenue. Désactivé si l'utilisateur n'a pas d'e-mail (libellé « Ajoutez un e-mail pour envoyer le message de bienvenue »). |
| Tester la notification mobile (cloche) | Envoie immédiatement une notification push de test à l'appareil mobile de l'utilisateur. |
| Modifier (crayon) | Ouvre la modale d'édition complète (voir plus bas). |
| Supprimer (corbeille, rouge) | Ouvre la confirmation de suppression. |
Actions principales (haut de page)
| Action | Détails |
|---|---|
| Exporter CSV | Télécharge un fichier maxipbx-users-<client>.csv contenant tous les utilisateurs du client. Désactivé sans client. |
| Importer CSV | Ouvre un sélecteur de fichier (.csv). À la sélection, le fichier est envoyé au serveur et la liste est rechargée. Un toast confirme : « {count} utilisateur(s) importé(s) ». |
| Ajouter un utilisateur | Ouvre la modale de création (voir ci-dessous). Désactivé sans client. |
Modale « Ajouter un utilisateur »
Description : « Dans le client : {nom du client} ». La validation est assurée par un schéma zod.
| Champ | Type | Obligatoire | Détails |
|---|---|---|---|
| Prénom | Texte | Oui | 1 à 128 caractères. |
| Nom | Texte | Oui | 1 à 128 caractères. |
| Type d'utilisateur | Liste | Oui | « Personne » (par défaut, consomme une licence payante) ou « Équipement » (chambre, salle, interphone, poste commun). Aide affichée sous le champ. |
| Extension | Texte | Oui | 2 à 10 chiffres (^\d{2,10}$). Doit avoir exactement le nombre de chiffres configuré sur ce client. Espace réservé : « Extension à xxxx chiffres ». |
| Non | Format e-mail valide ou vide. Sert aux notifications de messagerie vocale. | ||
| Langue | Liste | Oui | Deutsch (Deutschland), English (US), Español (España), Français (France) (défaut), Français (Canada), Italiano (Italia), Nederlands. |
| Timezone | Sélecteur de fuseau | Non | Par défaut Europe/Zurich. |
| Mobile | Texte | Non | Numéro de mobile de l'utilisateur. |
Boutons : Annuler et Créer. À la création, un toast confirme « Utilisateur {prénom} {nom} créé ».
Modale d'identifiants après création
Si la création renvoie un mot de passe, une modale « Succès » s'ouvre avec l'avertissement : « ⚠️ Notez ce mot de passe — il ne sera plus affiché ».
| Ligne affichée | Détails |
|---|---|
| Login | Identifiant de connexion. |
| Password | Mot de passe généré (à usage unique). |
PIN Messagerie vocale (ext {extension}) |
Affiché uniquement si un PIN de messagerie a été généré. |
Bouton « Copier identifiants » : copie les lignes dans le presse-papiers (toast « Copié »).
Modale d'édition d'un utilisateur
Ouverte par le bouton crayon, c'est une grande modale à onglets. Le titre est « Modifier {prénom} {nom} » et la description « Extension {extension} (non modifiable) · Login {login} ». Un badge vert « Compte actif » apparaît si le compte est activé.
L'extension n'est pas modifiable depuis cette modale.
À l'enregistrement (bouton Enregistrer), plusieurs requêtes sont envoyées en parallèle : profil utilisateur, fallbacks, renvois, services (DND / filtrage) et, si nécessaire, l'association d'horaire. Le bouton Annuler ferme sans sauver.
La modale comporte six onglets : Essentiel, Téléphonie, Messagerie, BLF, Appareils, Avancé.
Onglet « Essentiel »
Tuiles récapitulatives
Quatre tuiles : Extension, Login, Mobile, Compte (« Actif » en vert ou « Désactivé »).
Section « Identité »
| Champ | Type | Obligatoire | Détails |
|---|---|---|---|
| Prénom | Texte | Oui | — |
| Nom | Texte | Oui | — |
| Type d'utilisateur | Liste | Oui | « Personne » ou « Équipement ». |
| Non | « Utilisé pour notifications voicemail ». | ||
| Mobile | Texte | Non | Numéro de mobile. |
| Langue | Liste | Oui | Mêmes options qu'à la création. |
| Timezone | Sélecteur | Non | Fuseau horaire. |
| Description | Texte | Non | Notes internes. |
Section « Options usuelles » (interrupteurs)
| Interrupteur | Défaut | Effet |
|---|---|---|
| Compte actif | Activé | Décocher pour désactiver le compte sans le supprimer. |
| Secours mobile | Désactivé | Fait sonner le numéro mobile si l'appel push n'est pas pris à temps. |
| Ne pas déranger (DND) | Désactivé | Bloque tous les appels entrants → voicemail ou occupé. |
| Filtrage patron/secrétaire | Désactivé | Active le service de filtrage d'appels entrants si configuré. |
Section « Département »
Sélection du département (radio) : voir l'onglet Département ci-dessous. Affichée directement dans l'onglet Essentiel.
Carte « Identifiants »
Carte mettant en avant les identifiants de connexion et SIP : voir l'onglet Identifiants.
Onglet « Téléphonie »
Section « Appels »
| Champ | Type | Obligatoire | Détails |
|---|---|---|---|
| Durée de sonnerie (s) | Nombre | Oui | 0 à 10800. Temps de sonnerie avant timeout. Défaut 30. |
| Appels simultanés | Nombre | Oui | 1 à 20. Nombre d'appels en parallèle. Défaut 5. |
| Caller ID interne | Texte (lecture seule) | — | Format « prénom + nom + extension », affiché aux appelés internes. Recalculé automatiquement. |
| Musique d'attente | Liste | Non | « Par défaut » ou une musique d'attente du client. |
| Caller ID sortant | Liste | Non | « Identité par défaut de l'utilisateur » (défaut), « Appel anonyme », ou « Prénom Nom + numéro de l'utilisateur ». |
| Transfert d'appel autorisé | Interrupteur | — | Autorise l'utilisateur à transférer ses appels. |
| Raccrochage par DTMF | Interrupteur | — | Permet de raccrocher via une touche DTMF si le scénario l'utilise. |
| Supervision BLF activée | Interrupteur | — | Permet aux collègues de voir l'état (libre/occupé). |
Section « Renvois & DND »
Trois renvois, chacun activable par interrupteur. Une fois activé, on choisit la destination :
- Case « Renvoi vers le mobile de l'utilisateur » : utilise le numéro mobile de l'onglet Identité (désactivée si aucun mobile renseigné).
- Sinon, champ « Autre numéro » (espace réservé
0791234567).
| Renvoi | Détails |
|---|---|
| Renvoi inconditionnel | Tous les appels sont transférés directement. |
| Renvoi si occupé | Quand l'utilisateur est déjà en appel. |
| Renvoi si non-réponse | Après {durée de sonnerie}s sans décrocher. |
Si un renvoi est activé sans destination, l'enregistrement échoue avec le message « Destination (numéro) est obligatoire. ».
Onglet « Messagerie »
Cet onglet contient deux blocs : la messagerie vocale (voir l'onglet Messagerie vocale) et le suivi des notifications mobiles (push).
Suivi des notifications push
Trois tuiles : Dernier push (statut + date), Échecs (échecs / total) et un bloc d'actions :
| Action | Effet |
|---|---|
| Tester push | Envoie une notification de test à l'utilisateur. |
| Copier diagnostic | Copie un JSON de diagnostic (uuid, e-mail, derniers événements) dans le presse-papiers. |
| Réinitialiser tokens | Supprime les tokens push. Demande confirmation. L'utilisateur devra rouvrir l'app pour se réenregistrer. |
En dessous, l'historique des événements push (source, statut, canal, code HTTP, titre, message d'erreur) ou « Aucun événement push enregistré pour cet utilisateur. ».
Onglet « BLF » (touches programmables)
Permet d'éditer les touches programmables (BLF / fonctions) appliquées à tous les téléphones de l'utilisateur.
Groupes de touches réutilisables
Si des modèles existent pour le client, des boutons permettent de les Ajouter / Retirer (associer / dissocier un modèle partagé).
Actions rapides (préréglages)
Boutons qui ajoutent une fonction courante sans configurer la destination technique. Affichés seulement si supportés : Renvoi immédiat, Renvoi non-réponse, Renvoi occupé, Annuler renvois, Ne pas déranger, Interception, Messagerie, Enregistrer, Parquer.
Tableau des touches
Bouton Ajouter crée une touche ; bouton Enregistrer sauve tout (désactivé si aucune modification ou si une ligne est invalide). Les lignes se réordonnent par glisser-déposer.
| Colonne | Détails |
|---|---|
# |
Position (1, 2, 3…). |
| Type | Destination de la touche (voir liste ci-dessous). |
| Paramètres | Champs dépendant du type (listes déroulantes ou saisie libre). « Aucun paramètre » si le type n'en demande pas. |
| Libellé | Texte affiché sur le téléphone. |
| Surveillance | Case BLF : surveille l'état (occupé/libre) de la cible. |
| Actions | Effacer la touche (corbeille). |
Types de destination possibles : Agent, Filtrage patron/secrétaire, Conférence, Numéro / code personnalisé, Renvoi, Groupe d'appels, Membre de groupe, Enregistrement à la demande, Paging, Position de parking, Parking, File d'attente, Service, Transfert, Utilisateur. Selon le type, les paramètres listent dynamiquement les utilisateurs, groupes, files, conférences, pagings, parkings ou agents du client.
Onglet « Appareils »
Liste (lecture seule) des téléphones assignés à cet utilisateur. Pour chaque appareil :
- Marque + modèle, adresse MAC (formatée), IP, firmware, plugin.
- Badge « Compte N » indiquant la position du compte sur le téléphone (le compte 1 impose sa langue et son fuseau au téléphone).
- Badge RPS si l'appareil est enrôlé dans le cloud.
État vide : « Aucun téléphone enregistré ».
Onglet « Avancé »
Un menu latéral propose cinq panneaux : Routage, Centre d'appels, Sécurité, Intégrations, Technique.
Panneau « Routage »
Fallbacks et horaire
| Champ | Type | Détails |
|---|---|---|
| Horaire utilisateur | Liste | « Aucun (toujours actif) » ou un horaire du client. En dehors de cet horaire, le comportement de l'horaire prend le relais. |
| Fallback sans réponse | Sélecteur de destination | Destination si l'appel n'est pas répondu. |
| Fallback occupé | Sélecteur de destination | Destination si l'utilisateur est occupé. |
| Fallback congestion | Sélecteur de destination | Destination en cas de congestion. |
| Fallback échec | Sélecteur de destination | Destination en cas d'échec. |
Les quatre fallbacks utilisent le sélecteur de destination (voir section dédiée). Une destination incomplète bloque l'enregistrement (« Choisis une destination valide avant de sauvegarder. »).
Caller IDs
Voir l'onglet Caller IDs.
Numéros bloqués
Voir l'onglet Numéros bloqués.
Panneau « Centre d'appels »
Agent : voir l'onglet Agent.
Enregistrement : interrupteurs d'enregistrement automatique des appels.
⚠️ Conformité RGPD : informer les correspondants si l'enregistrement est activé. Les fichiers sont stockés sur le serveur et accessibles dans les journaux d'appels.
Interrupteur Effet Enregistrement à la demande Permet de déclencher l'enregistrement manuellement pendant l'appel. Appels sortants vers externe Enregistre les appels sortants externes. Appels sortants internes Enregistre les appels interne → interne sortants. Appels entrants depuis externe Enregistre les appels entrants externes. Appels entrants internes Enregistre les appels entrants internes. Historique : journal d'appels de l'utilisateur (voir section Historique).
Panneau « Sécurité »
Contient l'onglet Permissions : voir l'onglet Permissions.
Panneau « Intégrations »
- Identités chat : voir l'onglet Identités chat.
- Apps externes : voir l'onglet Apps externes.
Panneau « Technique »
| Champ | Type | Détails |
|---|---|---|
| Userfield (champ libre) | Texte | Champ texte arbitraire (ID interne, code département, etc.). |
| Subroutine pré-traitement | Texte | Nom d'une sous-routine Asterisk exécutée avant chaque appel (avancé). |
| Code permissions d'appel | Texte | Code optionnel demandé par certaines restrictions d'appel. |
| UUID interne | Texte (lecture seule) | Identifiant interne de l'utilisateur. |
| Compte SIP technique | Texte (lecture seule) | Nom de l'endpoint SIP. |
Détail des sous-onglets
Onglet « Identifiants » {#onglet-identifiants}
Deux sections : la connexion MaxiPBX / WebRTC et les identifiants SIP bruts.
Connexion MaxiPBX / Softphone WebRTC
Sert à se connecter à l'interface ou au softphone WebRTC.
| Élément | Détails |
|---|---|
| Identifiant | E-mail ou nom d'utilisateur (lecture seule, copiable). |
| Mot de passe | Masqué (••••••••••). Stocké de manière sécurisée ; pour le récupérer, il faut le réinitialiser. |
| Bouton « Réinitialiser le mot de passe » | Génère un nouveau mot de passe affiché une seule fois. |
| QR code statique | QR remplissant serveur + identifiant dans les apps MaxiPBX (ne contient pas le mot de passe). |
Après une réinitialisation, un encadré vert affiche le nouvel Identifiant + Mot de passe, un QR code de connexion (serveur + identifiants pour iOS, Android, WebRTC, Desktop), un bouton « Copier identifiant + mot de passe » et « Fermer ». Avertissement : « ⚠️ Notez ce mot de passe — il ne sera plus jamais affiché. ».
Identifiants SIP
Pour configurer un softphone externe (Zoiper, Linphone) ou un téléphone IP physique (Yealink, Snom, …).
| Champ | Détails |
|---|---|
| Identifiant SIP | Copiable. |
| Mot de passe SIP | Masqué par défaut, bouton Afficher / Masquer, copiable. |
| Serveur SIP (domaine) | Domaine du serveur, copiable. |
| Transport WebSocket (WSS) | URL wss://<serveur>/api/asterisk-ws, copiable. |
⚠️ Sécurité : ces identifiants donnent un accès SIP brut. Ne les partagez qu'avec l'utilisateur final (mail chiffré / mot de passe à usage unique). Si compromis, supprimez et recréez la ligne SIP.
Onglet « Département » {#onglet-departement}
Un utilisateur appartient à au plus un département. Les départements masqués rendent leurs membres invisibles aux autres utilisateurs dans le softphone.
- Boutons radio : « Aucun département » puis chaque département (pastille de couleur, nom, badge « Masqué » si applicable, nombre de membres).
- Bouton Enregistrer (désactivé si aucun changement). Toast « Département mis à jour ».
- Si aucun département n'existe : message avec un lien vers la page Départements.
Onglet « Caller IDs » {#onglet-caller-ids}
Liste de numéros présentés en sortie, parmi lesquels l'utilisateur choisit depuis le softphone (« Appeler en tant que »). Le caller ID par défaut est sélectionné automatiquement à la connexion.
Les numéros doivent appartenir aux SDA déclarés chez votre opérateur, sinon ils seront remplacés.
Pour chaque caller ID existant : une étoile (définir/retirer le défaut), le libellé, le numéro, un badge « défaut », et un bouton supprimer.
Formulaire « Ajouter un identifiant d'appel » :
| Champ | Type | Obligatoire | Détails |
|---|---|---|---|
| Libellé | Texte | Oui | Ex. « Standard MaxiConnect ». |
| Numéro | Texte | Oui | Ex. 0315210374. |
| Suggestions DDIs des trunks | Boutons | — | Numéros suggérés depuis les trunks : un clic remplit le numéro (et le libellé si vide). |
| Définir comme identifiant d'appel par défaut | Case | Non | Marque ce numéro comme défaut. |
Onglet « Numéros bloqués » {#onglet-numeros-bloques}
Liste (lecture seule côté admin) des numéros bloqués par l'utilisateur.
L'ajout et la modification se font depuis son softphone, car l'API n'expose l'écriture que pour l'utilisateur connecté.
Pour chaque numéro : icône, numéro, libellé (ou « Sans libellé ») et badge « Bloqué ». État vide : « Aucun numéro bloqué pour cet utilisateur. ».
Onglet « Messagerie vocale » {#onglet-messagerie-vocale}
Si aucune boîte n'existe : carte « Aucune messagerie vocale pour cet utilisateur. » avec un bouton Créer la messagerie (génère un PIN aléatoire affiché une fois).
Quand la boîte existe, un bandeau affiche le numéro de boîte, le contexte et un badge Active / Désactivée. Après génération d'un PIN, un encadré orange montre « ⚠️ Nouveau PIN » (bouton afficher/masquer).
| Champ | Type | Obligatoire | Détails |
|---|---|---|---|
| Nom de la boîte | Texte | Non | Ex. « Messagerie Anthony ». |
| Nombre maximum de messages | Nombre | Non | Entier positif. |
| Numéro de boîte | Texte (lecture seule) | — | — |
| Plan de numérotation (contexte) | Texte (lecture seule) | — | — |
| Langue des annonces | Liste | Non | « Langue par défaut du système » ou une des 7 langues. |
| Fuseau horaire | Sélecteur | Non | « Fuseau par défaut ». |
| Email pour notifications | Non | Adresse de notification. | |
| Email pager | Non | Adresse de pager. |
Interrupteurs :
| Interrupteur | Défaut | Effet |
|---|---|---|
| Boîte vocale activée | Activée | Les appels non répondus tombent sur la messagerie. |
| Demander le PIN à l'écoute | Activée | Sinon, accès direct depuis la ligne de l'utilisateur. |
| Notifier par email avec audio en pièce jointe | Activée | L'utilisateur reçoit un e-mail avec le .wav. |
| Supprimer le message du serveur après notification email | Désactivée | L'utilisateur ne pourra plus l'écouter depuis le téléphone. Exige un e-mail renseigné + l'audio en pièce jointe. |
Options avancées : paires clé / valeur supplémentaires. Boutons Enregistrer et Générer un nouveau PIN.
Pour écouter ses messages, l'utilisateur compose
*98depuis son téléphone, ou utilise l'onglet « Messagerie » du softphone.
Validations : nombre max de messages entier positif ; suppression conditionnée à e-mail + audio ; chaque option avancée doit avoir clé et valeur uniques.
Onglet « Permissions » {#onglet-permissions}
Gère les rôles et restrictions d'appel de l'utilisateur dans ce client. Les permissions système globales se gèrent depuis « Admins PBX ».
| Rôle / option | Type | Détails |
|---|---|---|
| Agent centre d'appels | Statut (lecture seule) | Indique si l'utilisateur est lié à un agent ACD. Badge « Agent » / « Non agent ». |
| Admin du client | Case | Peut accéder à /admin pour gérer son client (utilisateurs, files, menus vocaux, sons, stats). Ne voit pas les autres clients ni les trunks. |
| Superviseur centre d'appels | Case | Voit le Wallboard et peut écouter/coacher/barger les appels des agents dans ses files. |
| Écoute des enregistrements | Case | Peut écouter les enregistrements depuis son historique d'appels dans le softphone. |
- Ouvrir le softphone « en tant que » : ouvre une fenêtre softphone avec les identifiants SIP de l'utilisateur (impersonation). Bouton « Ouvrir en tant que ».
- Permissions d'appel appliquées : liste des restrictions/autorisations d'appel du client, chacune cochable pour l'utilisateur. Chaque permission affiche son nom, un badge « Blocage » / « Autorisation » et sa description (ou le nombre de règles de numérotation). État vide : « Aucune permission d'appel n'existe pour ce client. ».
Onglet « Agent » {#onglet-agent}
Configure le profil agent de centre d'appels (ACD) lié à l'utilisateur.
Si aucun agent n'est lié : « Aucun agent lié. Les nouveaux utilisateurs en reçoivent un automatiquement à la création. ».
Informations générales
| Champ | Type | Détails |
|---|---|---|
| Numéro d'agent | Texte (lecture seule) | Identifiant ACD. |
| Langue des annonces | Liste | fr_FR, en_US, de_DE, it_IT, es_ES. |
| Prénom agent / Nom agent | Texte | Identité de l'agent. |
| Description | Texte | Ex. « Support niveau 1 ». |
| Routine avancée avant appel | Texte | Option intégrateur ; laisser vide sauf routine existante. |
Mot de passe agent (*11) |
Mot de passe | Connexion téléphonique d'agent. Laisser vide pour ne pas changer. |
Files affectées
Liste des files du client avec, par file cochée, deux champs numériques : Pénalité et Priorité.
Compétences
Liste des compétences avec, par compétence cochée, un Poids (favorise les agents les plus adaptés). Champ + bouton Créer pour ajouter une nouvelle compétence.
Bouton final Enregistrer l'agent (met à jour l'agent, ses files et ses compétences).
Onglet « Identités chat » {#onglet-identites-chat}
Identités de messagerie de l'utilisateur pour les connecteurs externes (Teams, etc.).
Liste à gauche (identité, connecteur · type, bouton supprimer) ; formulaire à droite :
| Champ | Type | Obligatoire | Détails |
|---|---|---|---|
| Connecteur | Texte | Oui | Ex. teams. Non modifiable en édition. |
| Type | Texte | Oui | Ex. user. Non modifiable en édition. |
| Identité | Texte | Oui | Identifiant externe. |
| Métadonnées | Paires clé/valeur | Non | Valeurs avancées (nombres, booléens, JSON simples acceptés). |
Boutons : Nouvelle (réinitialise le formulaire), Créer / Mettre à jour. Validations : chaque métadonnée doit avoir clé + valeur uniques.
Onglet « Apps externes » {#onglet-apps-externes}
Configuration avancée des applications externes rattachées à l'utilisateur.
- Case « Afficher aussi les valeurs héritées du client » : bascule entre la vue héritée et les valeurs propres.
- Liste à gauche (libellé, nom technique, bouton supprimer).
Formulaire :
| Champ | Type | Obligatoire | Détails |
|---|---|---|---|
| Nom technique | Texte | Oui | Ex. google. |
| Libellé | Texte | Non | Ex. « Google Contacts ». |
| Paramètres | Paires clé/valeur | Non | Nombres, booléens, objets JSON simples acceptés. |
Boutons : Créer / Mettre à jour. Validations : chaque paramètre doit avoir clé + valeur uniques.
Le sélecteur de destination {#le-selecteur-de-destination}
Utilisé par les fallbacks (et ailleurs). On choisit d'abord un Type, puis les champs spécifiques apparaissent.
| Type | Champs associés |
|---|---|
| Aucune | — (pas de destination). |
| Utilisateur | Utilisateur cible, durée de sonnerie (optionnelle), musique d'attente. |
| Groupe d'appel | Groupe cible, durée de sonnerie. |
| File d'attente | File cible, durée de sonnerie, règle de compétence + variables. |
| Menu SVI (IVR) | Menu SVI cible. |
| Boîte vocale | Boîte cible, annonce (par défaut / occupé / indisponible), option « ne pas lire les instructions ». |
| Standard opérateur | Standard cible. |
| Conférence | Conférence cible. |
| Route sortante | Route cible + numéro à composer. |
| Application avancée | Annuaire, Portail voicemail, DISA, Callback DISA, Fax vers email, ou Application personnalisée (avec contexte, PIN, e-mail ou UUID selon le cas). |
| Commande personnalisée (avancé) | Commande dialplan (ex. Playback(message)). |
| Jouer un son | Son à jouer, options « jouer sans répondre » et « ignorer si non répondu ». |
| Extension personnalisée | Numéro à composer + plan de numérotation. |
| Raccrochage forcé | Cause (Normal / Occupé / Congestion) + délai éventuel. |
Le journal d'appels (Call Journey) {#le-journal-dappels-call-journey}
Dans le panneau Centre d'appels → Historique, on filtre par Période (jours) (1 à 365) et par Recherche (numéro ou nom). Chaque appel affiche source → destination, un badge de direction (Entrant / Sortant / Interne), un badge « Manqué » si non répondu, et un badge « Enregistrement » si disponible.
En dépliant une ligne, la vue Call Journey reconstitue le parcours réel de l'appel étape par étape (réception, routage, file, agent, messagerie, transfert, raccrochage…) avec horodatage et codes couleur. Si un enregistrement existe, un bouton Télécharger récupère le fichier audio.
État vide : « Aucun appel trouvé pour cet utilisateur. ».
Confirmations, suppressions et messages
Réinitialiser le mot de passe
Titre « Réinitialiser le mot de passe utilisateur de {nom} ? ». Description : « Un nouveau mot de passe de connexion MaxiPBX / WebRTC sera généré et affiché une seule fois. Le mot de passe SIP du téléphone physique n'est pas modifié. ». Le nouveau mot de passe est ensuite affiché dans la modale d'identifiants.
Renvoyer le message de bienvenue
Titre « Renvoyer le message de bienvenue à {nom} ? ». Description : « Un nouveau mot de passe temporaire sera généré puis envoyé par e-mail à l'utilisateur. L'ancien mot de passe de connexion sera invalidé. ». Toast « Message de bienvenue envoyé ».
Supprimer un utilisateur
Titre « Supprimer {prénom} {nom} ? ». Description : « L'extension, la ligne SIP, le compte SIP technique et le compte d'authentification seront supprimés en cascade. Le téléphone associé restera enregistré mais non lié. ». Bouton Supprimer.
La suppression est irréversible et en cascade. Le téléphone physique n'est pas supprimé, mais il perd son association.
Messages d'erreur fréquents
- L'erreur de l'API (« detail ») est affichée en toast rouge pour la plupart des actions (création, édition, import/export, reset, push…).
- Renvoi activé sans numéro → « Destination (numéro) est obligatoire. ».
- Horaire invalide → « Choisis un horaire valide. ».
- Destination de fallback incomplète → « Choisis une destination valide avant de sauvegarder. ».
Actions de masse
- Import CSV : crée plusieurs utilisateurs en une fois (toast indiquant le nombre créé).
- Export CSV : exporte tous les utilisateurs du client.
- Touches programmables : un modèle de touches partagé peut être appliqué à plusieurs utilisateurs (groupes de touches réutilisables).
Pour gérer le parc téléphonique associé, voir la page Téléphonie.