MaxiPBX
Administration

Téléphones

Téléphones

Route : /admin/devices

Cette page gère le parc de téléphones physiques d'un client : ajout, affectation aux utilisateurs, provisioning automatique, diagnostic et actions de maintenance (synchronisation, redémarrage, réparation, enrôlement cloud). Toutes les actions portent sur le client sélectionné dans la barre supérieure.

En-tête et actions globales

  • Titre : « Téléphones ».
  • Sous-titre : « {n} téléphones · {client} » (« Sélectionnez un client » si aucun client).

Boutons d'action (en haut à droite). Tous sont désactivés tant qu'aucun client n'est sélectionné :

Bouton Effet
Téléphones détectés Ouvre la liste des téléphones vus par le serveur mais pas encore attribués. Un badge indique leur nombre.
Ajouter en bloc Ouvre la modale d'ajout en masse (collage / import de MAC).
Assigner un téléphone Ouvre la modale d'édition sur le premier téléphone libre (ou le premier de la liste).
Ajouter un téléphone Ouvre la modale de création d'un téléphone.

Indicateurs (métriques)

Une rangée de cartes résume le parc :

Métrique Signification
Total Nombre total de téléphones.
Assignés Téléphones affectés à au moins un utilisateur.
Libres Téléphones sans utilisateur.
Cloud Téléphones enrôlés en RPS (provisioning zéro-touch).
Détectés Téléphones détectés non encore attribués.

Panneau « Plan d'action téléphones »

Un encadré met en avant les téléphones nécessitant une intervention. Son cadre est ambre s'il y a des incidents, vert sinon.

  • Badge « À traiter » ou « Parc OK ».
  • Description : « {x} à corriger · {y} à surveiller · {z} libres · {w} détectés non attribués », ou « Aucun problème prioritaire détecté sur les téléphones visibles. »
  • Raccourcis de filtrage : À corriger ({n}), À surveiller ({n}), Libres ({n}), Détectés ({n}).
  • Actions : Ajouter un téléphone, Renvoyer configs (synchronise les téléphones visibles), Réparer ({n}) (lance la réparation des téléphones visibles en défaut).

