Integrações

O Qalibr conecta dois tipos de ferramentas: de onde os bugs vêm e para onde eles vão. Gerencie ambos em Integrações, na barra lateral do dashboard — conecte o Qalibr às ferramentas em que seu time já vive.

De onde os bugs chegam

O Slack é a integração de chat ativa. O Qalibr escuta os canais que você escolher. Para reportar um bug, poste em um canal monitorado e mencione @Qalibr — essa menção é o gatilho. O Qalibr não reage a reações com emoji, comandos de barra nem mensagens sem menção.

A menção pode estar na primeira mensagem ou em qualquer resposta de uma thread existente; de qualquer forma o Qalibr lê a thread inteira, inclusive capturas de tela que colegas postaram antes. Um arquivo postado sem nenhum texto é ignorado, então coloque a menção em uma mensagem que tenha palavras.

O Qalibr só lê os canais que você selecionar; todo o resto do seu workspace permanece intocado. Mude a seleção a qualquer momento em Integrações → card do Slack → Gerenciar canais.

Selecionar um canal faz o Qalibr entrar nele. Desmarcar faz ele sair. Um canal privado não pode ser acessado automaticamente — convide o Qalibr lá com /invite @Qalibr.

Quantos canais você pode monitorar depende do seu plano:

Colar é o segundo caminho de entrada, e não exige integração nenhuma. Abra Colar no dashboard, jogue lá uma conversa de qualquer lugar — WhatsApp, e-mail, ServiceNow, um formulário web — marque opcionalmente de onde veio e quem reportou, e envie. Cada item vira um relato próprio e passa pela mesma triagem. Até 50 itens por envio, 50.000 caracteres cada; sem anexos nesse caminho.

Para onde os bugs vão

Bugs aprovados viram issues no seu tracker. Quando o Qalibr encontra uma duplicata forte, ele pode comentar ou reabrir o issue existente em vez de criar um novo.

Conectar um tracker é uma credencial, não um handshake OAuth — e você não digita identificadores à mão. Informe a credencial e o Qalibr busca a lista de times ou projetos que ela enxerga, e você escolhe:

• Linear — uma chave de API pessoal (começa com lin_api_), depois escolha seu time.
• Jira — seu site (suaempresa.atlassian.net), o e-mail da sua conta Atlassian e um token de API, depois escolha o projeto e o tipo de issue. Tipos de issue pertencem a um projeto, então trocar o projeto busca a lista de novo. Escolha um: em branco, o Jira cai no primeiro tipo de issue não-subtarefa do site inteiro, o que raramente é o que você quer.

Se a busca estiver indisponível, você ainda pode digitar o valor à mão.

Duas coisas específicas do Jira

O status ao vivo do ticket exige um webhook. O Qalibr o registra durante a conexão, mas isso exige a permissão Administer Jira no seu site. Sem ela, a conexão funciona do mesmo jeito e os tickets continuam sendo criados — o Qalibr entrega a você uma URL de callback, um segredo gerado, os eventos e a JQL, e mostra o passo a passo para adicionar o webhook à mão. Esse é um caminho previsto, não um erro. O segredo é exibido uma única vez e não pode ser lido de novo; se você perdê-lo, gere outro.

A proteção contra duplicatas na criação do ticket é de melhor esforço. O Jira não aceita um id de issue fornecido pelo cliente, então o Qalibr marca cada ticket que cria com um rótulo qalibr-run-… e procura esse rótulo antes de tentar de novo. O índice de busca do Jira atualiza com um pequeno atraso, então uma nova tentativa dentro desse atraso ainda pode gerar um segundo ticket. No Linear a proteção é exata. Esses rótulos também são o motivo de você ver qalibr-run-… na sua lista de rótulos do Jira.

Saúde da conexão

Cada integração exibe um status para você saber que está funcionando:

Reconectar um tracker em um site do Jira diferente — ou em um time do Linear diferente — descarta o webhook antigo e registra um novo. Espere uma pequena lacuna no status ao vivo e, no Jira sem admin do site, uma nova configuração manual.