Telegram

A integração com o Telegram conecta um bot do Telegram ao Almirant para receber feedback dos usuários, notificações de eventos e permitir interação básica com a plataforma diretamente pelo chat.

Como funciona

O Almirant se integra ao Telegram por meio de um bot que atua como ponte entre os usuários do Telegram e a plataforma. O bot pode:

• Receber feedback -- Os usuários enviam mensagens ao bot, que são registradas como feedback no Almirant.
• Enviar notificações -- O Almirant notifica pelo Telegram sobre eventos relevantes (mudanças de status, atribuições, alertas de cota).
• Executar comandos -- Comandos básicos para consultar informações do projeto.

Configurar o bot do Telegram

1. Criar o bot

Se sua organização não tiver um bot configurado, você precisará criar um:

1. Abra o Telegram e procure por @BotFather.
2. Envie o comando /newbot.
3. Siga as instruções para definir o nome e o username do bot.
4. O BotFather fornecerá um token de API. Guarde-o com segurança.

2. Conectar o bot ao Almirant

1. Acesse Configurações > Integrações > Telegram.
2. Informe o token de API do bot.
3. Configure as opções de notificação desejadas.
4. Salve as configurações.
5. O Almirant configurará automaticamente o webhook do bot para receber mensagens.

3. Verificar a conexão

Envie uma mensagem de teste ao bot pelo Telegram. Ela deverá aparecer como feedback no Almirant.

Receber feedback

Uma das principais funcionalidades do bot é receber feedback de usuários finais ou stakeholders que não têm acesso ao Almirant.

Fluxo de feedback

1. Um usuário envia uma mensagem ao bot do Telegram (texto, imagem ou arquivo).
2. O bot encaminha a mensagem ao Almirant pelo webhook.
3. O Almirant registra o feedback vinculado à organização.
4. O feedback aparece na seção Ideias e feedback do projeto para revisão.

Feedback de clientes

O bot do Telegram é ideal para coletar feedback de clientes ou usuários finais que não precisam de acesso direto ao Almirant. Compartilhe o link do bot com as pessoas que devem poder enviar feedback.

Formato das mensagens

O bot aceita diferentes tipos de conteúdo:

Tipo	Como é processado
Texto	É registrado como feedback textual
Imagem	É armazenada como anexo do feedback
Arquivo	É armazenado como anexo do feedback
Resposta a mensagem	É vinculada como thread de conversa

Notificações

Configure quais eventos do projeto você deseja receber como notificações no Telegram:

Evento	Descrição
Work item atribuído	Um work item é atribuído a você
Mudança de status	Um work item muda de coluna no board
Sprint iniciado/finalizado	Um sprint começa ou termina
Feedback recebido	Um novo feedback é registrado no projeto
Cota de IA	Alerta quando a cota está perto de se esgotar

Para configurar as notificações:

1. Acesse Configurações > Integrações > Telegram.
2. Ative ou desative os eventos que deseja receber.
3. Salve as alterações.

Comandos do bot

O bot do Telegram oferece comandos básicos para consultar informações:

Comando	Descrição
/start	Inicia a interação com o bot e exibe uma mensagem de boas-vindas
/help	Exibe a lista de comandos disponíveis
/status	Consulta o status resumido do projeto ativo
/feedback [texto]	Envia feedback diretamente com um comando

Desconectar o Telegram

Para desconectar o bot:

1. Acesse Configurações > Integrações > Telegram.
2. Clique em Desconectar.
3. Confirme a desconexão.

aviso

Desconectar o bot interromperá o recebimento de feedback e notificações pelo Telegram. O histórico de feedback já registrado permanecerá no Almirant.

Para desenvolvedores

Arquitetura da integração

A integração com o Telegram é composta por:

• Webhook endpoint: Recebe as atualizações do bot do Telegram (mensagens, comandos, callbacks).
• Processador de mensagens: Classifica o tipo de mensagem e o encaminha ao serviço correspondente (feedback, comando, notificação).
• Serviço de notificações: Envia mensagens proativas ao chat do Telegram quando ocorrem eventos no Almirant.

Fluxo do webhook

Telegram Bot API --> POST /webhooks/telegram --> Procesador de mensajes
                                                       |
                                         +-------------+-------------+
                                         |             |             |
                                     Feedback     Comando     Notificacion