Uso de ações do Linear em fluxos de ação

O Linear é uma ferramenta de monitoramento de problemas e gerenciamento de projetos desenvolvida para equipes de software. Com o conector do Linear para o criador de ações, você pode criar e gerenciar problemas, projetos e comentários, pesquisar problemas e usuários, além de manter o trabalho da sua equipe organizado diretamente nos fluxos de ação do Zendesk.

Qual é o meu plano?

Suite, todas as versões

Team, Growth, Professional, Enterprise ou Enterprise Plus

Support

Team, Professional ou Enterprise

Resumo: ◀▼

Você pode conectar fluxos de ação ao Linear para criar, atualizar e gerenciar problemas, projetos e comentários diretamente nos seus fluxos de trabalho. Essa integração oferece suporte à pesquisa e consulta de problemas e usuários, atribuição de problemas e organização de projetos, ajudando você a otimizar o gerenciamento de projetos e o monitoramento de problemas sem trocar de plataformas. Use uma conta de serviço dedicada para garantir que as ações externas sejam seguras e atribuídas.

Ao conectar o criador de ações a sistemas externos, como o Linear, administradores podem integrar o Zendesk a sistemas externos em fluxos de trabalho automatizados, melhorando a colaboração e mantendo uma experiência contínua em várias plataformas.

Observação: as etapas associadas aos sistemas externos em fluxos de ação são chamadas coletivamente de ações externas.

O Linear é uma ferramenta de monitoramento de problemas e gerenciamento de projetos desenvolvida para equipes de software. Com o conector do Linear para o criador de ações, você pode criar e gerenciar problemas, projetos e comentários, pesquisar problemas e usuários, além de manter o trabalho da sua equipe organizado diretamente nos fluxos de ação do Zendesk.

Este artigo contém os seguintes tópicos:

• Conexão do Linear ao criador de ações
• Uso de ações do Linear em fluxos de ação

Conexão do Linear ao criador de ações

Antes de incluir ações externas nos seus fluxos de ação, é preciso conectar o criador de ações ao sistema externo.

Ao se conectar a sistemas externos para uso em fluxos de ação, as seguintes práticas recomendadas devem ser observadas:

• Todas as ações externas realizadas por um fluxo de ação são atribuídas ao usuário que conectou o sistema externo. Portanto, é uma prática recomendada usar uma conta de serviço dedicada em vez de credenciais pessoais ao se conectar a cada sistema externo.
• Todas as integrações solicitam acesso aos escopos necessários. No entanto, é importante que você avalie e valide os escopos antes de autorizar a conexão com o sistema externo.
• Ao gerenciar credenciais para ferramentas baseadas em chave de API, como a OpenAI, recomendamos armazenar as chaves em um cofre seguro ou em um gerenciador de credenciais.

Como conectar o criador de ações ao Linear

1. Na Central de administração, clique em Aplicativos e integrações na barra lateral e selecione Ações > Fluxos de ação.
2. Crie ou edite um fluxo de ação.
3. Abra a barra lateral da etapa.
4. Em Ações externas, clique em Linear.
5. Clique em Conectar.
6. Siga os comandos do Linear para se autenticar e concluir a conexão.

   A conexão do Linear usa OAuth 2.0 com o tipo de concessão de código de autorização. Quando você autoriza a conexão, é redirecionado para o Linear para conceder permissões à sua conta do Zendesk.

   Observação: Todas as ações externas realizadas por um fluxo de ação são atribuídas ao usuário que conectou o sistema externo. Portanto, é uma prática recomendada usar uma conta de serviço dedicada em vez de credenciais pessoais ao se conectar a cada sistema externo.

Depois de se conectar ao sistema, você verá um indicador de conexão e detalhes sobre a instância à qual está conectado, bem como as ações disponíveis para o Linear.

Uso de ações do Linear em fluxos de ação

As etapas de ação do Linear podem ser usadas para pesquisar formulários e buscar respostas da pesquisa.

As seguintes ações do Linear estão disponíveis:

• Criar problema
• Atualizar problema
• Pesquisar problema
• Pesquisar problemas
• Adicionar comentário ao problema
• Pesquisar usuário
• Pesquisar usuários
• Criar projeto
• Atualizar projeto
• Adicionar problema ao projeto
• Atribuir problema a um membro

Criação de um problema

Use a ação Criar problema para criar um novo problema no Linear com os detalhes especificados.

As entradas e saídas dessa ação são:

	Variáveis
