Appareils

Un appareil est un téléphone Android équipé de l'application et appairé à votre passerelle. C'est le téléphone, et non la passerelle, qui envoie et reçoit les SMS, avec ses propres cartes SIM et son propre forfait. Vous pouvez appairer autant de téléphones que vous le souhaitez : la passerelle répartit le trafic entre eux et prend le relais quand l'un d'eux décroche.

Tout ce qui suit se passe dans l'écran Appareils du tableau de bord.

Ce qu'il vous faut

• Un téléphone Android (un modèle modeste et dédié suffit) avec une ou deux cartes SIM disposant d'un forfait SMS ou de crédit.
• Un chargeur qui reste branché. Voir Garder le téléphone en service.
• Une connexion réseau entre le téléphone et la passerelle : Wi-Fi ou données mobiles. Le téléphone doit pouvoir joindre l'adresse de votre passerelle.
• Un compte Superadministrateur : l'appairage, le désappairage et la modification des quotas lui sont réservés.

Installer l'application

L'application est distribuée hors du Play Store. Dans Appareils, le panneau Application Android affiche un code QR : photographiez-le avec l'appareil photo du téléphone pour télécharger l'application, ou utilisez Télécharger l'APK. Android demande d'autoriser l'installation depuis le navigateur : c'est normal pour une application qui ne vient pas du Play Store.

Si le panneau indique qu'aucune application n'est déposée sur la passerelle, le fichier APK n'a pas été placé sur votre installation. Voir le guide d'installation.

Si Android refuse de l'installer

Google Play Protect examine toute application qui ne vient pas du Play Store, et peut la refuser avec « Application dangereuse bloquée » ou « Analyse de l'application ». L'application n'est pas dangereuse : elle est simplement inconnue de Google, parce qu'elle est la vôtre et qu'elle est servie par votre propre passerelle.

Le panneau de téléchargement affiche l'empreinte SHA-256 du fichier : c'est elle qui prouve que l'APK est bien celui que votre passerelle détient. Le tableau de bord porte aussi ce guide, sous le QR code de Appairer un appareil.

Au premier lancement, l'application demande quelques autorisations :

Ce que l'application affiche sur le téléphone

L'écran d'accueil de l'application est une page d'état, pas un poste de pilotage : l'état de la connexion, les cartes SIM trouvées, le nombre de SMS partis aujourd'hui, le nombre envoyé et reçu sur les 24 dernières heures, et une frise de connexion sur 24 heures, une barre par heure, la plus ancienne à gauche. Une barre courte est une heure passée loin de la passerelle, quelle qu'en soit la raison. Cet historique appartient au téléphone : il est conservé même quand la passerelle est injoignable, c'est-à-dire exactement quand vous voulez le lire.

La notification permanente qu'Android impose porte le même résumé : connecté ou en reconnexion, SMS envoyés et reçus sur 24 heures, et combien attendent. Ne pas y toucher est ce qui permet à Android de garder l'application en vie (voir Garder le téléphone en vie).

Appairer un téléphone

1. Dans Appareils, cliquez sur Appairer un appareil. Un code QR s'affiche, valable cinq minutes.
2. Dans l'application, choisissez Appairer et scannez le code.
3. Le téléphone apparaît dans la liste, En ligne, avec ses cartes SIM.

Pas d'appareil photo utilisable ? Sous le code QR, la fenêtre affiche un Code de repli, sans caméra de huit caractères. Dans l'application, touchez Saisir le code à la main, puis entrez l'adresse du serveur et ce code.

Chaque code ne sert qu'une fois et expire au bout de cinq minutes. S'il a expiré, cliquez sur Générer un nouveau code. Le code QR est signé par votre passerelle : un code modifié ne peut pas amener un téléphone à s'appairer à un autre serveur.

Connexion chiffrée ou non

Le téléphone se connecte à l'adresse encodée dans le code QR, c'est-à-dire l'adresse publique de votre passerelle (GATEWAY_PUBLIC_URL) :

En http:// simple sur internet, messages, numéros de téléphone et secret d'appairage circulent en clair : toute personne sur le trajet réseau peut les lire. L'application pose la question une fois par adresse de passerelle : les reconnexions et les nouveaux codes QR de la même passerelle ne la reposent pas, une autre adresse la repose, de même qu'un nouvel appairage après Désappairer. Si vous touchez Annuler, rien n'est envoyé ; touchez Scanner de nouveau pour revoir l'avertissement. Le HTTPS reste le choix recommandé, voir Sécurité.

