Feedback
O módulo de feedback permite coletar opiniões, solicitações e relatos dos seus usuários por vários canais e centralizá-los no Almirant. A IA agrupa automaticamente feedback semelhante e sugere ações, conectando a voz dos seus usuários diretamente ao seu processo de ideação e planejamento.
Fluxo completo
O feedback percorre um caminho desde a coleta até a implementação:
- Coleta -- O feedback chega de qualquer uma das quatro fontes compatíveis.
- Processamento -- A IA analisa o feedback, agrupa entradas semelhantes (clustering) e gera sugestões.
- Vinculação -- O feedback é vinculado a ideias existentes ou novas.
- Ação -- Ideias com feedback suficiente são aprovadas e promovidas a work items.
Fontes de feedback
Widget incorporado
Integre um widget diretamente ao seu produto para que os usuários enviem feedback sem sair da aplicação. O widget captura a mensagem do usuário junto com metadados contextuais (página atual, sessão etc.).
Bot do Telegram
Conecte um bot do Telegram para receber feedback diretamente de um grupo ou canal. As mensagens enviadas ao bot são registradas como entradas de feedback no Almirant com a fonte telegram.
API pública
Envie feedback programaticamente de qualquer sistema externo usando a API pública:
POST /api/feedback/ingest
O endpoint aceita um payload JSON com o conteúdo do feedback e metadados opcionais. Isso permite integrar a coleta de feedback a formulários personalizados, chatbots, aplicações móveis ou qualquer serviço que possa fazer requisições HTTP.
Manual
Crie entradas de feedback manualmente pela interface do Almirant. É útil para registrar feedback recebido por e-mail, ligações, reuniões ou qualquer outro canal não automatizado.
Lista de feedback
A visualização principal de feedback mostra todas as entradas recebidas com as seguintes informações:
| Campo | Descrição |
|---|---|
| Conteúdo | Texto do feedback enviado pelo usuário |
| Fonte | Canal de origem (widget, telegram, api, manual) |
| Data | Data e hora de recebimento |
| Cluster | Grupo temático atribuído pela IA |
| Ideia vinculada | Ideia à qual está associado, se aplicável |
Clustering com IA
À medida que o feedback se acumula, a IA analisa o conteúdo e agrupa automaticamente as entradas que tratam do mesmo tema ou solicitação. Isso permite:
- Identificar padrões -- Detectar qual funcionalidade ou melhoria vários usuários solicitam.
- Quantificar a demanda -- Ver quantos usuários pedem a mesma coisa.
- Priorizar -- Tomar decisões com base no volume real de feedback.
Cada cluster tem um nome descritivo gerado pela IA (por exemplo, "Solicitação de exportação em PDF" ou "Problemas ao carregar imagens") e agrupa todas as entradas de feedback relacionadas.
Como funciona
- Cada nova entrada de feedback é analisada em relação aos clusters existentes.
- Se o conteúdo for semelhante a um cluster existente, será adicionado automaticamente.
- Se não se encaixar em nenhum cluster, um novo poderá ser criado.
- Os clusters são atualizados dinamicamente conforme chega mais feedback.
Sugestões de IA
Com base nos clusters de feedback, a IA pode gerar sugestões como:
- Criar uma ideia a partir de um cluster com alto volume.
- Vincular feedback a uma ideia existente que já atende àquela solicitação.
- Priorizar ideias que têm mais feedback associado.
As sugestões aparecem como recomendações que você pode aceitar ou descartar.
Vincular feedback a ideias
A etapa mais importante é conectar o feedback às ideias para criar rastreabilidade entre o que os usuários pedem e o que a equipe decide construir.
Vincular pelo feedback
Nos detalhes de uma entrada de feedback, clique em Vincular à ideia e selecione uma ideia existente ou crie uma nova. Isso estabelece uma relação direta entre o feedback e a ideia.
Vincular pela ideia
Nos detalhes de uma ideia, você pode pesquisar e vincular entradas de feedback existentes. Isso é útil quando você já criou uma ideia e quer associar o feedback que a justifica.
Desvincular feedback
Se você vincular um feedback a uma ideia por engano, poderá desvincular a relação nos detalhes do feedback ou da ideia. A entrada de feedback não será excluída, apenas a associação será removida.
O poder da rastreabilidade
Quando o feedback é vinculado a ideias, e as ideias são promovidas a work items, uma cadeia completa é criada:
Essa cadeia permite responder a perguntas como:
- "Por que estamos construindo isso?" -- Porque 15 usuários solicitaram isso (veja o feedback vinculado).
- "Quais usuários se beneficiam?" -- Os que enviaram feedback sobre esse tema.
- "Qual é o impacto desta tarefa?" -- Ela resolve o maior cluster de feedback do mês.
Consulte Promoção e rastreabilidade para mais detalhes sobre o fluxo completo.
O feedback expõe os seguintes endpoints e tools MCP:
API pública:
| Endpoint | Descrição |
|---|---|
POST /api/feedback/ingest | Ingestão de feedback de fontes externas |
GET /api/feedback/bootstrap | Obtém a configuração inicial do widget de feedback |
Tools MCP para vinculação:
| Tool | Descrição |
|---|---|
link_feedback_to_idea_item | Vincula uma entrada de feedback a uma ideia |
unlink_feedback_from_idea_item | Desvincula um feedback de uma ideia |
O endpoint de ingestão (/api/feedback/ingest) é público e não exige autenticação de sessão, o que permite integrá-lo a widgets client-side ou serviços externos. Ele aceita um payload JSON com o conteúdo do feedback e metadados opcionais, como fonte e identificador do usuário.
Relacionado: Gerenciamento de ideias | Promoção e rastreabilidade