Utilisateurs et rôles

Chaque personne qui ouvre le tableau de bord devrait avoir son propre compte. Un compte a un rôle qui décide de ce qu'il peut faire, et chaque connexion et chaque modification de compte apparaît dans le Journal d'activité.

Les comptes se gèrent dans Paramètres > Utilisateurs et rôles. Votre propre compte se trouve dans Paramètres > Mon compte.

Les trois rôles

Rôle	En une phrase
Lecture seule	Consulte tout, ne modifie rien
Opérateur	Envoie, répond, gère contacts, modèles, règles, campagnes et webhooks, sans toucher aux comptes ni aux réglages
Superadministrateur	Fait tout, y compris gérer les comptes, la licence, les réglages, les clés API, les sauvegardes et l'appairage des téléphones

En détail :

Quoi	Lecture seule	Opérateur	Superadministrateur
Voir conversations, contacts, campagnes, file d'attente, appareils, règles	oui	oui	oui
Afficher l'aperçu d'un modèle, utiliser le testeur de règle	oui	oui	oui
Exporter messages, contacts, conversations (CSV, JSON)	oui	oui	oui
Envoyer (envoi rapide, réponse de conversation), relancer un message	non	oui	oui
Gérer contacts, groupes, modèles, règles, campagnes, liens courts	non	oui	oui
Gérer le transfert des SMS reçus et les webhooks	non	oui	oui
Voir le Journal d'activité	non	oui	oui
Voir les logs techniques	non	non	oui
Appairer ou retirer un téléphone, modifier les réglages des appareils	non	non	oui
Modifier les paramètres (envoi, pauses, fuseau, interrupteur de l'auto-répondeur)	non	non	oui
Créer, modifier ou révoquer des clés API	non	non	oui
Sauvegardes, restauration, téléchargement de la base complète	non	non	oui
Activer ou revérifier la licence	non	non	oui
Créer, modifier, désactiver ou supprimer des comptes	non	non	oui

Le tableau de bord masque ou désactive ce que votre rôle ne permet pas, et un compte Lecture seule voit un bandeau qui le rappelle. La passerelle applique les mêmes règles de son côté : une action refusée l'est aussi si quelqu'un tente de la faire autrement.

Les sauvegardes et le téléchargement de la base complète sont fermés aux autres rôles, même en lecture : ils contiennent tous les comptes.

Quel rôle donner ? Lecture seule pour un responsable qui suit les chiffres, Opérateur pour les personnes qui répondent aux clients et mènent les campagnes, Superadministrateur pour une ou deux personnes responsables de l'installation.

Gérer les comptes (Superadministrateur)

Paramètres > Utilisateurs et rôles liste tous les comptes avec leur Rôle, leur Statut (Actif ou Désactivé) et leur Dernière connexion. Votre propre ligne porte la mention Vous. Les autres rôles voient la liste mais aucun bouton.

Créer un compte

Cliquez sur Nouvel utilisateur :

Option	Valeurs admises	Effet
Nom	1 à 100 caractères	Affiché dans la liste et dans le journal d'activité
Adresse e-mail de connexion	Une adresse valide, non utilisée par un autre compte	Ce avec quoi la personne se connecte. Les majuscules ne comptent pas
Rôle	Lecture seule, Opérateur, Superadministrateur	Ce que le compte peut faire
Mot de passe initial	12 caractères au minimum	Transmettez-le par un canal sûr : vous ne pourrez plus le relire. La personne peut le changer depuis son profil

Aucun e-mail n'est envoyé : donnez à la personne l'adresse du tableau de bord, son adresse de connexion et le mot de passe.

Actions sur un compte

Le menu de chaque ligne (sauf la vôtre) propose :

Action	Effet
Changer le rôle	S'applique dès la prochaine action de la personne, sans la déconnecter
Définir un nouveau mot de passe	Pour une personne qui a oublié le sien. Elle est déconnectée partout et doit utiliser le nouveau mot de passe
Désactiver	Déconnecte la personne immédiatement et bloque la connexion. Le compte et son historique sont conservés ; Réactiver rend l'accès
Supprimer	Supprime définitivement le compte et ses sessions. Ce que la personne a fait reste, sans auteur. Pour garder la trace, préférez Désactiver

Deux règles de sécurité s'appliquent :

Vous ne pouvez pas changer votre propre rôle, vous désactiver ni vous supprimer, ni réinitialiser votre propre mot de passe depuis cet écran (passez par Mon compte). Un autre Superadministrateur doit le faire.
L'installation garde toujours au moins un Superadministrateur actif. Rétrograder, désactiver ou supprimer le dernier est refusé.

Gardez deux comptes Superadministrateur. Il n'existe pas d'e-mail « mot de passe oublié » : un Superadministrateur qui perd son mot de passe est débloqué par un autre Superadministrateur avec Définir un nouveau mot de passe. Avec un seul Superadministrateur, un mot de passe perdu ne laisse plus personne capable de gérer les comptes.

Votre propre compte : Paramètres > Mon compte

Option	Où	Effet
Nom	Profil	Votre nom affiché, de 1 à 100 caractères
Adresse e-mail	Profil	L'adresse avec laquelle vous vous connectez. La changer demande votre Mot de passe actuel
Rôle	Profil	Affiché seulement : un Superadministrateur le change
Langue de l'interface	Profil	Anglais, français, espagnol ou italien. Enregistrée dans ce navigateur, pas sur votre compte
Mot de passe	Mot de passe	Mot de passe actuel, Nouveau mot de passe (12 caractères au minimum, différent de l'actuel), Confirmer le nouveau mot de passe

Cliquez sur Enregistrer le profil ou Changer le mot de passe. Changer votre mot de passe déconnecte toutes vos autres sessions (autres ordinateurs, autres navigateurs) et garde celle-ci ouverte : pratique si vous vous êtes connecté sur un ordinateur partagé sans vous déconnecter.

Une longue phrase fait un meilleur mot de passe qu'un mot court et compliqué.

Connexion et sessions

Une session reste ouverte 7 jours après votre dernière activité, puis vous demande de vous reconnecter. Se déconnecter, dans le menu, la ferme immédiatement.
Après 5 tentatives échouées, depuis la même adresse ou sur le même compte, la connexion est bloquée 30 secondes, puis deux fois plus longtemps à chaque nouvel échec, jusqu'à 15 minutes. Le compteur est oublié après 15 minutes sans échec. Le message d'erreur est le même pour une adresse inconnue, un mauvais mot de passe et un compte désactivé, pour que personne ne puisse tester quelles adresses existent.
Les connexions refusées apparaissent dans le journal d'activité, catégorie Sécurité, avec leur raison.

Le premier compte

Le tout premier compte d'une installation se crée sur l'écran de mise en service, avec le code d'installation affiché par l'installeur (sms-gateway setup-code l'affiche à nouveau). Ce compte est Superadministrateur. Voir le guide d'installation.

Comptes et clés API

Une clé API n'est pas un compte : elle appartient à un outil, pas à une personne, et a sa propre portée. Les clés se gèrent dans Clés API, par un Superadministrateur. Voir Clés API.

Par l'API

Méthode	Chemin	Qui	Ce qu'il fait
`GET`	`/api/v1/users`	Toute session	Liste les comptes
`POST`	`/api/v1/users`	Superadministrateur	Crée un compte (`email`, `name`, `role`, `password`)
`PATCH`	`/api/v1/users/{userId}`	Superadministrateur	Change `name`, `role`, `disabled`
`POST`	`/api/v1/users/{userId}/password`	Superadministrateur	Définit un nouveau mot de passe
`DELETE`	`/api/v1/users/{userId}`	Superadministrateur	Supprime le compte

Valeurs de rôle : viewer (Lecture seule), operator, superadmin. Les modifications de comptes exigent un Superadministrateur connecté : une clé API, même de portée admin, ne peut que lire la liste.

En cas de problème

Ce que vous voyez	Pourquoi, et que faire
« L'installation doit garder au moins un superadministrateur actif. »	Vous rétrogradez, désactivez ou supprimez le dernier Superadministrateur. Promouvez d'abord quelqu'un d'autre
« Cette adresse est déjà utilisée par un autre compte. »	Deux comptes ne peuvent pas partager une adresse, même avec des majuscules différentes
Connexion refusée avec « Trop de requêtes. Réessayez dans un instant. »	Attendez la fin du blocage (15 minutes au plus), puis vérifiez l'adresse et le mot de passe
Un collègue ne voit pas Journal	Son compte est en Lecture seule
Le seul Superadministrateur a oublié son mot de passe	Personne ne peut le réinitialiser depuis le tableau de bord : d'où l'intérêt d'un second compte Superadministrateur