Vinculando conversas a issues do Linear
Boa parte das conversas de suporte termina virando tarefa para o time de produto ou engenharia: um bug a corrigir, uma solicitação de melhoria, uma dúvida que precisa de investigação técnica. A integração nativa com o Linear permite criar e vincular issues diretamente a partir da conversa, sem copiar e colar contexto entre ferramentas.
Sobre o Jira: atualmente a integração nativa contempla Linear. Para Jira, recomendamos usar webhooks de saída ou automações via Zapier/n8n para criar issues a partir de eventos da conversa. As demais informações desta página referem-se ao Linear.
Conectando o Linear
A configuração é feita uma única vez pelo administrador da conta:
- Acesse Configurações → Integrações → Linear.
- Clique em Conectar com o Linear. Você é redirecionado ao fluxo OAuth oficial do Linear, com escopos de leitura e escrita.
- Autorize o app no workspace correto. O Linear devolve os tokens de acesso e refresh, que ficam armazenados de forma criptografada.
- Após o retorno ao painel, a integração já fica disponível para todos os usuários autorizados a operar conversas.
A integração utiliza um único vínculo de workspace por conta, e as ações executadas no Linear são registradas como vindas do app autorizado, respeitando as permissões do membro do Linear vinculado ao token.
Criando uma issue a partir da conversa
Dentro de uma conversa, abra o painel lateral direito e localize a seção Tickets do Linear. As ações disponíveis:
- Nova issue — abre um modal com:
- Time (carregado dinamicamente via API do Linear).
- Projeto (opcional, filtrado pelo time).
- Título e descrição (a descrição pode ser pré-preenchida com o conteúdo da conversa).
- Prioridade, responsável, status inicial e rótulos.
- Vincular issue existente — busca por palavra-chave (a busca consulta a API do Linear em tempo real) e cria a relação.
- Desvincular — remove a relação sem apagar a issue.
Ao criar a issue, ela é registrada no Linear com um link de retorno para a conversa, garantindo navegação bidirecional. A criação e o vínculo aparecem como mensagens de sistema dentro da conversa, com o identificador da issue.
Status e atualizações
A lista de issues vinculadas a uma conversa é exibida diretamente no painel lateral, com:
- Identificador da issue (ex.:
ENG-1234). - Título.
- Status atual.
- Responsável.
A consulta é feita sob demanda, então o status reflete o estado atual no Linear no momento em que o painel abre. Isso significa que, se o ticket muda de status no Linear, basta recarregar a conversa para ver a mudança.
Sugestão de leitura visual rápida com base nos estados padrão do Linear:
| Status no Linear | Como interpretar na conversa |
|---|---|
| Backlog / Triage | Aguardando triagem da engenharia |
| In Progress | Em desenvolvimento |
| In Review / QA | Em revisão antes de fechar |
| Done / Completed | Concluído — vale dar retorno ao cliente |
| Cancelled | Cancelado |
Quando o ticket é concluído, é uma boa prática voltar à conversa, fechar o loop com o cliente e marcar a conversa como resolvida. Não há automação que envie mensagem ao contato automaticamente — o atendente decide o tom e o conteúdo do retorno.
Casos de uso recomendados
- Bug reportado por cliente: o atendente cria a issue com prints e logs já anexados, vinculando a conversa. O dev resolve, o status vira Done, o atendente avisa o cliente.
- Pedido de feature: vincular várias conversas à mesma issue ajuda o produto a priorizar pelo número de relatos.
- Investigação técnica: o suporte abre uma issue de triagem e a engenharia retoma o contato pelo painel se precisar de mais informações.
Boas práticas
- Padronize títulos: prefira "[Bug] X não funciona em Y" a textos longos copiados da conversa.
- Use rótulos consistentes (ex.:
origem-suporte) para extrair métricas de quanto trabalho do dev nasce do atendimento. - Não vincule issues a conversas resolvidas; reabra ou crie nova se for retomar o assunto.
- Revoke o token e reconecte caso o membro autorizador saia da empresa — a integração faz revoke automático no botão Desconectar.
Importante: quem visualiza dados da issue dentro da conversa respeita as permissões do Linear. Se a aplicação não tiver acesso a um time ou projeto, as ações relacionadas não aparecem.
Próximos passos
Para complementar a triagem com base de conhecimento estruturada, veja Notion como base do Capitão IA. Para alertas em tempo real ao time, configure também o Slack.