Connecter un client

Utilisez cette page quand vous êtes prêt à connecter à un hub une application, un appareil, un parcours dans le navigateur ou un client de pièce Thalovant Voice.

Le chemin le plus direct : créez la connexion, ouvrez le lien de configuration, laissez le client se jumeler une fois, puis attendez que Dashboard affiche le premier signal de vie (heartbeat).

Commencez dans Connections avec Add connection. Choisissez d’abord le type de connexion; le hub et les détails d’accès viennent ensuite. Le lien de configuration permet à un seul client de réclamer son identité, une seule fois. Pour la voix, la page de configuration de Thalovant Voice fait le jumelage pour vous. Les liens de configuration, les fichiers de connexion et toute commande copiée qui contient un lien de configuration sont des identifiants secrets : gardez-les privés.

Décidez ces quatre choses

Vérifiez les points suivants :

• le hub que cette connexion doit utiliser;
• le type de connexion que vous créez;
• un nom qui décrit l’application, la pièce, l’appareil ou l’usage;
• si le client a seulement besoin de poser des questions, de lire l’état, ou d’un accès plus large.

Si Add connection est verrouillé, ouvrez Facturation et forfaits avant de modifier la configuration. Les limites sont un problème distinct du jumelage.

Pour la liste Connections elle-même (le matériel de configuration, les états et ce que chacun signifie), consultez Connexions.

Choisir le type de connexion

Client vocal (Voice client)

Idéal pour les pièces, les bornes et les assistants qui écoutent et parlent par Thalovant Voice.

Clavardage web (Web chat)

Idéal pour les conversations dans le navigateur, sans installer d’application de bureau.

Client développeur (Developer client)

Idéal pour la CLI, l’API, les diagnostics, l’automatisation ou les tests en local.

Client embarqué (Embedded client)

Idéal pour le matériel, le micrologiciel et le provisionnement de petits appareils.

Étapes

1. Ouvrez Connections. Choisissez Add connection.
2. Choisissez le type. Commencez par Voice client, à moins qu’une autre surface convienne clairement mieux.
3. Choisissez le hub. Rattachez la connexion au hub qu’elle doit utiliser.
4. Nommez la connexion. Utilisez un nom comme frontdesk-voice, demo-chat ou lab-device.
5. Choisissez l’accès. Gardez le comportement restreint recommandé, sauf si ce client a besoin de plus.
6. Créez la connexion. Thalovant prépare un lien de configuration sécurisé à usage unique.
7. Ouvrez la configuration. Suivez la page de configuration jusqu’à ce qu’elle indique que le client est connecté.

Sur Free, la page guide elle-même les trois étapes; sur un forfait payant, le même bouton Ajouter une connexion ouvre le formulaire complet.

Configuration vocale

Pour les clients vocaux, la page de configuration ouvre le chemin le plus simple pour l’ordinateur que vous utilisez.

Plateforme	Ce que la page offre	Ce qui se passe ensuite
macOS	Télécharger Thalovant Voice pour macOS.	Installez l’application, puis ouvrez Thalovant Voice depuis la page de configuration.
Windows	Télécharger Thalovant Voice pour Windows.	Lancez l’installateur, puis ouvrez Thalovant Voice depuis la page de configuration.
Linux	Copier la commande d’installation Linux.	Collez-la une fois dans le Terminal pour installer, jumeler et démarrer le runtime vocal.
Linux accessible seulement par SSH	Copier la commande sans interface dans les options avancées.	Collez-la par SSH, avec le lien de configuration inclus.

Gardez la page de configuration ouverte pendant le jumelage. Elle s’actualise pendant que le client réclame le lien, puis attend le premier signal de vie.

Pour les étapes d’installation propres à chaque plateforme, consultez Installer Thalovant Voice.

Autres types de configuration

Les connexions Web chat, Developer et Embedded reposent sur la même idée de configuration sécurisée, mais c’est le client cible qui s’occupe de la dernière étape de la remise.

1. Ouvrez le lien de configuration si le client cible peut le réclamer directement.
2. Copiez le lien de configuration quand le client, la surface du navigateur ou l’outil de provisionnement a besoin qu’on le colle.
3. Gardez le lien privé. Un lien de configuration peut réclamer une seule identité, et il expire.
4. Créez un nouveau lien si l’ancien a expiré, a été partagé ou a déjà servi.

Fichiers de connexion

La plupart des premières configurations devraient passer par le lien de configuration. Il évite de manipuler des fichiers à la main.

Certains parcours pour développeurs, embarqués ou de récupération peuvent encore demander un fichier de connexion privé. Traitez ce fichier comme un mot de passe. Placez-le seulement là où se trouve le client qui en a besoin, et recréez la connexion si le fichier est exposé.

Si votre équipe parle de « fichier de config », elle veut habituellement dire le fichier de connexion privé.

Les clients SDK et MCP conservent aussi un état local privé pour leur connexion chiffrée. Gardez cet état d’un redémarrage à l’autre. Donnez des identités de connexion distinctes aux applications ou aux processus MCP qui tournent indépendamment. Pour une configuration par code, consultez Fichiers d’identité et le tableau de compatibilité des SDK.

Si le lien a expiré ou que rien ne s’est connecté

Symptôme	Première vérification
Le lien de configuration a expiré	Ouvrez Connections, sélectionnez la connexion et créez un nouveau lien de configuration.
Rien ne s’ouvre après un clic sur Thalovant Voice	Installez Thalovant Voice, puis utilisez de nouveau Open Thalovant Voice.
La commande Linux a été copiée, mais rien ne s’est connecté	Collez la commande complète une fois dans le Terminal et gardez la page de configuration ouverte.
Le client a réclamé le lien, mais n’est pas connecté	Laissez l’application tourner jusqu’à l’arrivée du premier signal de vie.
La connexion est toujours hors ligne	Ouvrez Connexions et vérifiez le hub, l’état, l’accès et l’état en direct.
Le client signale un changement d’identité du serveur	Arrêtez de vous connecter et faites confirmer le changement par le soutien. N’effacez pas l’état de confiance enregistré pour contourner l’avertissement.
Un ancien SDK n’arrive pas à se connecter	Installez une version prise en charge à partir du guide du SDK; la clé héritée d’une ancienne identité n’y change rien.

Attention

Ne publiez pas de liens de configuration, de commandes de configuration copiées, de fichiers de connexion, de jetons ni de secrets dans un canal de soutien public.

C’est terminé quand

La connexion est prête quand :

• le lien de configuration a été réclamé par le client visé;
• Thalovant Voice ou le client cible est en marche;
• Dashboard affiche le nombre ou l’état de connexions attendu;
• Topology affiche l’état en direct attendu, quand l’état en direct est disponible;
• les règles d’accès correspondent à ce que cette connexion doit avoir le droit de faire.

Étape suivante

Une fois une connexion active, révisez son accès avant d’en ajouter une autre.

Réviser les règles d’accès Installer Thalovant Voice