Linear

Crie automaticamente issues no Linear quando incidentes são abertos, sincronize mudanças de status e adicione comentários da timeline via API GraphQL do Linear.

Configuração

1. Vá em Configurações > Integrações > Linear no painel do Batida.
2. Gere uma API key do Linear em Linear > Configurações > API > Chaves de API pessoais.
3. Insira a API key e selecione a equipe padrão e o projeto.
4. Clique em Salvar e Verificar.

API Key:   lin_api_xxxxxxxxxxxxxxxx
Equipe:    Engineering
Projeto:   Resposta a Incidentes

Permissões da API key

A API key do Linear deve ter acesso de leitura e escrita em issues, comentários e associação a projetos. Use uma key de conta de serviço dedicada em vez de um token pessoal para ambientes de produção.

Criação automática de issues

Quando um incidente é aberto no Batida, um issue do Linear é criado via API GraphQL com o seguinte mapeamento:

Campo do Batida	Campo do Linear
Título do incidente	Título do issue
Descrição	Descrição do issue (Markdown)
Severidade	Prioridade (critical = Urgent, high = High, medium = Medium, low = Low)
Respondente atribuído	Assignee (correspondido por email)
Equipe	Identificador da equipe no Linear

Exemplo de mutation GraphQL

mutation CreateIncidentIssue {
  issueCreate(
    input: {
      title: "INC-42: Pico de latência na API"
      description: "## Detalhes do Incidente\n\n**Severidade:** crítica\n\n[Ver no Batida](https://app.batida.io/incidents/42)"
      teamId: "ENG"
      priority: 0
      assigneeId: "jane"
      labelIds: ["severity-critical"]
    }
  ) {
    issue {
      id
      identifier
    }
  }
}

O identificador do issue no Linear (ex.: ENG-142) é armazenado no incidente do Batida e exibido na interface.

Sincronização de status

O Batida sincroniza transições de status para o Linear:

Status no Batida	Status do issue Linear
Aberto / Investigando	In Progress (Started)
Identificado	In Progress
Monitorando	Done
Resolvido	Done (Canceled ou Completed, conforme configuração)

Mapeamento de status personalizado

Você pode personalizar qual estado do workflow do Linear mapeia para cada status do Batida nas configurações da integração.

Comentários da timeline

Cada comentário da timeline adicionado no Batida é postado como comentário no issue do Linear com o nome do autor e timestamp.

Troubleshooting

• "Falha na autenticação": Verifique se a API key é válida e não foi revogada. Gere uma nova key nas configurações do Linear.
• Equipe não encontrada: Garanta que o identificador da equipe corresponde exatamente. As keys de equipe do Linear são sensíveis a maiúsculas e minúsculas.
• Issues não sincronizando: Verifique os logs da integração em Configurações > Integrações > Linear > Log de Atividade para mensagens de erro detalhadas.