> This is a page from the ElevenLabs documentation. For a complete page index, fetch https://elevenlabs.io/docs/llms.txt. For the full documentation in a single file, fetch https://elevenlabs.io/docs/llms-full.txt.

# Telegram

Un bot Telegram permet à votre réceptionniste de vous envoyer un message, à vous ou au groupe de votre équipe, pendant un appel, par exemple lorsqu'un appelant demande à être rappelé ou signale un problème urgent. L'[outil webhook](/docs/fr/reception-ai/integrations/webhooks) appelle la méthode `sendMessage` de l'API Bot de Telegram.

## Créez un bot et trouvez l'identifiant de la conversation

### Créez le bot

Dans Telegram, ouvrez une conversation avec [@BotFather](https://t.me/BotFather), envoyez `/newbot`, puis suivez les instructions pour le nommer. BotFather répond avec un jeton de bot, tel que `123456789:AA...`. Traitez-le comme un secret : toute personne qui le possède contrôle le bot.

### Démarrez une conversation avec le bot

Les bots ne peuvent envoyer de messages qu'aux conversations auxquelles ils participent.

* **Pour vous envoyer un message :** ouvrez une conversation avec votre nouveau bot et sélectionnez **Start**.
* **Pour envoyer un message à un groupe :** ajoutez le bot au groupe, puis envoyez un message qui le mentionne, par exemple `/start@YOUR_BOT_NAME`.

### Trouvez l'identifiant de la conversation

Dans un navigateur, ouvrez `https://api.telegram.org/botBOT_TOKEN/getUpdates`, en remplaçant `BOT_TOKEN` par votre jeton de bot. Recherchez votre message dans la réponse et copiez le nombre après `"chat":{"id":`. L'identifiant d'un groupe est négatif, par exemple `-1001234567890` ; conservez le signe moins.

Si la réponse est vide, envoyez un autre message au bot et actualisez la page.

## Créez l'outil webhook

Accédez à **Intégrations**, sélectionnez **Ajouter une intégration**, puis choisissez **Outil webhook**.

| Champ                    | Valeur                                                                                                                                                                                        |
| ------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Nom**                  | `notify_team_in_telegram`                                                                                                                                                                     |
| **Description**          | "Envoyer un message à l'équipe sur Telegram. Utilisez cet outil lorsqu'un appelant demande à être rappelé, souhaite parler à une personne ou signale un problème urgent."                     |
| **Méthode**              | POST                                                                                                                                                                                          |
| **URL**                  | `https://api.telegram.org/botBOT_TOKEN/sendMessage`, en remplaçant `BOT_TOKEN` par votre jeton de bot                                                                                         |
| **Paramètres du corps**  | `chat_id` (chaîne, obligatoire) : "Toujours la valeur exacte `CHAT_ID`."  `text` (chaîne, obligatoire) : "Le message : le nom de l'appelant, son numéro de téléphone et ce dont il a besoin." |
| **Attribuer aux agents** | **Réceptionniste**                                                                                                                                                                            |

Remplacez `CHAT_ID` dans la description par l'identifiant de votre conversation. L'URL contient votre jeton de bot, traitez-le donc également comme un secret.

Sélectionnez **Activer**, puis [testez votre réceptionniste](/docs/fr/reception-ai/receptionist/testing) en demandant à être rappelé. Le bot publie le message dans la conversation.

> **Tip**
>
> Pour envoyer des messages à plusieurs conversations, créez un outil par identifiant de conversation. Le même bot peut publier dans toutes ces conversations.

## Résolution des problèmes

| Problème                           | Vérifications à effectuer                                                                                                                                                          |
| ---------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Telegram renvoie 401               | Le jeton de bot dans l'URL est incorrect ou a été révoqué dans BotFather. L'URL doit contenir `bot` juste avant le jeton.                                                          |
| `Bad Request: chat not found`      | Vérifiez l'identifiant de la conversation, y compris le signe moins pour les groupes, et assurez-vous d'avoir démarré une conversation avec le bot ou de l'avoir ajouté au groupe. |
| `Forbidden: bot was kicked`        | Le bot a été retiré du groupe. Ajoutez-le de nouveau.                                                                                                                              |
| `getUpdates` n'affiche rien        | Dans les groupes, les bots ne voient que les messages qui les mentionnent. Envoyez `/start@YOUR_BOT_NAME` et actualisez la page.                                                   |
| Le réceptionniste ne publie jamais | Indiquez dans la description de l'outil les situations dans lesquelles il doit publier.                                                                                            |