For AI agents: the complete documentation index is available at https://docs.clickmax.io/llms.txt, the full documentation bundle is available at https://docs.clickmax.io/llms-full.txt, and this page is available as Markdown at https://docs.clickmax.io/features/messaging/create-linear-issue-from-ticket.md.
  • Português
  • Como criar uma issue no Linear a partir de um chamado?

    Conecte o Linear em Integrações com uma chave de API pessoal, escolha o time (e, se quiser, o projeto) que recebe as issues e, no detalhe do chamado, clique em Criar issue no Linear. A issue nasce no Linear e o chamado passa a mostrar o link e o status dela.

    Antes de começar

    • Conectar o Linear: papel de workspace Proprietário, Administrador, Editor ou Colaborador. Financeiro, Convidado e Atendente não veem Integrações.
    • Criar a issue: acesso à página Chamados; veja Como atender um chamado aberto pelo chat do site?.
    • Uma conta no Linear com permissão para criar issues no time escolhido.
    • Cada workspace pode ter uma integração Linear ativa.

    Conectar o Linear

    1. Gere a chave no Linear: em Configurações > Conta > Segurança e acesso > Chaves de API pessoais, crie uma chave nova e copie.
    2. Na Clickmax, abra Integrações > Explorar integrações e selecione o card Linear.
    3. Cole a chave no campo Chave de API do Linear e clique em Carregar times.
    4. Em Time, selecione o time que vai receber as issues.
    5. Em Projeto (opcional), selecione um projeto ou deixe Sem projeto.
    6. Conclua a integração.

    As issues criadas pelos chamados sempre nascem no time e no projeto escolhidos aqui.

    Trocar a chave, o time ou o projeto

    Abra a integração Linear em Integrações ativas (lápis). A chave atual nunca é exibida: preencha Nova chave de API (opcional) só para trocá-la; a nova é validada ao salvar. Para trocar o time, carregue os times de novo e escolha outro.

    Criar a issue pelo chamado

    1. Abra Chamados e clique no chamado.
    2. No rodapé do detalhe, clique em Criar issue no Linear. O botão só aparece com a integração Linear ativa.
    3. No modal, confira o Título da issue e clique em Criar issue.

    A criação acontece em segundo plano. O chamado mostra:

    O que apareceSignificado
    Criando…A issue ainda está sendo criada no Linear.
    Código da issue, como linkA issue foi criada. Clique no código para abrir no Linear.
    Selo ao lado do códigoO status atual da issue no Linear (Status no Linear). Ele acompanha a issue conforme ela avança lá.
    Mensagem de erro e Tentar de novoA criação falhou. Corrija o motivo e clique em Tentar de novo.

    Se não funcionou

    MensagemO que fazer
    "Chave de API do Linear inválida."Gere uma chave nova no Linear e cole de novo na integração.
    "Não foi possível carregar os times do Linear. Tente novamente."Confira a chave e clique em Carregar times outra vez.
    "Selecione o time do Linear."Escolha um time antes de salvar a integração.
    "A chave de API do Linear foi revogada ou é inválida. Atualize a integração."Cole uma chave nova em Nova chave de API (opcional) e salve.
    "O time ou projeto padrão não existe mais no Linear. Atualize a integração."Abra a integração e escolha outro time ou projeto.
    "A integração com o Linear está desativada ou foi apagada."Ative ou crie a integração Linear e clique em Tentar de novo.
    "Não foi possível criar a issue no Linear."Clique em Tentar de novo; se persistir, fale com o suporte.