Telegram

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

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 para configurar o token de acesso.