# Connecter votre compte Telegram à Substy

Créez votre bot, autorisez-le dans Chat Automation sur Telegram, puis confirmez le bon compte dans Substy.

URL: https://help.substy.ai/fr/articles/connect-telegram-business
Language: fr

Connectez votre propre bot, autorisez-le depuis le compte Telegram à gérer, puis confirmez ce compte dans Substy. Coller le jeton du bot ne suffit pas à connecter votre compte personnel.

Cette procédure est distincte de la connexion des notifications Telegram destinées aux alertes Substy.

Les captures d’écran et les libellés d’interface de ce guide sont en anglais. Les libellés peuvent différer si vous utilisez Telegram en français.

## Avant de commencer

- Utilisez le compte Telegram à connecter et un bot dédié qui vous appartient.
- Vous devez pouvoir gérer les créateurs de votre agence Substy. L’accès à un créateur déjà connecté dépend aussi de votre affectation.
- Gardez le jeton du bot confidentiel. Ne l’envoyez pas à un fan et ne l’incluez ni dans une capture d’écran ni dans un message au support.

## 1. Créer et vérifier votre bot

1. Ouvrez le compte officiel [@BotFather](https://t.me/BotFather) dans Telegram et créez votre bot.
2. Dans les paramètres du bot, activez **Secretary Mode**. Il ne s’agit pas des échanges secrets de Telegram.
3. Copiez le jeton secret du bot.
4. Dans la configuration du créateur sur Substy, choisissez Telegram. Collez le jeton dans **Bot token**.
5. Laissez **Replace this bot’s existing integration, if any** décoché, sauf si vous souhaitez remplacer un autre service. Ce remplacement peut empêcher l’autre service de fonctionner avec votre bot. Sélectionnez ensuite **Verify bot**.

![Écran Connect Telegram de Substy, avec le champ Bot token vide — interface en anglais](https://help.substy.ai/media/telegram/connect-telegram-bot-token.png)

## 2. Autoriser le bot dans Telegram

1. Passez au compte Telegram que Substy doit gérer.
2. Ouvrez **Profile → Edit → Chat Automation**.

![Option Chat Automation dans les paramètres du profil Telegram](https://help.substy.ai/media/telegram/chat-automation-entry.png)

3. Dans **Bot Username or Link**, saisissez le @nom_utilisateur ou le lien t.me de votre bot, puis sélectionnez-le. Utilisez bien le bot correspondant au jeton saisi dans Substy, pas celui d’une autre personne.

![Champ Bot Username or Link vide](https://help.substy.ai/media/telegram/chat-automation-bot-field.png)

4. Sélectionnez **All Private Chats Except…** et excluez les conversations privées sans rapport avec votre activité ainsi que celles auxquelles le bot ne doit pas accéder. Vérifiez les exclusions avant de continuer : cette option partage les conversations privées, sauf celles que vous excluez.
5. Sous **Manage Messages**, autorisez le bot à envoyer des réponses.
6. Sélectionnez **Done** en haut de l’écran pour enregistrer la configuration.

## 3. Confirmer le bon compte dans Substy

1. Revenez dans Substy. Votre compte Telegram apparaît sous **Confirm the Telegram account to connect**. S’il n’apparaît pas, sélectionnez **Check connection**.
2. Comparez le nom, le nom d’utilisateur (s’il est présent) et l’identifiant Telegram affichés avec ceux du compte à connecter.

![Compte Telegram en attente de confirmation dans Substy, avec le bouton Connect this account](https://help.substy.ai/media/telegram/connect-telegram-account-confirmation.png)

3. Sélectionnez **Connect this account**. Si une boîte de dialogue de confirmation apparaît, vérifiez à nouveau les informations du compte, puis sélectionnez **Confirm account**.
4. Si le bouton apparaît, sélectionnez **Continue** pour terminer.

Une connexion active ne permet pas nécessairement de répondre dans toutes les conversations. Les autorisations Telegram et le délai de réponse restent applicables.

## Si la configuration n’aboutit pas

- **Waiting for Telegram setup :** vérifiez que vous avez ajouté le même bot au bon compte Telegram et sélectionné **Done** après avoir configuré l’accès aux conversations. Sélectionnez ensuite **Check connection** dans Substy.
- **Impossible de sélectionner le compte :** activez le bot dans les paramètres de connexion de Telegram et autorisez-le à envoyer des réponses sous **Manage Messages**, puis sélectionnez **Check connection** dans Substy.
- **Jeton refusé :** collez le jeton actuel complet fourni par BotFather, et non le nom d’utilisateur du bot.
- **Un autre service utilise déjà ce bot :** utilisez un bot dédié ou décidez explicitement si vous pouvez remplacer l’intégration existante.
- **Le mauvais compte apparaît :** ne le confirmez pas. Vérifiez dans Telegram quel compte a autorisé le bot.