# Répondre dans les applications de clavardage

> Connectez votre propre bot Telegram, Discord, Matrix, Mattermost ou Twitch à un hub, pour que le hub réponde dans les discussions que vous choisissez.

Source: https://docs.thalovant.com/fr/manage/chat-apps/

---
Créez un bot sur un réseau de clavardage, donnez son jeton à la console
Thalovant, et votre hub répond dans les groupes, les salons ou les canaux que
vous choisissez. Pour le hub, le bot est une connexion de plus. Pour les gens
de la discussion, c'est un membre qu'on mentionne quand on veut une réponse.

La console les appelle **Applications de clavardage**. Il y en a cinq :

| Réseau | Le bot répond dans | État |
| --- | --- | --- |
| Telegram | Des groupes, et les discussions privées que vous permettez | Offert |
| Discord | Les salons d'un serveur | Offert |
| Matrix | Des salons non chiffrés, sur n'importe quel serveur |  |
| Mattermost | Les canaux de votre serveur Mattermost |  |
| Twitch | Le clavardage de chaînes |  |

Matrix, Mattermost et Twitch sont en bêta. Leurs bots répondent de la même
façon et comptent dans les mêmes limites, mais la console en fait moins pour
vous : elle ne peut pas vérifier leurs identifiants de connexion avant le
démarrage du bot, afficher les endroits où le bot peut répondre, ni envoyer de
message d'essai. Vous indiquez où le bot répond, et l'état du bot vous dit
s'il s'est connecté. Leur configuration peut encore changer.

## Ce qu'il vous faut

