# Connecter un client

> Créez une connexion Thalovant, envoyez un lien de configuration et vérifiez le premier signal de vie du client.

Source: https://docs.thalovant.com/fr/manage/connect-a-client/

---
{/* Last Edit: Claude Opus 5.5 - 2026-09-28 - Motive: Canadian French translation of manage/connect-a-client.mdx. */}

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](/fr/workspace/billing-and-plans/) 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](/fr/concepts/clients/).

## Choisir le type de connexion

  
    Idéal pour les pièces, les bornes et les assistants qui écoutent et parlent par Thalovant Voice.
  
  
    Idéal pour les conversations dans le navigateur, sans installer d'application de bureau.
  
  
    Idéal pour la CLI, l'API, les diagnostics, l'automatisation ou les tests en local.
  
  
    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é.

## 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](/fr/manage/install-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é](/fr/developers/identity-files/)
et le [tableau de compatibilité des SDK](/fr/developers/sdks/#versions-prises-en-charge).

## 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](/fr/concepts/clients/) 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. |

  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