O que você vai configurar
- Uma chave de API pessoal do Linear conectada ao Elido: sem OAuth e sem registrar um app.
- Issues do Linear criadas automaticamente quando o monitor de links quebrados do Elido encontra um destino que não funciona mais.
- Um time de destino do Linear por workspace do Elido.
A integração com o Linear abre uma issue automaticamente quando o Elido detecta um link quebrado: um link curto cujo destino retorna um erro ou para de responder. O monitor de links quebrados verifica os links uma vez por dia.
O que você precisa
- Uma conta do Linear com permissão para criar issues no time de destino.
- Uma chave de API pessoal do Linear (leva 30 segundos para gerar).
- Um papel no Elido que possa gerenciar integrações no workspace.
Gerar uma chave de API do Linear
- Vá para Linear → Settings → API → Personal API keys.
- Clique em Create key. Dê um nome como "Elido integration".
- Copie a chave. O Linear só a mostra uma vez.
Configurar no Elido
- Vá para Dashboard → Integrations → Linear.
- Cole a chave de API e valide-a. O Elido lista todos os times aos quais a sua chave tem acesso.
- Selecione o time de destino. As issues serão criadas lá.
- Salve. A chave é armazenada criptografada.
O que é gravado no Linear
Quando um link é detectado como quebrado pela primeira vez (e de novo se continuar quebrado 24 horas depois), o Elido abre uma issue com o título "Broken link: [short URL]". Ela contém:
- A URL curta e a URL de destino.
- O código de status HTTP e a mensagem de erro, quando disponíveis.
- O horário em que o Elido detectou o problema.
O Elido cria apenas uma issue por detecção e não lê nada de volta do Linear: ele não fecha issues nem acompanha o estado delas. Isso fica a cargo do fluxo de trabalho do seu time.
Solução de problemas
"Not authorized" ao validar a chave: A chave de API está errada ou foi revogada. Gere-a novamente em Linear Settings → API.
Issues aparecendo no time errado: Verifique a seleção de time em Dashboard → Integrations → Linear. Se uma chave tem acesso a vários times, o seletor pode ter escolhido o primeiro por padrão.
Nenhuma issue criada: Somente links quebrados criam issues. Verifique se a conexão do Linear aparece como conectada e não foi revogada.
Issues duplicadas: O Elido abre no máximo uma issue por detecção. Se você vir duplicatas, verifique se o mesmo time do Linear não está conectado em dois workspaces do Elido.