Recherche et filtres

  • Champ de recherche : « Rechercher MAC, modèle, utilisateur, IP... ». Filtre sur MAC, marque, modèle, numéro de série, description, IP, version et utilisateurs.
  • Synchronisation de masse : bouton « Envoyer configs visibles » (envoie la config aux téléphones visibles). Pendant l'opération : « Envoi {fait}/{total} ».
  • Réparation de masse : bouton « Réparer visibles » (visible s'il existe des candidats à réparer). Pendant l'opération : « Réparation {fait}/{total} ».

Filtres (chacun avec un compteur) :

Filtre Sélection
Tous Tous les téléphones.
Assignés Avec au moins un utilisateur.
Libres Sans utilisateur.
RPS Enrôlés dans le cloud.
Multi-comptes Plus d'un utilisateur.
À corriger Diagnostic en échec.
À surveiller Diagnostic en avertissement.
OK Diagnostic sain.

Messages de fin d'opération de masse : « {n} configuration(s) envoyée(s) » / « {n} téléphone(s) réparé(s) », ou « {fait} … · {échec} en échec » en cas de réussite partielle. Si rien n'est à traiter : « Aucun téléphone visible … ».

La liste des téléphones

Chaque ligne affiche :

  • la marque et le modèle (libellé du catalogue) et la MAC formatée (00:15:65:AB:C1:23) ;
  • l'utilisateur affecté (« → Nom · ext »), l'IP et la version firmware (fw …) si connues ;
  • éventuellement un problème principal détecté et l'action conseillée.

Badges d'état :

Badge Signification
OK / À surveiller / À corriger Niveau de diagnostic (vert / ambre / rouge). Infobulle = liste des problèmes détectés.
Enregistré / Hors ligne État téléphonie réel (le téléphone peut-il sonner ?). Affiché si une ligne SIP est associée.
Statut indisponible Le statut n'a pas pu être récupéré.

Actions par ligne (icônes) :

Icône Action
Lien externe Ouvrir l'admin web du téléphone (si une IP est connue).
Nuage (bleu) « Ajouter au cloud Yealink » (RPS). Visible pour les Yealink non encore enrôlés.
Flèches circulaires « Envoyer la configuration » (sync).
Nuage montant « Envoyer config + reboot » : synchronise puis redémarre.
Clé à molette « Réparer ce téléphone » (workflow de réparation).
Bouton d'alimentation « Redémarrer ».
Crayon « Modifier les utilisateurs » : ouvre la modale d'édition complète.
Corbeille Supprimer le téléphone.

États particuliers de la liste

  • Aucun client : « Sélectionnez un client ».
  • Chargement : lignes grisées.
  • Erreur : message d'erreur en rouge.
  • Aucun téléphone : « Aucun téléphone enregistré ».
  • Aucun résultat de filtre : « Aucun téléphone ne correspond à ces filtres. »
  • Un bandeau ambre signale les erreurs partielles (utilisateurs ou catalogue indisponibles).

Modale « Ajouter un téléphone »

Description : « Le téléphone recevra automatiquement sa configuration. Pour les modèles compatibles et si le service cloud est configuré, il suffit de le brancher. » Un fil d'étapes indique : Identité appareil → Assignation → Provisioning. Deux onglets : Essentiel et Options avancées.

Onglet Essentiel

Champ Type Obligatoire Détails
Adresse MAC Texte Oui Toute syntaxe acceptée (00:15:65:AB:C1:23 ou 001565abc123). Doit contenir 12 caractères hexadécimaux, sinon : « MAC invalide (12 hex) ».
Numéro de série Texte Non Recommandé pour Yealink ; imprimé sous le téléphone. Donne au cloud une preuve supplémentaire.
Marque Liste Oui Marques du catalogue. Le suffixe « · RPS » indique le support du provisioning cloud.
Modèle Liste Oui Modèles de la marque choisie. Sélection automatique du premier modèle disponible.
Utilisateurs (optionnel) Sélecteur multiple Non Plusieurs utilisateurs possibles (bases DECT, multi-comptes). Le premier est le compte principal : sa langue et son fuseau horaire sont appliqués au téléphone.

Si marque ou modèle manquent : « Choisis une marque et un modèle. »

Onglet Options avancées

Champs officiels pour intégrateurs (laisser vide si inutile) :

Champ Type Détails
Description Texte Libellé libre.
Adresse IP déclarée Texte IP connue du téléphone.
Version firmware Texte Version du firmware.
Plugin de provisioning Texte Ex. yealink-v89.
Modèle de téléphone Texte Identifiant de modèle de provisioning.
Téléphone de standard Interrupteur Marque le poste comme téléphone de standard.

Boutons : Annuler et Créer.

Modale « Ajouter en bloc »

Description : « Colle une liste d'adresses MAC, une par ligne. Tous les téléphones partageront la même marque et le même modèle. Maximum 500 par opération. »

Champ Type Détails
Marque / Modèle Listes Communs à tous les téléphones créés.
Adresses MAC Zone de texte + import CSV/TXT Une MAC par ligne. Séparateurs acceptés : espace, virgule, point-virgule, tab, saut de ligne. Les MAC déjà existantes sont ignorées. Un import CSV/TXT extrait automatiquement les MAC de n'importe quelle colonne. Un compteur indique le nombre de MAC valides détectées.
Utilisateurs à assigner à chaque téléphone Sélecteur multiple Optionnel ; les mêmes utilisateurs sont ajoutés sur chaque téléphone.

Validation : « Aucune MAC valide détectée. Une par ligne. » ou « Trop de MAC (max 500). ». Bouton : « Créer {n} téléphone(s) ».

Modale « Téléphones détectés »

Liste des téléphones vus par le serveur mais non attribués au client. Description : « Téléphones vus par le serveur mais pas encore attribués. Attribue-les au client {client}, puis termine leur configuration si besoin. »

Chaque entrée affiche marque/modèle, MAC, identifiant, IP, firmware, plugin et statut. Bouton Attribuer par ligne. États : « Aucun téléphone non attribué détecté. », chargement, ou erreur. Bouton Fermer.

Modale « Modifier le téléphone »

Ouverte via le crayon ou « Assigner un téléphone ». Titre : « Modifier le téléphone » ; sous-titre = marque, modèle et MAC. Un fil d'étapes indique Assignation → Provisioning → Diagnostic. Quatre onglets : Utilisateurs, Provisioning, Statut, Avancé.

Onglet Utilisateurs

Champ Type Détails
Utilisateurs Sélecteur multiple Plusieurs utilisateurs possibles ; les lignes sont ajoutées/retirées automatiquement.
Langue appliquée (compte 1) Lecture seule Langue héritée du compte principal.
Fuseau horaire appliqué (compte 1) Lecture seule Fuseau hérité du compte principal.
Numéro de série (SN) Texte Affiché uniquement pour les Yealink. Imprimé sous le téléphone.

Un rappel indique le compte principal (compte 1) : sa langue et son fuseau horaire pilotent le téléphone.

Onglet Provisioning

  • Profil rapide (liste) : applique des réglages préconfigurés. Valeurs :
    • Bureau standard : standard, sans options.
    • Réception / standard : active le mode standard et le rétroéclairage BLF.
    • Chambre hôtel : réglages neutres.
    • Call center : active rétroéclairage BLF et priorité casque.
  • Téléphone de standard (interrupteur).
  • Mot de passe admin téléphone (mot de passe) : définit le mot de passe d'administration GUI du téléphone.
  • URL fond d'écran (texte) : image de fond.
  • Rétroéclairage BLF (interrupteur).
  • Priorité casque (interrupteur).
  • Bouton Appliquer au téléphone : enregistre ces réglages rapides et pousse la config.

Paramètres custom : tableau clé/valeur libre (ex. clé features.blf_active_backlight.enable, valeur 1).

  • Bouton + pour ajouter une ligne, corbeille pour en retirer une.
  • État vide : « Aucun paramètre custom ».
  • Bouton Appliquer les paramètres : envoie les paramètres custom au téléphone.

Onglet Statut

Diagnostic complet du téléphone :

  • Synthèse : « Téléphone opérationnel / à surveiller / à corriger », avec la liste des problèmes détectés et les actions conseillées (réinitialiser le provisioning, réparer, assigner un utilisateur, contrôler réseau/téléphone, enrôler RPS/YMCS).
  • Tuiles de diagnostic : SIP (Enregistré / Hors ligne), Provisioning (Configuré / Non configuré), RPS/YMCS (Enrôlé / Non enrôlé), Dernier check-in, IP LAN, IP publique, Firmware.
  • Actions : Ouvrir l'admin web, Tester accès web, Copier identifiants admin, Envoyer la configuration, Envoyer config + reboot, Réparer ce téléphone, Redémarrer, et (Yealink non enrôlé) Ajouter au cloud Yealink.
  • Résultat du test web : « Interface web joignable / non joignable », avec URL, code HTTP et durée.
  • Résultat de réparation : détail étape par étape (Provisioning MaxiPBX, Langue et fuseau horaire, Régénération config, Envoi check-sync, Accès web téléphone, Statut final) avec statut par étape.
  • Identifiants et réseau : utilisateur et mot de passe GUI web, IP publique, IP LAN, version firmware (lecture seule).
  • Dernières actions (chronologie) : derniers événements horodatés (réparation, envoi config, redémarrage, enrôlement RPS, assignation, provisioning, check-in, création/modification…), classés du plus récent au plus ancien, avec un état (OK / Attention / Échec / Info). État vide : « Aucun événement disponible. »

Onglet Avancé

  • Description (texte modifiable).
  • Version firmware (lecture seule).

Boutons de la modale

  • Annuler : ferme sans enregistrer.
  • Enregistrer : sauvegarde les utilisateurs, le SN, la description et l'option standard.

Actions de maintenance (récapitulatif)

Action Effet
Envoyer la configuration (sync) Pousse la configuration de provisioning vers le téléphone.
Envoyer config + reboot Synchronise puis redémarre le téléphone.
Redémarrer Redémarre le téléphone.
Réparer Workflow de réparation (re-provisioning, régénération de config, check-sync, etc.).
Ajouter au cloud Yealink (RPS/YMCS) Enrôle un Yealink dans le cloud de provisioning zéro-touch.
Ouvrir l'admin web Ouvre l'interface web du téléphone (nécessite une IP joignable).

Suppression d'un téléphone

La corbeille ouvre une confirmation :

  • Titre : « Retirer {marque} {modèle} ? »
  • Description : « L'appareil sera retiré du provisioning et de Yealink RPS. Le téléphone physique perdra sa configuration au prochain redémarrage. »
  • Confirmer : « Supprimer » (action destructive).