Paramètres

L'écran Paramètres, dans la section Système du menu, réunit tout ce que vous réglez sur la passerelle. Il est organisé en onglets (une liste à gauche, ou un menu déroulant sur téléphone) :

Le transfert des SMS reçus vers vos outils n'est plus un onglet de cet écran : c'est un webhook, géré sur la page Webhooks de la barre latérale. Voir Transfert des SMS reçus.

Les autres rôles voient les onglets du Superadministrateur grisés, avec la note « Ces réglages ne sont modifiables que par un superadministrateur. Vous pouvez les consulter. »

Comment l'enregistrement fonctionne

• Général, appareils et Envoi s'enregistrent ensemble par la barre en bas de l'écran : Enregistrer applique vos changements, Réinitialiser remet les valeurs enregistrées. Un changement non enregistré survit au passage à un autre onglet.
• Chaque enregistrement augmente la Version du parc affichée en haut à droite, et est poussé immédiatement à chaque téléphone connecté (« Réglages enregistrés. Version N poussée aux appareils. »). Un téléphone hors ligne la récupère à sa prochaine connexion. Rien ne demande de redémarrage.
• Les autres onglets s'enregistrent d'eux-mêmes : un interrupteur s'applique dès que vous le basculez, un formulaire quand vous le validez (la sauvegarde automatique de Sauvegarde et export a son propre bouton Enregistrer).
• Chaque modification des réglages de la passerelle est inscrite dans le Journal d'activité.

Affichage (cet ordinateur seulement)

Ces deux réglages, comme la Langue de l'interface de Mon compte, sont conservés dans ce navigateur, pas sur votre compte : chaque ordinateur garde son propre choix, et un collègue sur un autre ordinateur n'est pas concerné. Effacer les données du navigateur ramène les valeurs par défaut. Le thème se change aussi depuis le bouton en haut de chaque écran.

Général, appareils

Ces valeurs sont enregistrées et envoyées à chaque téléphone connecté dès l'enregistrement ; un téléphone hors ligne les reçoit dès qu'il se reconnecte. Des valeurs propres à un seul téléphone ne se règlent que par l'API (PATCH /devices/{id}/settings) : elles remplacent les valeurs ci-dessus pour ce téléphone seulement, et une modification des valeurs ci-dessus ne les efface jamais.

Intervalle de synchronisation. Un intervalle court tient à jour la batterie et le signal affichés dans Appareils ; un intervalle long économise un peu de batterie et de données. Il fixe aussi combien de temps un téléphone silencieux reste considéré en ligne : un téléphone passe hors ligne après cinq minutes sans nouvelles, ou après trois de ses propres intervalles quand c'est plus long (trente minutes pour un intervalle de dix minutes, trois heures pour une heure). Les messages qu'un téléphone devenu muet avait déjà acceptés attendent jusque-là avant de passer à un autre téléphone : gardez la valeur par défaut sauf raison précise. Le changement s'applique à chaque téléphone immédiatement.

Les options de texte (diacritiques, espaces, majuscules) sont appliquées par la passerelle au moment où un message part vers un téléphone, avec les réglages de ce téléphone. L'historique, l'encodage et le nombre de SMS affichés pour le message décrivent le texte réellement envoyé, et les quotas comptent ces SMS. Elles s'appliquent à tout message sortant, quelle que soit son origine (tableau de bord, API, campagne, réponse automatique), jamais aux messages reçus.

• Retirer les diacritiques garde un texte français, espagnol ou italien dans l'alphabet à 160 caractères : 160 caractères par SMS au lieu de 70, souvent deux fois moins de SMS facturés. Les lettres des autres alphabets (grec, cyrillique, arabe, hindi, chinois...) et les emoji ne sont pas touchés : un tel texte reste à 70 caractères par SMS.
• Supprimer les espaces superflus conserve les retours à la ligne et les lignes vides entre les paragraphes.
• Tout en majuscules suit les mêmes règles sur tous les téléphones, quelle que soit leur langue.

Démarrage automatique. Activé, l'application repart après un redémarrage du téléphone ou une coupure de courant. Désactivé, après un redémarrage le téléphone reste hors ligne jusqu'à ce que quelqu'un ouvre l'application dessus ; une fois ouverte, elle se relance comme d'habitude si Android l'arrête. Certains fabricants bloquent aussi le démarrage automatique de leur côté : voir Appareils.

Garder l'écran allumé. Activé, l'écran du téléphone reste allumé à luminosité réduite tant que l'application tourne. Utile sur les téléphones dont le fabricant suspend les applications écran éteint. La consommation de batterie est nettement plus forte : ne l'activez que pour un téléphone qui reste branché, de préférence avec la luminosité au minimum.

Envoi

Les pauses de nuit et du dimanche ne retiennent que les campagnes. Un envoi rapide, un appel d'API, une réponse de conversation ou une réponse automatique part à toute heure. Une campagne prise par une pause reste En cours et reprend d'elle-même à la fin de la pause. Voir Campagnes.

Le détail de chaque option d'envoi se trouve dans Envoyer des messages.

Le fuseau de la plateforme

Le Fuseau horaire de l'onglet Envoi est le fuseau de toute l'installation. Il décide :

• quand la pause de nuit commence et finit, et quand commence le dimanche ;
• comment se lisent la date et l'heure que vous tapez pour programmer une campagne ou un message ;
• comment toutes les dates du tableau de bord s'affichent, quel que soit le fuseau de votre propre ordinateur ;
• le fuseau par défaut des horaires d'ouverture d'une nouvelle règle ;
• l'heure de la sauvegarde automatique quotidienne (Sauvegarde et export).

