Appareils

Un appareil, ici, c’est un matériel que Thalovant suit depuis l’usine : un haut-parleur intelligent, un miroir, un terminal de point de vente, un boîtier dans une usine. Certains sont fabriqués par des entreprises qui bâtissent sur Thalovant, d’autres sont vendus par Thalovant. Les téléphones, les navigateurs et l’application vocale ne sont pas des appareils dans ce sens; vous les ajoutez vous-même dans Connexions.

Pour chaque appareil, Thalovant garde qui l’a fabriqué et quel modèle c’est, quelle organisation en est propriétaire, où il se trouve (un site, comme un magasin ou une maison, et un endroit dans ce site, comme « comptoir avant ») et à quel hub il parle. Un appareil sur un hub a une connexion comme les autres, créée pour lui. Elle apparaît dans Connexions sous le nom du modèle et du numéro de série.

Qui change quoi

Le soutien Thalovant fait chaque changement sur un appareil : l’enregistrer, le remettre à son propriétaire, le placer sur un hub, le déplacer, le retirer pour réparation et le libérer quand il est vendu. Personne dans une organisation cliente ne peut le faire, ni le compte qui possède l’organisation ni les gens qui se connectent avec leur compte d’entreprise. L’historique d’un appareil reste ainsi au même endroit, et un ancien propriétaire ne peut plus l’atteindre une fois qu’il a changé de mains.

Les gens de votre organisation voient ses appareils et ses sites, avec le modèle, l’état, le site, l’endroit et le hub de chacun. Ils ne peuvent pas modifier, mettre en pause, réassocier ou supprimer la connexion d’un appareil; ces boutons répondent que Thalovant s’en occupe.

Les gens d’un fabricant voient les unités que leur entreprise a fabriquées, avec le numéro de série, le modèle et si chacune est en stock, chez un client ou retirée. Ils ne voient jamais à qui appartient un appareil, où il se trouve ni quel hub il utilise.

Placer un appareil sur votre hub

Le code de réclamation de l’appareil est imprimé sur son étiquette ou dans sa boîte, en groupes de cinq caractères. Envoyez-le au soutien avec le hub voulu, et le site et l’endroit si vous voulez qu’ils soient notés. Le soutien vérifie le code, remet l’appareil à votre organisation et le place sur le hub.

L’appareil va ensuite chercher lui-même les détails de sa connexion avec un secret reçu à l’usine. Il est prêt environ une minute et demie plus tard, comme toute nouvelle connexion. Vous n’avez pas de fichier de connexion à télécharger pour lui, et personne d’autre non plus.

Deux sortes de matériel ont une règle :

• Un appareil avec une caméra n’est placé sur un hub qu’après que le soutien a noté votre accord.
• Un terminal de paiement ne va que sur un hub que votre organisation exploite, jamais sur un hub public partagé avec les appareils d’autres gens.

Réparation, remplacement et revente

Quand un appareil part en réparation ou est remplacé, le soutien le retire de son hub. Sa connexion est supprimée, le hub cesse de l’accepter et une session en cours est fermée. L’appareil reste à vous. À son retour, ou à l’arrivée d’un remplaçant, le soutien le replace sur le hub avec une nouvelle connexion. Une unité passée par un atelier ne revient jamais avec des identifiants que quelqu’un aurait pu y copier.

Quand un appareil est revendu ou retourné, il est retiré de son hub et libéré au fabricant ou au revendeur. La libération remplace le secret de l’appareil et son code de réclamation : l’ancienne étiquette et tout ce qui a été copié de l’appareil cessent de fonctionner. Il disparaît tout de suite de la liste de votre organisation. Ce qui reste chez vous, ce sont vos propres données : les éléments de mémoire de votre organisation lui appartiennent, pas à l’appareil. Celui qui remet l’appareil à neuf le réinitialise et y écrit le nouveau secret avant que le prochain propriétaire le réclame avec le nouveau code.

Un appareil perdu, mis au rebut ou soupçonné d’avoir été trafiqué est retiré pour de bon. Son secret est effacé et il ne peut plus rien aller chercher.

Lire vos appareils par l’API

Un jeton d’API avec clients:read peut lire ce que voient les gens de votre organisation. GET /v1/fleet/devices liste les appareils de chaque organisation dont vous faites partie, et GET /v1/fleet/devices/{id} en lit un. GET /v1/fleet/organizations liste ces organisations avec votre rôle dans chacune, et GET /v1/fleet/sites leurs sites.

curl -H "Authorization: Bearer $THALOVANT_TOKEN" https://api.thalovant.com/v1/fleet/devices

{
  "data": [
    {
      "id": "0f8e…",
      "serial": "SN-0001",
      "state": "deployed",
      "model": { "code": "ks-1", "name": "Kitchen Speaker", "capabilities": ["microphone", "speaker"] },
      "view": "owner",
      "site_id": "9a41…",
      "area": "Front counter",
      "hub_id": "5c2d…",
      "client_id": "77b0…"
    }
  ]
}

Le champ state d’un appareil vaut inventory (en stock chez son fabricant ou un revendeur), claimed (à vous, pas encore sur un hub), deployed, decommissioned (retiré de son hub, toujours à vous) ou retired. Un jeton limité à certains hubs ne voit que les appareils de ces hubs. Un appareil qui appartient à quelqu’un d’autre répond 404, comme un appareil qui n’existe pas.