Telegram | ElevenLabs Documentation

Um bot do Telegram permite que sua recepcionista envie uma mensagem para você ou para o grupo da sua equipe durante uma chamada, por exemplo, quando alguém pede um retorno ou relata algo urgente. A ferramenta de webhook chama o método sendMessage da API de Bots do Telegram.

Crie um bot e encontre o ID do chat

Crie o bot

No Telegram, abra uma conversa com @BotFather, envie /newbot e siga as instruções para dar um nome a ele. O BotFather responde com um token de bot, como 123456789:AA.... Trate-o como segredo: qualquer pessoa que o tiver controlará o bot.

Inicie um chat com o bot

Bots só podem enviar mensagens para chats dos quais fazem parte.

Para enviar uma mensagem a si mesmo: abra um chat com seu novo bot e selecione Iniciar.
Para enviar uma mensagem a um grupo: adicione o bot ao grupo e envie uma mensagem que o mencione, como /start@YOUR_BOT_NAME.

Encontre o ID do chat

No navegador, abra https://api.telegram.org/botBOT_TOKEN/getUpdates, substituindo BOT_TOKEN pelo token do seu bot. Encontre sua mensagem na resposta e copie o número depois de "chat":{"id":. O ID de um grupo é negativo, por exemplo, -1001234567890; mantenha o sinal de menos.

Se a resposta estiver vazia, envie outra mensagem ao bot e recarregue a página.

Crie a ferramenta de webhook

Acesse Integrações, selecione Adicionar integração e escolha Ferramenta de webhook.

Campo	Valor
Nome	`notify_team_in_telegram`
Descrição	”Envie uma mensagem para a equipe no Telegram. Use esta ferramenta quando alguém pedir um retorno, quiser falar com uma pessoa ou relatar um problema urgente.”
Método	POST
URL	`https://api.telegram.org/botBOT_TOKEN/sendMessage`, substituindo `BOT_TOKEN` pelo token do seu bot
Parâmetros do corpo	`chat_id` (string, obrigatório): “Sempre o valor exato `CHAT_ID`.” `text` (string, obrigatório): “A mensagem: nome, número de telefone e necessidade de quem ligou.”
Atribuir a agentes	Recepcionista

Substitua CHAT_ID na descrição pelo ID do seu chat. A URL contém o token do seu bot, então trate-a como segredo também.

Selecione Ativar e teste sua recepcionista pedindo um retorno. O bot publica a mensagem no chat.

Para enviar mensagens a vários chats, crie uma ferramenta para cada ID de chat. O mesmo bot pode publicar em todos eles.

Solução de problemas

Problema	O que verificar
O Telegram retorna 401	O token do bot na URL está incorreto ou foi revogado no BotFather. A URL deve ter `bot` imediatamente antes do token.
`Bad Request: chat not found`	Verifique o ID do chat, incluindo o sinal de menos para grupos, e se você iniciou um chat com o bot ou o adicionou ao grupo.
`Forbidden: bot was kicked`	O bot foi removido do grupo. Adicione-o novamente.
`getUpdates` não mostra nada	Em grupos, os bots só veem mensagens que os mencionam. Envie `/start@YOUR_BOT_NAME` e recarregue.
A recepcionista nunca publica	Faça a descrição da ferramenta indicar as situações em que ela deve publicar.