Suivre vos téléphones

Le tableau Appareils montre, pour chaque téléphone :

Un téléphone connecté donne des nouvelles toutes les trente secondes, ou selon l'Intervalle de synchronisation réglé dans Paramètres > Général, appareils. Après cinq minutes sans nouvelles, ou trois de ses intervalles quand c'est plus long (trente minutes pour un intervalle de dix minutes), la passerelle le marque Hors ligne. Les messages que ce téléphone détenait retournent dans la file et partent d'un autre téléphone, sans compter comme une tentative échouée : le message n'y est pour rien, c'est le téléphone qui a disparu.

La passerelle publie aussi un événement quand un téléphone se connecte (device.online), décroche (device.offline) ou quand sa batterie passe sous 15 % (device.low_battery, émis une fois au franchissement du seuil, pas à chaque relevé en dessous). Abonnez un webhook à ces événements pour être prévenu dans vos propres outils : voir Webhooks.

Actions sur un téléphone

Depuis la colonne Actions (Superadministrateur) :

Retirer un téléphone utilisé par vos règles de routage

Un téléphone nommé par des règles de routage n'est pas retiré en silence. Le retrait s'arrête, liste les règles qui envoient par lui, nommées, et demande ce que devient chacune : la confier à une autre SIM, ou supprimer la règle. Rien de ce que vous avez configuré ne disparaît sans que vous le sachiez, et le réacheminement part avec le retrait.

Une chose n'est pas dans cette liste, volontairement : le téléphone qu'une conversation préfère pour répondre. C'est une préférence que la passerelle reconstruit seule dès que le correspondant répond, elle est simplement oubliée.

Le journal propre au téléphone

La passerelle ne voit jamais que ce qu'un téléphone a eu le temps de lui dire. Quand Android tue l'application, quand le réseau tombe, quand un envoi est refusé avant d'atteindre la radio, la raison ne quitte jamais l'appareil. L'application tient donc son propre journal, sur le téléphone, pendant sept jours.

Pour l'ouvrir : tapez trois fois, rapidement, dans le coin en bas à gauche de l'écran de l'application. Il n'y a volontairement aucun bouton à cet endroit : c'est un outil de diagnostic, lu une fois par an, qui encombrerait l'écran principal le reste du temps. Il fonctionne aussi sur l'écran d'appairage, c'est-à-dire précisément là où vous en avez besoin quand un téléphone refuse de s'appairer.

Pour l'envoyer ici : ouvrez ce journal sur le téléphone, choisissez la journée, et appuyez sur Envoyer à la passerelle. Vous le lirez ensuite dans Appareils, dans le menu de ce téléphone, sous Journal interne. Rien ne part tout seul : un téléphone qui téléverserait ses journaux de lui-même dépenserait vos données sans qu'on le lui demande.

Ce qu'il ne contient jamais : aucun contenu de message, aucun numéro complet. Les deux sont retirés sur le téléphone, au moment où la ligne est écrite, et non au moment où on l'affiche. Les codes courts restent lisibles, parce qu'ils désignent un service et non un abonné.

Nommer vos téléphones et leurs cartes SIM

Les règles de routage, le journal et les écrans d'envoi désignent tous des cartes SIM. Un parc qu'on ne sait pas lire est un parc qu'on ne pilote pas : le dashboard vous demande donc de nommer ce qu'il ne connaît pas encore, chaque téléphone et chaque SIM qu'il porte. Donnez-leur des noms que vous reconnaîtrez dans six mois, par exemple « Accueil » et « Ligne clients ».

Le nommage est réservé à un superadmin. Les autres voient une note qui leur dit à qui s'adresser.

Quand une carte SIM semble avoir été changée

Si la carte d'un emplacement ne correspond plus à celle que vous aviez confirmée, le dashboard vous le dit et vous demande de confirmer ce qui s'y trouve maintenant. Rien n'est renommé et rien n'est réacheminé tout seul : le nom que vous aviez donné reste, et les messages continuent de partir de cet emplacement.

