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.
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 | Bêta |
| Mattermost | Les canaux de votre serveur Mattermost | Bêta |
| Twitch | Le clavardage de chaînes | Bêta |
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
Section intitulée « 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.
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
Section intitulée « Créer un bot Telegram »- Ouvrez @BotFather dans Telegram. C’est le bot de Telegram qui sert à créer des bots.
- Envoyez
/newbot. Choisissez un nom, puis un nom d’utilisateur qui se termine par « bot », commeKitchenHubBot. - Copiez le jeton que BotFather vous renvoie. Il ressemble à
123456789:AAH…: un nombre, un deux-points, puis des lettres.
Créer un bot Discord
Section intitulée « Créer un bot Discord »- Ouvrez le portail des développeurs Discord et sélectionnez New Application. Donnez-lui le nom que le bot doit porter.
- Ouvrez sa page Bot et sélectionnez Reset Token. Discord n’affiche le jeton qu’une fois : copiez-le tout de suite.
- 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 Bêta
Section intitulée « Créer un bot Matrix __SHB__caution__SHB__Bêta__SHB__ »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).
-
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. -
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. -
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 :
Fenêtre de terminal 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_tokende 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. -
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.
-
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 Bêta
Section intitulée « Créer un bot Mattermost __SHB__caution__SHB__Bêta__SHB__ »- 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.
- 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. - 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.
- 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 Bêta
Section intitulée « Créer un bot Twitch __SHB__caution__SHB__Bêta__SHB__ »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).
-
Choisissez le compte Twitch du bot. Son identifiant de connexion est le nom en minuscules dans
twitch.tv/<login>, commekitchenbot. -
Enregistrez une application dans la console des développeurs Twitch. Mettez OAuth Redirect URLs à
http://localhost:3000et 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. -
Donnez le consentement du bot. Connecté à Twitch en tant que bot, ouvrez cette adresse après y avoir mis votre identifiant client, et approuvez :
https://id.twitch.tv/oauth2/authorize?response_type=code&client_id=YOUR_CLIENT_ID&redirect_uri=http://localhost:3000&scope=chat%3Aread+chat%3AeditVotre navigateur ouvre ensuite une page
localhostqui ne s’affiche pas. C’est normal : copiez lecodequi se trouve dans son adresse. -
Échangez le code contre un jeton d’actualisation, tout de suite, puisqu’un code ne sert qu’une fois :
Fenêtre de terminal 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:3000Gardez le
refresh_tokende la réponse. -
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
Section intitulée « 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
Section intitulée « Telegram et Discord »- Choisissez le hub dont l’assistant doit répondre.
- 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.
- 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.
- Choisissez où il répond. Dans Telegram, envoyez d’abord
/start@YourBotdans 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. - 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
Section intitulée « Matrix, Mattermost et Twitch »- Choisissez le hub dont l’assistant doit répondre.
- 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.
- 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.
- 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
Section intitulée « 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
Section intitulée « 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
Section intitulée « 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 Bêta
Section intitulée « Dans Matrix __SHB__caution__SHB__Bêta__SHB__ »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 Bêta
Section intitulée « Dans Mattermost __SHB__caution__SHB__Bêta__SHB__ »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 Bêta
Section intitulée « Dans Twitch __SHB__caution__SHB__Bêta__SHB__ »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
Section intitulée « 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 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
Section intitulée « 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.
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
Section intitulée « 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 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
Section intitulée « 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.
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 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
Section intitulée « 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
Section intitulée « 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
Section intitulée « 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.
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.
Le bot ne joint pas son hub. Le panneau le dit sous À vérifier. Vérifiez que le hub fonctionne dans 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.
Messages dans la console
Section intitulée « 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, 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.