# Telegram

Conecte um bot do Telegram a um projeto e escolha quem pode enviar tarefas.

Canonical page: https://beeuni.ai/docs/pt/connect/telegram

Um bot do Telegram permite enviar tarefas ao agente de um projeto por uma conversa. As respostas chegam à mesma conversa, e você pode consultar o histórico completo da sessão no Beeuni.

## Conectar o bot

1. Abra o **@BotFather** no Telegram e crie um bot com `/newbot`. Copie o token do bot.
2. Abra a página **Canais** do projeto. Encontre **Telegram**, informe o token e conecte o bot.
3. Envie `/start` ao bot no Telegram. Se sua conta ainda não estiver autorizada, a resposta mostrará seu ID numérico do Telegram.
4. Adicione esse ID à lista de pessoas autorizadas no Beeuni e salve. Depois, envie uma tarefa ao bot.

Com a lista vazia, ninguém pode executar tarefas. Conectar o bot ou alterar a lista exige permissão para gerenciar os conectores do projeto. O token fica no servidor: não é retornado nos dados de instalação nem enviado ao agente.

## Sessões e acesso

A primeira tarefa de uma conversa inicia uma sessão. As mensagens seguintes continuam nessa sessão. Cada tópico de fórum tem uma sessão própria. Envie `/new` para que a próxima mensagem inicie outra sessão. O histórico anterior permanece no Beeuni.

As pessoas autorizadas executam tarefas com a identidade de automação do projeto. As sessões ficam visíveis no projeto. Isso não equivale a entrar no Beeuni com a conta de cada remetente. Adicione apenas quem pode executar tarefas com os acessos compartilhados do projeto.

Para deixar de receber tarefas pelo bot, desconecte-o na página Canais.

## SDK

O SDK oferece `getTelegramInstallation`, `connectTelegram`, `setTelegramAllowedUsers` e `disconnectTelegram`. Passe o ID do projeto para essas funções. Consulte [Autenticação do SDK](/docs/pt/sdk/auth) para configurar o token de acesso.