Il dit semble, et c'est volontaire. Android réserve le numéro de série d'une carte SIM aux applications privilégiées : aucune application ordinaire ne peut donc identifier une carte avec certitude. La passerelle compare ce que le téléphone expose vraiment : l'opérateur, le numéro quand l'opérateur le publie, et l'identifiant d'abonnement qu'Android donne à la carte. Deux conséquences à connaître :

• Une carte échangée contre une autre du même opérateur peut passer inaperçue sur un téléphone dont l'application est antérieure à la 1.1.2, parce que la plupart des opérateurs ne publient pas le numéro.
• Une réinitialisation d'usine peut faire paraître une carte nouvelle alors que rien n'a changé. Confirmez l'emplacement et la question disparaît.

Nommer un emplacement le confirme aussi : la carte qui s'y trouve devient la référence et l'avertissement s'efface. Si vous remettez simplement la carte d'origine, il s'efface tout seul.

Historique de disponibilité

La passerelle conserve l'historique de connexion de chaque téléphone, pour distinguer un téléphone fiable d'un téléphone qui décroche sans cesse. Vous le voyez à deux endroits :

• la carte Disponibilité des appareils du Tableau de bord, sous le graphique d'activité (les huit premiers téléphones, avec un lien vers les autres) ;
• la même carte sous le tableau de l'écran Appareils, pour toute la flotte, et la colonne Disponibilité (24 h) du tableau.

Choisissez la période avec les boutons 24 h, 7 j, 30 j et 90 j. Chaque téléphone a sa ligne : son nom, son statut actuel, son pourcentage de disponibilité sur la période, et une barre par tranche (une par heure sur 24 heures, par six heures sur 7 jours, par jour sur 30 et 90 jours). Les tranches suivent le fuseau de la plateforme (Paramètres > Envoi), changement d'heure compris : le jour d'un changement d'heure dure 23 ou 25 heures. Survolez ou touchez une barre pour les heures exactes de la tranche et la durée passée dans chaque état. En haut de la carte, Disponibilité de la flotte donne un chiffre unique pour tous vos téléphones.

Chaque barre répartit le temps entre trois états, distingués par leur position, un mot et une icône dans la légende et l'infobulle, jamais par la seule couleur :

Une tranche d'avant l'appairage reste une piste vide : un téléphone appairé ce matin n'est pas compté hors ligne pour la nuit précédente.

Pourquoi un téléphone a disparu

La carte porte un lien Pourquoi ?, qui ouvre la liste de toutes les absences de la période : quel téléphone, depuis quand, pendant combien de temps, et ce qui l'a causée. Quand il y a de quoi comparer (au moins deux causes et trois absences), un petit graphique classe les principales causes au-dessus de la liste.

Les deux tiers de ce tableau ne sont connus que du téléphone, et il ne peut les dire à la passerelle qu'à son retour : une absence en cours affiche ce que la passerelle a observé, et prend sa vraie cause à la connexion suivante.

Le calcul du pourcentage. La disponibilité est le temps en ligne divisé par le temps en ligne plus hors ligne. Le temps où la passerelle était arrêtée n'est pas compté hors ligne : une mise à jour de la passerelle pendant la nuit ne fait pas baisser la disponibilité de vos téléphones. Quand rien n'a été observé sur la période (la passerelle était arrêtée tout le temps), la carte affiche Aucune donnée plutôt que 0 %.

La durée de conservation. L'historique est conservé 90 jours par défaut, la plus longue période du graphique. Réglez GATEWAY_UPTIME_RETENTION_DAYS (de 90 à 3650) pour le garder plus longtemps, voir le guide d'installation. L'historique commence quand vous installez une version de la passerelle qui l'enregistre : le temps antérieur se lit comme inconnu. Désappairer un téléphone efface son historique.

