---
title: Déployer sur Telegram
description: >-
  Exécutez un agent texte comme bot Telegram dans les messages privés, les
  groupes et les canaux, avec un token fourni par BotFather et rien d'autre à
  héberger.
---
<Badge variant="accent">Agents textuels</Badge>

Un déploiement Telegram exécute un agent texte comme bot Telegram : il *fonctionne
comme un bot Telegram dans les messages privés, les groupes et les canaux*. Chaque
conversation avec le bot constitue une conversation unique pour l'agent.

:::note[Avant de commencer]
Vous devez disposer d'un agent texte publié et d'un bot créé avec **@BotFather**
dans Telegram, qui vous fournit le token du bot.
:::

## Créer le déploiement

1. **Lancez l'assistant**

    Sous **Launch AI Text**, choisissez **New Deployment** (nouveau déploiement),
    puis **Telegram**. Ce choix fait passer l'assistant directement à l'étape de
    l'agent.

2. **Sélectionnez l'agent**

    Choisissez l'agent texte sous **Agent**. **Next** (suivant).

3. **Nommez-le**

    Acceptez ou modifiez le **Display Name** (nom affiché), puis **Create
    Deployment** (créer le déploiement). Le déploiement apparaît dans la liste
    avec la mention **Needs setup** (configuration requise) et une **Webhook URL**
    (URL de webhook).

![L'étape de l'agent dans New Deployment pour Telegram.](/media/deploy/new-deployment-telegram.webp)

## Connecter Telegram

Ouvrez le déploiement depuis la liste et saisissez le **bot token** (token du bot)
émis par BotFather. Telegram transmet les mises à jour par webhook ; le déploiement
enregistre sa **Webhook URL** avec le token, donc rien d'autre n'est nécessaire du
côté de Telegram.

Pour les groupes, la commande `/setprivacy` de BotFather détermine si le bot voit
tous les messages ou seulement les commandes et les mentions. Laissez la
confidentialité activée si le bot ne doit répondre que lorsqu'on s'adresse à lui.

## Vérifier

- Le déploiement affiche **Active** (actif).
- Ouvrez le bot dans Telegram et envoyez `/start` ou un message. La réponse provient
  de l'agent, et l'échange apparaît sous **Conversations** avec la plateforme
  `telegram`.

## Dépannage

- **Le bot ne répond jamais.** Le token est incorrect ou a été régénéré dans
  BotFather. Collez le token actuel.
- **Il répond en messages privés mais ignore un groupe.** La confidentialité de
  groupe est activée, il ne voit donc que les messages qui le mentionnent, ou il
  n'a pas été ajouté comme membre. Mentionnez-le, ou désactivez la confidentialité
  avec `/setprivacy`.

## Voir aussi

- [Présentation des déploiements de bots](/fr/deploy/bot-deployments/overview)
- [Conversations](/fr/operate/conversations)
- [Démarrage rapide : votre premier agent texte](/fr/get-started/quickstart-text-agent)