Entradas	Obrigatórias: Title, Team Opcionais: Description, Project, Assignee email, Status, Priority, Due date, Estimate Observação: a data de vencimento deve ser inserida no formato AAAA-MM-DD com base no fuso horário da sua conta do Linear. As opções de prioridade incluem: sem prioridade, urgente, alta, média ou baixa.
Saída	Detalhes do problema, incluindo ID, identificador, título, descrição, URL, informações do projeto, informações da atribuição, informações do status, prioridade, data de vencimento, estimativa e carimbos de data/hora

Atualização de um problema

Use a ação Atualizar problema para atualizar as propriedades de um problema existente no Linear.

As entradas e saídas dessa ação são:

	Variáveis
Entradas	Obrigatórias: Issue Opcionais: Title, Description, Assignee email, Project, Status, Priority, Due date, Estimate Observação: a data de vencimento deve ser inserida no formato AAAA-MM-DD com base no fuso horário da sua conta do Linear.
Saída	Detalhes do problema atualizado, incluindo ID, identificador, título, descrição, URL, informações da atribuição, informações do status, prioridade, data de vencimento, estimativa e carimbo de data/hora

Pesquisa de problema

Use a ação Pesquisar problema para recuperar informações detalhadas sobre um problema específico.

As entradas e saídas dessa ação são:

	Variáveis
Entradas	Obrigatórias: Issue ID
Saída	Detalhes do problema, incluindo ID, identificador, título, descrição, URL, informações do projeto, informações da atribuição, informações do status, prioridade, data de vencimento, estimativa e carimbos de data/hora

Pesquisa de problemas

Use a ação Pesquisar problemas para encontrar problemas com base em diversos critérios.

As entradas e saídas dessa ação são:

	Variáveis
Entradas	Opcionais: Team, Project, Assignee email, Status, Order by, Limit, Cursor
Saída	Matriz de problemas com ID, identificador, título, URL, informações do status, informações da atribuição, prioridade e carimbo de data/hora da criação; também inclui informações de paginação (hasNextPage, endCursor)

Adição de comentários a um problema

Use a ação Adicionar comentário ao problema para adicionar um comentário a um problema existente.

As entradas e saídas dessa ação são:

	Variáveis
Entradas	Obrigatórias: Issue, Body
Saída	Detalhes do comentário, incluindo ID, corpo do texto, informações do autor (ID e nome) e carimbo de data/hora da criação

Pesquisa de usuário

Use a ação Pesquisar usuário para recuperar informações do usuário por e-mail ou nome de exibição.

As entradas e saídas dessa ação são:

	Variáveis
Entradas	Obrigatórias: Lookup by, Value
Saída	Detalhes do usuário, incluindo ID, nome, nome de exibição, e-mail, URL do avatar e URL do perfil

Pesquisa de usuários

Use a ação Pesquisar usuários para encontrar usuários correspondentes à consulta de pesquisa.

As entradas e saídas dessa ação são:

	Variáveis
Entradas	Obrigatórias: Query Opcionais: Limit, Cursor
Saída	Matriz de usuários com ID, nome, nome de exibição, e-mail e URL do avatar; também inclui informações de paginação (hasNextPage, endCursor)

Criação de projetos

Use a ação Criar projeto para criar um novo projeto no Linear.

As entradas e saídas dessa ação são:

	Variáveis
Entradas	Obrigatórias: Name, Team Opcionais: Description, Start date, End date Observação: a data de início e a data de término devem ser inseridas no formato AAAA-MM-DD com base no fuso horário da sua conta do Linear.
Saída	Detalhes do projeto, incluindo ID, nome, descrição, URL, informações da equipe (ID e nome), data de início, data de término e carimbo de data/hora da criação

Atualização de projetos

Use a ação Atualizar projeto para atualizar as propriedades de um projeto existente.

As entradas e saídas dessa ação são:

	Variáveis
Entradas	Obrigatórias: Project Opcionais: Name, Description, Start Date, End Date Observação: a data de início e a data de término devem ser inseridas no formato AAAA-MM-DD com base no fuso horário da sua conta do Linear.
Saída	Detalhes do projeto atualizado, incluindo ID, nome, descrição, URL, data de início, data de término e carimbo de data/hora da atualização

Adição de problemas ao projeto

Use a ação Adicionar problema ao projeto para atribuir um problema existente ao projeto.

As entradas e saídas dessa ação são:

	Variáveis
Entradas	Obrigatórias: Issue, Project
Saída	Detalhes do problema, incluindo ID, identificador, título, URL e informações do projeto (ID e nome)

Atribuição de problemas a um membro

Use a ação Atribuir problema a membro para atribuir um problema a um membro da equipe por e-mail.

As entradas e saídas dessa ação são:

	Variáveis
Entradas	Obrigatórias: Issue, Assignee email
Saída	Detalhes do problema, incluindo ID, identificador, título, URL e informações da atribuição (ID e nome)