Par l'API. GET /devices/uptime?period=24h (ou 7d, 30d, 90d) renvoie le même rapport : pour chaque téléphone et chaque tranche, les secondes en ligne, hors ligne, inconnues et avant l'appairage, plus uptimePercent (null quand rien n'a été observé). Toute clé de portée read et tous les rôles du tableau de bord peuvent le lire.

Quota journalier des SIM

Chaque SIM dispose d'une allocation quotidienne de SMS, 200 par défaut.

Pourquoi c'est important. Les opérateurs surveillent les cartes SIM grand public. Une SIM qui envoie soudain des milliers de SMS par jour ressemble à du spam et peut être suspendue, parfois définitivement. Le quota maintient chaque SIM sous un volume que vous choisissez. Quand une SIM a épuisé le sien, la passerelle en utilise une autre ; quand toutes l'ont épuisé, les messages attendent.

Comment il se compte.

• Un message long compte pour autant de SMS qu'il en occupe (un message de 200 caractères simples compte pour deux SMS).
• Le compteur repart à zéro chaque jour à minuit UTC, quel que soit le fuseau horaire de votre plateforme. C'est voulu : les opérateurs comptent en temps absolu, et changer de fuseau ne doit jamais accorder une seconde allocation pour la même journée.

Où le voir. Dans la colonne Quota du jour : « 12 sur 200 aujourd'hui », ou simplement « Sans plafond » pour une SIM sans plafond, avec une barre qui passe à l'orange dès 80 % et au rouge quand le quota est atteint, et la mention Quota atteint. Le Tableau de bord affiche aussi une alerte pour chaque SIM proche de son quota ou l'ayant atteint.

Le modifier (Superadministrateur). Cliquez sur le crayon à côté de la SIM. La fenêtre Quota et cadence de la SIM propose :

Ce qui se passe à l'enregistrement :

• Le compteur du jour est conservé. Passer de 200 à 500 à midi après 200 envois laisse 300 SMS pour le reste de la journée. Descendre sous ce qui a déjà été envoyé arrête la SIM jusqu'à minuit UTC.
• Les messages retenus partent aussitôt. Si des messages attendaient parce que tous les quotas étaient atteints, relever un quota, retirer le plafond ou remettre une SIM en service les envoie tout de suite au lieu d'attendre minuit. L'écran File d'attente affiche un bandeau qui compte ces messages, avec un lien Modifier les quotas vers cet écran.

Une SIM qui a son propre intervalle affiche « Cadence propre : 1 SMS toutes les 30 s » sous son quota.

Par l'API, le même réglage se fait avec PATCH /devices/{deviceId}/sims/{slot}, champs dailyQuota (0 signifie sans plafond), enabled et minIntervalSeconds (null pour suivre de nouveau le réglage, 0 pour aucune attente). GET /devices renvoie minIntervalSeconds pour chaque SIM, null quand elle suit le réglage.

L'heure locale de chaque téléphone

Vos téléphones ne sont pas forcément dans le même pays que votre plateforme. L'en-tête du tableau de bord affiche, à côté de l'indicateur temps réel, l'Heure des appareils : avec un seul téléphone, son heure directement ; avec plusieurs, leur nombre, et le détail quand vous cliquez dessus. Chaque téléphone indique son fuseau et la mention Pas à l'heure de la plateforme quand son heure diffère du fuseau de la plateforme.

Pourquoi c'est important. Les pauses de nuit et du dimanche des campagnes et l'heure des envois programmés suivent le fuseau de la plateforme (réglé dans Paramètres > Envoi), pas l'heure de chaque téléphone. La mention vous signale un téléphone qui vit à une autre heure que celle de vos programmations.

Un téléphone marqué Fuseau inconnu utilise une ancienne version de l'application : mettez à jour l'application sur ce téléphone pour voir son fuseau.

Garder le téléphone en service

Une passerelle SMS n'est pas plus fiable que ses téléphones. Android est conçu pour économiser la batterie en endormant les applications, ce qu'une passerelle doit justement éviter. L'application garde une connexion permanente avec votre passerelle pour que les messages partent en quelques secondes ; pour cela, le téléphone doit rester éveillé.

À faire une fois pour chaque téléphone :

1. Le laisser branché. Android ne met pas en veille profonde un téléphone en charge. C'est la mesure la plus efficace de toutes. Si votre téléphone propose une option de protection de la batterie (charge limitée à 80 % ou équivalent), activez-la : elle ménage une batterie qui reste des mois sur le chargeur.
2. Désactiver l'optimisation de batterie pour l'application. Dans l'application, touchez Corriger la batterie. Tant que le tableau de bord affiche Optimisation de batterie encore active, Android peut suspendre l'application et les SMS cessent de partir.
3. Autoriser le démarrage automatique. Certains fabricants (Xiaomi, Huawei, Oppo, Samsung et d'autres) empêchent les applications de redémarrer seules. L'application affiche une carte Démarrage automatique avec Ouvrir le réglage. Si le réglage est introuvable, cherchez « Démarrage automatique » ou « Autostart » dans les paramètres de batterie. Le lien Assistant batterie, sous le tableau Appareils, ouvre un site qui décrit les réglages de chaque fabricant.
4. Ne pas toucher à la notification permanente. C'est elle qui permet à Android de garder l'application active. Ne balayez pas l'application depuis les applications récentes, et ne forcez pas son arrêt.
5. Lui donner une connexion stable. Préférez un Wi-Fi qui ne se coupe pas la nuit, ou des données mobiles qui restent actives.

Un téléphone appairé relance l'application de lui-même après un redémarrage, pourvu que le fabricant autorise le démarrage automatique (point 3) et que Démarrage automatique soit activé dans Paramètres > Général, appareils. Ce réglage désactivé, ouvrez l'application une fois après chaque redémarrage du téléphone. Sur un téléphone dont le fabricant suspend les applications dès que l'écran s'éteint malgré les points ci-dessus, Garder l'écran allumé, dans le même onglet, garde l'écran allumé et atténué tant que l'application tourne ; il vide la batterie, ne l'utilisez donc que sur un téléphone qui reste branché.

Rattraper les SMS reçus pendant un arrêt de l'application

Les points 1 à 5 servent à garder l'application en service. Celui-ci est le filet pour les fois où ils n'ont pas suffi : une surcouche constructeur qui arrête l'application de force, ou les minutes que met un téléphone à redémarrer. Pendant ce temps, les SMS que le téléphone reçoit n'atteignent jamais la passerelle, et rien ne les rejoue ensuite.

Rattraper les SMS manqués, sur l'écran d'accueil de l'application, ferme ce trou. Activé, le réglage relit le magasin de messages du téléphone à la reconnexion et remet à la passerelle ce qu'elle a manqué. Ces SMS apparaissent dans Conversations comme n'importe quel message reçu, dans leur ordre d'arrivée, et jamais en double.

Il est désactivé par défaut, volontairement : l'activer autorise l'application à lire le magasin de messages du téléphone, ce qu'elle ne fait nulle part ailleurs. Android demande cette autorisation au moment où vous basculez l'interrupteur, et l'interrupteur reste éteint si vous refusez.

Deux choses à savoir avant de compter dessus :

• Le compte part de son activation. Les messages reçus avant ce moment ne sont jamais importés : activer le rattrapage ne déverse pas l'historique du téléphone dans vos conversations.
• Il répare, il n'empêche pas. Il faut que l'application revienne pour que le rattrapage s'exécute : en repartant seule, ou parce que quelqu'un l'ouvre. Les points 1 à 5 restent ce qui garde le trou court.

Un téléphone éteint en a rarement besoin : le réseau de votre opérateur garde un SMS non délivré pendant des heures, souvent des jours, et le livre au retour du téléphone. Le trou que ce réglage couvre vraiment, c'est un téléphone resté allumé pendant que l'application était arrêtée.

Options

Chaque réglage d'un téléphone et de ses cartes SIM, où le modifier, et ce qu'il change dans le reste du produit. Tous sont réservés au Superadministrateur.

Une modification du quota ou de l'interrupteur de service s'applique dès le message suivant : rien à redémarrer, ni sur la passerelle ni sur le téléphone. La limite par minute de chaque SIM, les nouvelles tentatives et le fuseau horaire sont des réglages d'envoi, décrits dans Envoyer des messages.

L'onglet Paramètres > Général, appareils porte les réglages des téléphones : Intervalle de synchronisation, en secondes (la fréquence à laquelle le téléphone donne des nouvelles, donc le délai avant qu'un téléphone muet passe hors ligne), Retirer les diacritiques, Supprimer les espaces superflus, Tout en majuscules (appliqués au texte au moment où le message part vers le téléphone, et visibles tels quels dans l'historique), Démarrage automatique et Garder l'écran allumé. Chaque téléphone les applique dès l'enregistrement, ou à sa reconnexion. Leur détail est dans Paramètres.

Dépannage