Il vous faut un forfait payant. Free et Connect n'incluent pas les
applications de clavardage, et la console y affiche un badge **Forfait payant**
sur les cartes des applications de clavardage. La plupart des forfaits payants
incluent deux bots; [la liste complète est plus bas](#combien-de-bots-et-de-demandes).

Il vous faut aussi un hub que vous gérez, puisque seuls ceux-là peuvent faire
fonctionner un bot, ainsi qu'un compte sur le réseau. Pour faire entrer le bot,
vous devez avoir le droit d'ajouter des membres au groupe Telegram, la
permission **Gérer le serveur** sur le serveur Discord, le droit d'inviter des
gens dans le salon Matrix, ou le droit d'ajouter des membres au canal
Mattermost. Un administrateur système du serveur Mattermost crée son compte de
bot. Un bot Twitch a besoin de son propre compte Twitch et d'une application
de développeur Twitch, qui s'enregistre gratuitement.

Un bot répond pour un seul hub. Pour répondre pour un deuxième hub, créez un
deuxième bot. Un bot compte dans les applications de clavardage de votre
forfait, pas dans ses connexions, quel que soit son réseau.

## Créer un bot Telegram

1. **Ouvrez @BotFather** dans Telegram. C'est le bot de Telegram qui sert à
   créer des bots.
2. **Envoyez `/newbot`.** Choisissez un nom, puis un nom d'utilisateur qui se
   termine par « bot », comme `KitchenHubBot`.
3. **Copiez le jeton** que BotFather vous renvoie. Il ressemble à
   `123456789:AAH…` : un nombre, un deux-points, puis des lettres.

## Créer un bot Discord

1. **Ouvrez le [portail des développeurs Discord](https://discord.com/developers/applications)**
   et sélectionnez **New Application**. Donnez-lui le nom que le bot doit
   porter.
2. **Ouvrez sa page Bot** et sélectionnez **Reset Token**. Discord n'affiche le
   jeton qu'une fois : copiez-le tout de suite.
3. **Laissez les intentions privilégiées désactivées**, Message Content
   compris. Le bot lit seulement les messages qui le mentionnent ou qui lui
   répondent, et Discord transmet ces messages à un bot sans intention
   particulière.

## Créer un bot Matrix :badge[Bêta]{variant=caution}

Un bot Matrix est un compte ordinaire sur un serveur Matrix, le vôtre ou un
serveur public. Il vous faudra un terminal pour une commande, afin d'obtenir son
jeton d'accès (macOS ou Linux; sous Windows, utilisez WSL).

1. **Créez un compte pour le bot**, comme `@kitchenbot:example.org`, et
   donnez-lui un nom d'affichage. Les gens mentionnent le bot par ce nom.
2. **Notez l'adresse du serveur.** Dans Element, connecté avec n'importe quel
   compte de ce serveur, ouvrez **Settings**, puis **Help & About** : elle se
   trouve sous **Advanced**, comme `https://matrix-client.matrix.org`. Il faut
   une adresse https sur le port 443, joignable depuis Internet.
3. **Connectez le bot une fois pour obtenir son jeton d'accès**, avec l'adresse
   du serveur, le nom d'utilisateur du bot et son mot de passe :

   ```sh
   curl -X POST https://matrix-client.matrix.org/_matrix/client/v3/login \
     -H 'Content-Type: application/json' \
     -d '{"type": "m.login.password", "identifier": {"type": "m.id.user", "user": "kitchenbot"}, "password": "THE_BOT_PASSWORD", "initial_device_display_name": "Thalovant"}'
   ```

   Gardez l'`access_token` de la réponse. Il dure tant que cette session n'est
   pas déconnectée : ne déconnectez donc jamais la session nommée
   « Thalovant ». N'utilisez pas à sa place le jeton d'accès qu'Element affiche
   dans ses paramètres : il prend fin quand Element se déconnecte, et sur
   certains serveurs il est renouvelé toutes les quelques minutes.
4. **Créez chaque salon sans chiffrement.** Le bot ne peut pas lire les salons
   chiffrés de bout en bout. Element chiffre par défaut les nouveaux salons
   privés et les messages directs, et le chiffrement d'un salon ne peut plus
   être désactivé ensuite : créez donc le salon avec **Enable end-to-end
   encryption** désactivé. Invitez ensuite le bot.
5. **Copiez l'identifiant de chaque salon** dans les paramètres du salon, sous
   **Advanced** : l'**Internal room ID**, comme `!AbCdEfGh:example.org`. La
   console accepte des identifiants, pas des adresses de salon comme
   `#kitchen:example.org`.

## Créer un bot Mattermost :badge[Bêta]{variant=caution}

1. **Activez les comptes de bot.** Un administrateur système ouvre **System
   Console**, **Integrations**, **Bot Accounts** et active **Enable Bot Account
   Creation**, puis, sous **Integration Management**, **Enable Personal Access
   Tokens**.
2. **Créez le bot.** Dans le menu principal, ouvrez **Integrations**, **Bot
   Accounts**, **Add Bot Account**, et choisissez un nom d'utilisateur comme
   `kitchenbot`. Laissez-lui le rôle Member; n'en faites jamais un
   administrateur système. Mattermost n'affiche le jeton d'accès du bot qu'une
   fois : copiez-le.
3. **Ajoutez le bot** à l'équipe, et à chaque canal où il doit répondre, avec
   **Add Members** dans le menu du canal. Un bot ne voit que les canaux dont il
   est membre.
4. **Copiez l'identifiant de chaque canal.** Sélectionnez le nom du canal, puis
   **View Info**. Un identifiant compte 26 lettres et chiffres, comme
   `6ru4o9giafff9fdm56kb5cqmje`.

Il vous faudra aussi l'adresse de votre serveur, comme
`https://chat.example.com`. Elle doit utiliser https sur le port 443 et être
joignable depuis Internet.

## Créer un bot Twitch :badge[Bêta]{variant=caution}

Un bot Twitch se connecte avec un jeton d'actualisation, dont il se sert pour
obtenir lui-même des accès de courte durée. Il vous faudra un terminal pour une
commande (macOS ou Linux; sous Windows, utilisez WSL).

1. **Choisissez le compte Twitch du bot.** Son identifiant de connexion est le
   nom en minuscules dans `twitch.tv/<login>`, comme `kitchenbot`.
2. **Enregistrez une application** dans la [console des développeurs
   Twitch](https://dev.twitch.tv/console/apps). Mettez **OAuth Redirect URLs**
   à `http://localhost:3000` et **Client Type** à **Confidential** : le jeton
   d'actualisation d'une application confidentielle n'expire pas. Copiez le
   **Client ID**, puis créez un **Client Secret** et copiez-le aussi. Twitch
   exige l'authentification à deux facteurs sur votre compte avant d'en
   enregistrer une.
3. **Donnez le consentement du bot.** Connecté à Twitch en tant que bot,
   ouvrez cette adresse après y avoir mis votre identifiant client, et
   approuvez :

   ```txt
   https://id.twitch.tv/oauth2/authorize?response_type=code&client_id=YOUR_CLIENT_ID&redirect_uri=http://localhost:3000&scope=chat%3Aread+chat%3Aedit
   ```

   Votre navigateur ouvre ensuite une page `localhost` qui ne s'affiche pas.
   C'est normal : copiez le `code` qui se trouve dans son adresse.
4. **Échangez le code contre un jeton d'actualisation**, tout de suite, puisqu'un
   code ne sert qu'une fois :

   ```sh
   curl -X POST https://id.twitch.tv/oauth2/token \
     -d client_id=YOUR_CLIENT_ID -d client_secret=YOUR_CLIENT_SECRET \
     -d code=THE_CODE -d grant_type=authorization_code \
     -d redirect_uri=http://localhost:3000
   ```

   Gardez le `refresh_token` de la réponse.
5. **Nommez le bot VIP ou modérateur** dans chaque chaîne où il répond, pour
   que les réglages du clavardage de la chaîne, comme le mode lent ou le
   clavardage réservé aux followers, ne le freinent pas. Certaines chaînes ne
   laissent aussi clavarder que les comptes dont le numéro de téléphone est
   vérifié.

## Connecter le bot à un hub

Ouvrez **Connexions**, sélectionnez **Ajouter une connexion**, puis, sous
**Applications de clavardage**, choisissez la carte du réseau. Matrix,
Mattermost et Twitch portent un badge **Bêta**. Vous pouvez aussi partir d'un
hub pour un bot Telegram ou Discord : ouvrez son panneau, allez dans l'onglet
**Clavardage**, puis sélectionnez **Ajouter un bot Telegram** ou **Ajouter un
bot Discord**.

### Telegram et Discord

1. **Choisissez le hub** dont l'assistant doit répondre.
2. **Collez le jeton** et sélectionnez **Vérifier le jeton**. La console le
   vérifie auprès de Telegram ou de Discord, puis affiche le bot tel que les
   gens le verront : sa photo, son nom et son @nom d'utilisateur. Rien ne
   fonctionne encore.
3. **Invitez le bot.** Dans Telegram, sélectionnez **Ajouter à un groupe** et
   choisissez le groupe, ou balayez le code QR avec votre téléphone. Dans
   Discord, sélectionnez **Ajouter à un serveur** et choisissez le serveur. La
   page de Discord demande trois permissions, pas une de plus : voir les
   salons, envoyer des messages et lire l'historique des messages.
4. **Choisissez où il répond.** Dans Telegram, envoyez d'abord
   `/start@YourBot` dans chaque groupe (la console affiche la ligne exacte,
   avec un bouton pour la copier), puis sélectionnez **Actualiser**. Telegram
   affiche les discussions qui ont écrit au bot dans les dernières 24 heures.
   Dans Discord, chaque salon textuel ou d'annonces que le bot voit est affiché
   sous son serveur. Choisissez-en au moins un, et jusqu'à 50.
5. **Sélectionnez Commencer à répondre.** Le bot indique **Démarrage** pendant
   une minute ou deux, puis **Connecté**.

Ça fonctionne quand le panneau du bot indique **Connecté** et affiche les
discussions où il répond. Sélectionnez **Envoyer un message d'essai** pour
qu'il publie une courte ligne « connecté » dans l'une d'elles, ou mentionnez-le
dans le groupe et posez-lui une question.

### Matrix, Mattermost et Twitch

1. **Choisissez le hub** dont l'assistant doit répondre.
2. **Remplissez les réglages et les identifiants de connexion**, puis
   sélectionnez **Connecter**. La console affiche les étapes de configuration
   du réseau au-dessus du formulaire. Elle indique ensuite que le bot est
   configuré; sélectionnez **Continuer**. Rien ne fonctionne encore.
3. **Indiquez où il répond.** Saisissez chaque identifiant de salon, identifiant
   de canal ou nom de chaîne, puis sélectionnez **Ajouter** ou appuyez sur
   Entrée. Ajoutez-en au moins un, et jusqu'à 50.
4. **Sélectionnez Commencer à répondre.** Le bot indique **Démarrage** pendant
   une minute ou deux, puis **Connecté**.

| Réseau | Réglages | Identifiants de connexion | Où il répond |
| --- | --- | --- | --- |
| Matrix | **Serveur**, et **Identifiant du bot** si vous voulez, comme `@kitchenbot:example.org` | **Jeton d'accès** | Identifiants de salon |
| Mattermost | **Adresse du serveur** | **Jeton du bot** | Identifiants de canal |
| Twitch | **Identifiant de connexion du bot** et **Identifiant client** | **Secret client** et **Jeton d'actualisation** | Noms de chaîne, comme `kitchenstream` (`#KitchenStream` fonctionne aussi) |

Quand vous sélectionnez **Connecter**, la console vérifie chaque adresse :
https, port 443, et une adresse publique sur Internet, pas une adresse privée
ou locale. Elle ne peut pas vérifier les identifiants de connexion : le bot se
connecte à son démarrage, et si le réseau en refuse un (un jeton, un
identifiant client ou un secret), son panneau indique **À vérifier** et le bot
reste arrêté tant que vous ne les remplacez pas. L'identifiant d'un bot Matrix, si vous en donnez un, doit être
celui du compte auquel appartient le jeton, et l'identifiant de connexion d'un
bot Twitch, celui du compte qui a donné son consentement.

Ça fonctionne quand le panneau indique **Connecté**. Il n'y a pas de message
d'essai pour ces réseaux : mentionnez le bot dans un de ses salons ou canaux et
posez-lui une question.

## Comment il répond

Dans un groupe, un salon ou un canal, le bot répond seulement aux messages qui
le mentionnent, comme `@KitchenHubBot quelle météo fait-il`, ou qui répondent
à un de ses messages. Le reste de la discussion ne le concerne pas. Il répond
seulement là où vous l'avez permis.

Chaque personne a sa propre conversation avec le hub, même dans le même
groupe : la question de l'une ne se mêle pas à celle d'une autre. Sous
**Options avancées**, pendant que vous choisissez où il répond, vous pouvez
plutôt choisir **Une conversation par discussion**, et tout le monde dans une
discussion partage un seul fil.

### Dans Telegram

Un bot Telegram répond seulement dans les discussions que vous avez permises.
On peut aussi lui écrire dans une discussion privée; il y répond une fois que
vous avez permis cette discussion aussi, et il y répond à chaque message, sans
mention.

Pour qu'il réponde aussi à chaque message de ses groupes, désactivez **Dans
les groupes, répondre seulement quand il est mentionné** sous **Options
avancées**. La console vous avertit au moment de le faire : le bot répond
alors à tout ce qui se dit dans ces groupes, et utilise plus vite l'allocation
quotidienne.

### Dans Discord

Un bot Discord répond toujours seulement quand on le mentionne ou qu'on lui
répond. C'est ainsi qu'un bot Discord lit les messages sans l'intention Message
Content : il n'y a donc pas de réglage pour ça. Il ignore les messages directs.

### Dans Matrix :badge[Bêta]{variant=caution}

Un bot Matrix rejoint les salons de sa liste quand on l'y invite, et répond aux
gens qui le mentionnent, par son nom d'affichage ou avec une pastille de
mention, ou qui lui répondent. Dans un salon où il est seul avec une personne,
il répond à chaque message. Il ne peut pas répondre dans les salons chiffrés,
donc pas dans les messages directs ouverts depuis Element.

### Dans Mattermost :badge[Bêta]{variant=caution}

Un bot Mattermost répond dans les canaux de sa liste quand quelqu'un mentionne
son @nom d'utilisateur, ou répond dans le fil sous une de ses réponses. Il
répond dans le canal, ou dans le fil si la question y était, en commençant par
le @nom d'utilisateur de la personne, et ne notifie jamais @channel, @all ni
personne d'autre. Il ignore les messages directs.

### Dans Twitch :badge[Bêta]{variant=caution}

Un bot Twitch rejoint les chaînes de sa liste et répond aux messages qui le
mentionnent, comme `@kitchenbot quelle heure est-il`, ou qui lui répondent. Sa
réponse est une réponse à ce message. Il ne répond jamais aux chuchotements.

Dans Matrix, Mattermost et Twitch, vous pouvez désactiver **Répondre seulement
quand il est mentionné** sous **Options avancées**. Le bot répond alors à
chaque message là où vous l'avez permis, et utilise plus vite l'allocation
quotidienne; une chaîne Twitch animée peut l'épuiser vite.

## Combien de bots et de demandes

Les demandes qui viennent d'une discussion comptent dans l'allocation
quotidienne du propriétaire du hub, les mêmes **Intentions par jour** que pour
toute autre connexion. En plus, chaque bot répond à au plus **500 demandes par
jour**, et chaque personne à au plus **6 demandes par minute**. Avec une
conversation par discussion, toute la discussion partage ces six demandes.
Au-delà de l'une de ces limites, les demandes du bot sont refusées jusqu'à la
remise à zéro du compteur.

Votre forfait fixe le nombre de bots que vous pouvez faire fonctionner, pour
l'ensemble de vos hubs et de vos réseaux :

| Forfaits | Bots |
| --- | --- |
| Free, Connect | Aucun |
| Home, Family, Maker, Workspace, Business, Civic, Pilot, Fleet, et les anciens Private, Team et On Demand | 2 |
| Site Pack, Municipality | 10 |
| Private Edge, Enterprise | 20 |

Quand tous les bots inclus dans votre forfait sont utilisés, la console le dit
sur les cartes des applications de clavardage. [Facturation et
forfaits](/fr/workspace/billing-and-plans/) présente le reste de chaque
forfait. Vous pouvez toujours mettre un bot en pause ou le supprimer, quel que
soit votre forfait.

## Garder le jeton secret

Le jeton, c'est le bot. Quiconque le détient peut publier au nom de votre bot
et lire ce qu'on lui envoie. Il en va de même d'un jeton d'accès Matrix, d'un
jeton de bot Mattermost, et d'un secret client et d'un jeton d'actualisation
Twitch.

La console envoie le jeton à Thalovant une seule fois, quand vous sélectionnez
**Vérifier le jeton** (ou **Connecter**, dans Matrix, Mattermost et Twitch).
Thalovant le conserve, et il n'est plus jamais affiché, pas même à vous. Pour
le changer plus tard, ouvrez le bot et utilisez **Remplacer le jeton**, ou
**Remplacer les identifiants de connexion** sur les réseaux en bêta. Un nouveau
jeton Telegram ou Discord doit appartenir au même bot; pour le jeton d'un autre
bot, ajoutez un nouveau bot.

  Ne collez jamais un jeton de bot dans une discussion, un fil de soutien ou
  une capture d'écran. Si un jeton fuit, envoyez `/revoke` à @BotFather (dans
  Discord, sélectionnez **Reset Token** dans la page Bot), puis collez le
  nouveau jeton avec **Remplacer le jeton**.

Sur les réseaux en bêta, révoquez un identifiant qui a fui là où il a été
créé : déconnectez la session Matrix « Thalovant » du bot, supprimez le jeton du bot dans
Mattermost, ou créez un nouveau secret client dans la console des développeurs
Twitch. Pour un jeton d'actualisation Twitch qui a fui, déconnectez
l'application dans les paramètres Twitch du compte du bot, sous
**Connections**, et donnez de nouveau le consentement. Saisissez ensuite le
nouveau avec **Remplacer les identifiants de connexion**.

## Qui peut demander, et ce qu'il ne peut pas faire

Toute personne d'une discussion permise peut poser des questions à votre hub,
et chaque demande utilise votre allocation. Ne permettez que les discussions
dont les membres ont votre confiance.

Les gens d'une discussion ne sont pas vous, et le hub les traite ainsi :

- la mémoire personnelle est désactivée pour eux : le hub ne se souvient pas
  d'eux, et il n'agit jamais en tant que propriétaire pour eux;
- une application de clavardage ne peut jamais commander votre maison. Les
  demandes à [Home Assistant](/fr/manage/home-assistant/) venant d'une
  discussion sont refusées.

Les messages au bot passent par le réseau de clavardage, selon ses propres
conditions (dans Matrix et Mattermost, par le serveur que vous avez choisi), et
par un bot qui vous appartient. Les réponses du hub sont publiées dans la
discussion, où tout le monde peut les lire.

## Ce que Thalovant conserve

Quand quelqu'un pose une question à votre hub par un bot, Thalovant compte la
demande dans l'activité de votre hub : quel bot, quel réseau et quand. Il ne
conserve ni ce que la personne a écrit, ni son adresse IP ou sa position, ni
une session qui relierait ses demandes entre elles. Ses demandes ne sont
jamais comptées comme les vôtres ni comme celles de vos appareils, et le hub ne
garde aucun historique de conversation pour elle, contrairement à [vos propres
demandes](/fr/trust/#ce-que-le-hub-conserve).

Pour le bot lui-même, Thalovant conserve ce que vous lui avez donné : son jeton
ou ses identifiants de connexion, qui ne sont plus jamais affichés, pas même à
vous; le nom et le nom d'utilisateur du bot, dans Telegram et Discord; ses
réglages, comme une adresse de serveur; les discussions permises; et sa façon de
répondre. Votre [exportation de
compte](/fr/account/profile-security/#exportation-et-conservation-des-données)
présente vos bots avec leurs discussions et leurs réglages, jamais leurs jetons
ni leurs identifiants de connexion. Supprimer un bot les retire de Thalovant.

## Veiller sur un bot

Ouvrez un bot depuis la liste des connexions, ou depuis l'onglet
**Clavardage** du hub. Son panneau affiche les discussions où il répond, sa
façon de répondre et son état :

- **Configuration** : le bot n'a pas encore de discussions. Choisissez-les
  pour le démarrer.
- **Démarrage** : il est en route, habituellement en une minute ou deux.
- **Connecté** : il répond dans ses discussions.
- **En pause** : il ne répond pas tant que vous ne le relancez pas, ou que
  Thalovant ne le redémarre pas (voir plus bas).
- **À vérifier** : il ne répond pas, et le panneau dit pourquoi.

Vous verrez **Mise en pause** un instant après l'avoir mis en pause.

Thalovant met lui-même un bot en pause dans deux cas, et le panneau dit
lequel :

- Quand votre forfait inclut moins de bots que vous n'en faites fonctionner,
  après un passage à un forfait inférieur, par exemple. Vos bots les plus
  anciens continuent de répondre et les plus récents se mettent en pause. Un
  bot en pause redémarre de lui-même, en quelques minutes, dès que votre
  forfait a de la place pour lui : après un passage à un forfait supérieur, ou
  quand vous mettez en pause ou supprimez un autre bot.
- Quand votre compte est suspendu. Tous les bots actifs se mettent en pause. À
  la réactivation du compte, ils redémarrent autant que votre forfait le
  permet.

Vous ne pouvez pas reprendre un bot que Thalovant a mis en pause; il redémarre
de lui-même. Rien n'est supprimé pendant qu'un bot est en pause.

Depuis le panneau, vous pouvez envoyer un message d'essai, remplacer le jeton,
modifier les discussions, mettre le bot en pause ou le reprendre, et le
supprimer. Le message d'essai est écrit dans la langue du hub : « Connecté à
… » pour un hub en français, « Connected to … » sinon.

**Modifier les discussions** fonctionne un peu différemment selon le réseau.
Telegram affiche les nouvelles discussions seulement quand le bot est en pause :
sélectionnez **Mettre en pause et chercher**, envoyez `/start@YourBot` dans le
nouveau groupe, puis sélectionnez **Actualiser**. L'enregistrement relance le
bot. Dans Discord, **Modifier les salons** fonctionne pendant que le bot tourne.
La même fenêtre contient aussi **Options avancées**, où vous changez la façon
dont le bot répond : la règle de mention (sauf dans Discord), et une
conversation par personne ou par discussion.

### Modifier un bot Matrix, Mattermost ou Twitch

Le panneau d'un bot en bêta affiche ses réglages sous **Connexion**, et la
version qu'il utilise. Il n'y a pas de message d'essai. Au lieu des boutons du
jeton et des discussions, il propose :

- Utilisez **Modifier les réglages** pour changer le serveur, l'adresse du
  serveur, l'identifiant du bot, son identifiant de connexion ou
  l'identifiant client. Le bot redémarre avec les nouveaux réglages.
- Utilisez **Remplacer les identifiants de connexion** pour saisir un nouveau
  jeton d'accès, jeton de bot, secret client ou jeton d'actualisation.
  Saisissez seulement ceux qui ont changé; les autres restent tels quels. Le
  bot redémarre avec eux.
- Utilisez **Modifier la liste** pour ajouter ou retirer des identifiants de
  salon, des identifiants de canal ou des noms de chaîne, avec **Options
  avancées** pour la règle de mention et les conversations.

**Supprimer** arrête les réponses du bot pour le hub et retire son jeton ou ses
identifiants de connexion de Thalovant. Le bot lui-même reste dans votre compte
Telegram, ou l'application dans votre portail des développeurs Discord;
supprimez-le là si vous n'en avez plus besoin. Un compte Matrix, Mattermost ou
Twitch reste tel quel, lui aussi. Supprimer un hub supprime aussi ses bots.

## Quand le bot ne répond pas

**Personne ne l'a mentionné.** Dans un groupe, un salon ou un canal,
mentionnez le bot dans le message ou répondez à un de ses messages. Dans
Discord, il n'y a pas d'autre façon.

**La discussion n'est pas permise.** Ouvrez le bot et vérifiez les discussions
où il répond. Un groupe où vous avez ajouté le bot plus tard n'est pas dans la
liste tant que vous ne l'ajoutez pas avec **Modifier les discussions**, ou
**Modifier la liste** sur les réseaux en bêta.

**Une limite quotidienne est atteinte.** L'allocation quotidienne du
propriétaire du hub, les 500 demandes par jour du bot ou les six demandes par
minute d'une personne. Attendez la remise à zéro, ou consultez votre forfait
dans [Facturation](/fr/workspace/billing-and-plans/).

**Le bot a été retiré du groupe ou du serveur.** Invitez-le de nouveau depuis
son panneau. Dans ce cas, un message d'essai vers cette discussion échoue avec
« Vérifiez que le bot est toujours dans cette discussion et qu'il peut y
publier. » Dans Matrix, invitez-le de nouveau dans le salon; dans Mattermost,
ajoutez-le de nouveau au canal.

**Le salon Matrix est chiffré.** Le bot n'y dit rien. Créez un salon sans
chiffrement, invitez le bot, et ajoutez l'identifiant du nouveau salon.

**L'identifiant n'est pas du bon type.** Une adresse de salon Matrix comme
`#kitchen:example.org`, ou le nom d'un canal Mattermost, n'est pas un
identifiant : copiez l'identifiant comme décrit plus haut. Dans Twitch,
utilisez l'identifiant de connexion qui se trouve dans l'adresse de la chaîne.

**Un bot Twitch reste en Démarrage.** Un de ses noms de chaîne est mal écrit, ou
la chaîne a changé de nom : Twitch ignore une chaîne qui n'existe pas, et le
bot l'attend. Vérifiez les noms avec **Modifier la liste**.

**Le jeton a été révoqué ou réinitialisé.** Le panneau indique **À vérifier**
et dit que Telegram ou Discord a refusé le jeton du bot, ou que le bot a cessé
de répondre. Collez le nouveau jeton avec **Remplacer le jeton**.

**Les identifiants de connexion ont été refusés.** Sur les réseaux en bêta, le
panneau indique **À vérifier** et dit que le réseau a refusé ses identifiants de
connexion : un jeton, un identifiant client ou un secret. Le bot reste arrêté
tant que vous ne les remplacez pas. Créez-en de nouveaux : un jeton d'accès
Matrix (la session du bot a-t-elle été déconnectée?), un jeton de bot
Mattermost, ou dans Twitch un nouveau consentement et un nouveau jeton
d'actualisation, ou l'identifiant client et le secret client actuels.
Saisissez-les avec **Remplacer les identifiants de connexion** ou **Modifier
les réglages** (l'identifiant client Twitch est un réglage).

**Le bot est en pause.** Si ce n'est pas vous qui l'avez mis en pause, le
panneau dit pourquoi : votre forfait n'a pas de place pour lui, ou le compte
est suspendu. Voyez [Veiller sur un bot](#veiller-sur-un-bot).

**Le bot ne joint pas son hub.** Le panneau le dit sous **À vérifier**.
Vérifiez que le hub fonctionne dans [Hubs](/fr/concepts/hubs/).

Si le panneau dit que le bot n'a pas pu démarrer à cause d'un problème du côté
de Thalovant et que cela dure, [obtenez du soutien](/fr/account/get-support/).

## Messages dans la console

**« Ce bot répond déjà pour un hub, et un bot sert un seul hub. »** Créez un
autre bot avec @BotFather ou le portail des développeurs, ou ouvrez celui que
vous avez. Sur les réseaux en bêta, ces identifiants de connexion servent déjà
un bot : ouvrez-le, ou utilisez un compte distinct.

**« Cela ne ressemble pas à un jeton de bot Telegram. »** Copiez tout le jeton
envoyé par BotFather, du nombre jusqu'à la dernière lettre.

**« Telegram n'a pas accepté ce jeton. »** Copiez-le de nouveau dans
@BotFather, ou envoyez-y `/token` pour en obtenir un nouveau. Dans Discord,
réinitialisez-le dans la page Bot et collez le nouveau.

**« Ce jeton appartient à un autre bot. »** **Remplacer le jeton** accepte
seulement un nouveau jeton du même bot. Pour utiliser l'autre bot, ajoutez-le
comme nouveau bot.

**« Ce bot n'a pas de nom d'utilisateur, alors Telegram ne peut pas créer de
lien d'invitation. »** Donnez-lui un nom d'utilisateur avec @BotFather, puis
remplacez le jeton.

**« Telegram transmet encore les messages de ce bot ailleurs. »** Un autre
programme lit les messages de ce bot. Attendez une minute et actualisez. Si
cela dure, arrêtez l'autre programme ou créez un nouveau bot pour Thalovant.

**« Il faut une adresse https, comme https://chat.example.org. »**, **« Il faut
une adresse https sur le port 443 : les autres ports ne sont pas joignables. »**
ou **« Il faut une adresse publique sur Internet, pas une adresse privée ou
locale. »** Le bot joint un serveur Matrix ou Mattermost par Internet, sur le
port 443 seulement. Utilisez l'adresse à laquelle votre application Matrix ou
Mattermost se connecte; un serveur sur un réseau privé ou sur un autre port ne
peut pas servir.

**« Cette adresse est introuvable. Vérifiez l'orthographe. »** Le nom du
serveur, tel qu'il est saisi, n'existe pas sur Internet.

**« … n'a pas la forme attendue par cette application de clavardage. »**, par
exemple pour `#kitchen:example.org`. Ce que vous avez saisi n'est pas un identifiant de salon
Matrix, un identifiant de canal Mattermost ni un identifiant de connexion de
chaîne Twitch. Copiez-le de nouveau comme décrit plus haut.

**« Les bots Telegram sont inclus dans les forfaits payants »** ou **« Votre
forfait inclut 2 bots, et ils sont tous utilisés. »** Voyez [combien de bots
chaque forfait inclut](#combien-de-bots-et-de-demandes), ou supprimez un bot
dont vous ne vous servez plus.

**« Votre forfait permet 2 bots actifs, et ils sont tous utilisés. »** Vous
avez voulu reprendre un bot, ou enregistrer ses discussions après l'avoir mis
en pause, alors que tous les bots de votre forfait répondent. Mettez d'abord
en pause ou supprimez un autre bot.
