Jira
O Jira é um software de planejamento e controle de projetos. Graças à integração, você pode trabalhar com as tarefas do Jira diretamente do Usedesk: crie-as diretamente do cartão de solicitação, acompanhe as alterações mais recentes, vincule as tarefas existentes às solicitações.
Configuração de integração
1. Crie um campo personalizado com o tipo «Texto». Vá para «Configurações» → «Campos personalizados», selecione «Texto» e clique em «Criar».
Especifique o título do campo «Jira», desmarque as caixas de seleção «Atribuir tag» e «Criar como filtro», e marque a caixa de seleção «Não pode ser editado». Em seguida, clique em «Salvar».
2. Crie um bloco dinâmico. Abra a seção «Configurações» → «Blocos», clique em «Adicionar bloco dinâmico»:
- Nome – Jira;
- Título – Jira;
- Bloquear conteúdo – deixe o campo vazio;
- URL – preencha o campo com o valor https://jiranew-integrations.usedesk.com/api;
- Habilitado – marque a caixa de seleção para ativar o bloqueio;
- Parâmetros (POST) – clique em «Adicionar parâmetro» e vá para a etapa 3.
3. Adicione parâmetros (POST):
Se você tiver uma versão em caixa:
- jira_username – login do superadmin no Jira (recomendamos criar um superadmin separado com o login «UsedeskBot»);
- jira_secret – senha da conta do Jira, cujo nome de usuário você especificou no campo jira_username (parâmetro obrigatório);
- usedesk_token – token de API. Como criar um canal de API e encontrar seu token foi escrito aqui;
- jira_domain – domínio Jira. Escrever com https:// (parâmetro obrigatório);
- usedesk_field_id – ID do campo personalizado do item 1 (parâmetro obrigatório);
- usedesk_url – URL do Usedesk API. Especificado se você estiver usando a versão em caixa da Usedesk em seu próprio servidor. Nesse caso, verifique com o suporte - support@usedesk.com (parâmetro opcional);
- project – se você especificar uma chave de projeto, as tarefas só poderão ser criadas nelas. Por exemplo: «MAIN», «SALES», «SUPP» Se o parâmetro não for utilizado, as tarefas podem ser criadas em qualquer projeto.
Se você tiver uma versão em nuvem:
- jira_username – e-mail do superadmin no Jira (recomendamos fazer um superadmin separado com o login «UsedeskBot»);
- jira_secret – token Jira. Leia sobre como obtê-lo aqui;
- usedesk_token – token de API. Como criar um canal de API e encontrar seu token está escrito aqui;
- jira_domain – domínio Jira. Escrever com https:// (parâmetro obrigatório);
- usedesk_field_id – ID do campo personalizado do item 1 (parâmetro obrigatório);
- usedesk_url – URL do Usedesk API. Especificado se você estiver usando a versão em caixa da Usedesk em seu próprio servidor. Nesse caso, verifique com o suporte - support@usedesk.com (parâmetro opcional);
- project – se você especificar uma chave de projeto, as tarefas só poderão ser criadas nelas. Por exemplo: «MAIN», «SALES», «SUPP» Se o parâmetro não for utilizado, as tarefas podem ser criadas em qualquer projeto.
Após fazer todas as alterações, clique em «Salvar».
Princípios da integração
No cartão de solicitação, um bloco adicional está localizado no lado direito da página sob o cartão do cliente e outros blocos adicionais (caso haja).
Criar uma tarefa em um cartão de solicitação
Você pode criar pendências do Jira diretamente do cartão de solicitação. Basta clicar no botão «Criar», preencha os campos que aparecerem e clique novamente em «Criar».
Nuances importantes:
- Dependendo do parâmetro do projeto nas configurações do bloco adicional, mostraremos todos os projetos em sua conta do Jira ou apenas os especificados;
- A lista de usuários é extraída do Jira;
- Você pode anexar um ou mais anexos a uma tarefa.
Anexar uma tarefa a um cartão de solicitação
Você pode vincular uma ou mais tarefas do Jira a um cartão de solicitação. O link será exibido no campo personalizado da etapa 1. Link = ver informações sobre uma tarefa específica (tarefas) no cartão de solicitação. Para fazer isso, clique em «Link» e preencha o campo «Número» digitando a chave de emissão do Jira. Por exemplo, MARKETING-777.
Bloco do Jira no cartão de solicitação: informações gerais
O bloco opcional do cartão de solicitação do Jira inclui o seguinte:
1. Botões «Criar», «Vincular», «Desvincular» – botões para criar, anexar e excluir uma tarefa no cartão de solicitação.
Se você vinculou uma tarefa a um cartão de solicitação, o cartão da tarefa vinculada será exibido no bloco.
Se você vinculou diversas tarefas ao cartão de solicitação, a lista de tarefas será exibida no bloco. A chave de tarefa na lista geral é um link para ir do Usedesk para o Jira (no exemplo – DEMO-125). Para ir para o cartão de uma tarefa específica, clique em seu nome (no exemplo – 211212). Para desvincular uma tarefa, vá para o cartão de tarefas e clique no botão «Desvincular».
Todos os logs para criar, anexar e excluir tarefas do Jira são exibidos no cartão de solicitação como comentários internos:
