> 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

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](/docs/pt/reception-ai/integrations/webhooks) 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](https://t.me/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](/docs/pt/reception-ai/receptionist/testing) pedindo um retorno. O bot publica a mensagem no chat.

> **Tip**
>
> 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.                                                |