Exemple : un opérateur à Paris qui programme une campagne à 10 h 00 sur une passerelle réglée sur Indian/Antananarivo la programme à 10 h 00 heure d'Antananarivo ; le formulaire le précise sous le champ. Le quota journalier de chaque SIM n'est pas concerné : il repart à zéro à minuit UTC.

Auto-répondeur

Une seule option, Envoyer les réponses automatiques (par défaut : activé). Éteint, plus aucune règle n'envoie de réponse, tandis que les étiquettes, les groupes et les actions webhook continuent. L'onglet résume aussi vos règles. Voir Automatisation.

Notifications

La passerelle peut prévenir les administrateurs quand quelque chose demande de l'attention, sur trois canaux que vous activez séparément. Modifier cet onglet est réservé à un superadministrateur ; la carte Ce navigateur, en bas, est ouverte à tous les utilisateurs.

Ce qui déclenche une alerte

Pour chaque alerte, cochez les canaux qu'elle utilise (SMS, E-mail, Navigateur). Un canal coché n'envoie que s'il est aussi activé dans sa propre carte.

Délai avant répétition (0 à 1440 minutes, 60 par défaut) : la même alerte sur le même téléphone, la même SIM ou le même webhook n'est pas renvoyée pendant ce temps. Un téléphone qui décroche et revient sans cesse vous envoie donc une alerte, pas une par reconnexion. Une alerte dont la cause persiste n'est pas répétée du tout ; elle peut revenir une fois la cause disparue et le délai écoulé.

Langue des alertes (français par défaut) : la langue des SMS, des e-mails et des notifications, quelle que soit la langue de l'écran de chaque utilisateur.

Une alerte ne contient jamais le texte d'un SMS ni un numéro complet : elle nomme le téléphone comme vous l'avez nommé, la SIM par son emplacement, et donne des nombres.

SMS

La passerelle envoie l'alerte elle-même, par l'une de vos SIM, aux Numéros des administrateurs (format international, 10 au plus). Elle choisit un autre téléphone que celui dont parle l'alerte dès qu'un autre peut envoyer : l'alerte « téléphone hors ligne » part par exemple d'un autre téléphone. Si aucune SIM ne peut envoyer, le SMS est sauté et les autres canaux partent quand même. Les SMS d'alerte partent à toute heure : les pauses de nuit et du dimanche ne retiennent que les campagnes, et une alerte n'est jamais comptée comme un message de campagne. Chaque SMS d'alerte apparaît dans la file d'attente et consomme le quota du jour de la SIM qui l'envoie.

Envoyer un SMS de test met en file un SMS de test par numéro, avec les réglages enregistrés.

E-mail

Les alertes passent par votre propre serveur de messagerie ; rien ne transite par nous.

Envoyer un e-mail de test se connecte au serveur et envoie un e-mail avec les réglages enregistrés. En cas d'échec, le message montre la réponse du serveur (par exemple « 535 authentication failed »).

Notifications du navigateur

Avec Notifications du navigateur activé, les alertes arrivent :

• sur chaque navigateur abonné par un utilisateur, en notification du système, même dashboard fermé ;
• dans chaque dashboard ouvert, en message dans la page accompagné d'un son bref.

Dans Ce navigateur, chaque utilisateur clique sur Activer sur ce navigateur et accepte la demande d'autorisation du navigateur, puis peut Envoyer une notification de test. La liste montre les navigateurs abonnés par votre compte, avec la date de leur dernière notification ; l'icône corbeille en désabonne un. Son des alertes dans la page est mémorisé sur ce navigateur seulement (activé par défaut).

Les notifications dashboard fermé exigent une adresse sécurisée : le dashboard doit être ouvert en HTTPS, ou sur localhost. Une passerelle ouverte en http simple par son adresse IP ne peut pas les proposer, et l'onglet le dit ; les alertes s'affichent alors quand même, avec leur son, dans chaque dashboard ouvert. Donnez à votre passerelle un nom de domaine en HTTPS (voir le guide d'installation) pour les recevoir dashboard fermé.

Par l'API

Les noms de champs suivent l'écran : sending.retryEnabled, sending.maxAttempts, sending.backoffSeconds, sending.ackTimeoutSeconds, sending.ratePerMinutePerSim, sending.minIntervalSecondsPerSim, window.timezone, window.nightPauseEnabled, window.nightPauseFrom, window.nightPauseTo, window.pauseOnSunday, device.syncIntervalSeconds, device.stripDiacritics, device.trimWhitespace, device.uppercase, device.autoStart, device.keepScreenOn, autoresponder.enabled, backup.enabled, backup.frequency (daily ou interval), backup.dailyAt, backup.intervalHours, backup.retention. Exemple :

curl -X PATCH https://sms.exemple.com/api/v1/settings \
  -H "X-API-KEY: $API_KEY" -H "Content-Type: application/json" \
  -d '{"window": {"timezone": "Europe/Paris", "nightPauseEnabled": true}}'

Modifier les réglages demande une clé de portée admin. Voir Clés API.

Ce qui n'est pas dans cet écran

Certaines valeurs se choisissent à l'installation de la passerelle et ne changent qu'avec un redémarrage : l'adresse publique, le port, le niveau de log, la conservation du journal d'activité, le mode de routage automatique. Ce sont des variables du fichier .env, décrites dans le guide d'installation. Aucun réglage de cet écran n'a d'équivalent en variable d'environnement, et aucune variable d'environnement ne se modifie ici.

En cas de problème