Telegram | ElevenLabs Documentation

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 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, 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 en demandant à être rappelé. Le bot publie le message dans la conversation.

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.