A integração do Movidesk com o JIRA proporciona melhor controle das demandas geradas entre as equipes de desenvolvimento e de suporte da sua empresa. Esta integração permite que quando uma solicitação for aberta por um cliente, o agente possa registrar a falha no JIRA através do ticket aberto no Movidesk e encaminhá-lo para a equipe de desenvolvimento. A mesma, por sua vez, após corrigir o bug, poderá adicionar comentários, ou mesmo, alterar o status do ticket diretamente do JIRA.
Como agente, é possível criar um novo problema do JIRA a partir de um ticket, ou vincular com link um problema existente do JIRA através de um ticket. A integração permite, então, utilizar o link para rastrear todo o progresso realizado pela equipe de desenvolvimento sobre a solução do problema. Por exemplo, no Movidesk, você pode visualizar os detalhes sobre um problema registrado no JIRA para verificar se a equipe de desenvolvimento já o corrigiu.
Neste artigo, você vai ver:
- Requisitos para a integração entre Movidesk & Jira
- Configurando a integração com o JIRA no Movidesk
- Configurando a integração com o Movidesk no JIRA
- Gerando uma issue no JIRA através de um ticket do Movidesk
- Extra - Opções da central de integrações
Requisitos para a integração entre Movidesk & Jira
1. Versão do JIRA superior à 7.2.9
Conforme brevemente mencionado acima, é necessário que o JIRA de sua instituição esteja na versão 7.2.9 ou superior para o correto funcionamento da integração com o Movidesk.
Para versões anteriores, podem ocorrer interferências no comportamento correto da integração.
2. Projetos integrados necessitam ser Projetos Geridos pela Empresa
Devido a limitações no JIRA em relação às transições de status em Projetos Geridos pela Equipe (ou Team Managed Projects), diversas das funcionalidades de nossa integração com o JIRA não funcionarão corretamente caso a integração seja feita com um Projeto Gerido pela Equipe.
Para o bom funcionamento da integração, é recomendado o uso de um Projeto Gerido pela Empresa. Você pode verificar se seu projeto é gerido pela empresa, ou pela equipe, na lateral esquerda do JIRA, na parte inferior, conforme imagem abaixo:
Na tela de Projetos do JIRA, também será exibida em uma coluna se o projeto é gerido pelo time, ou pela empresa:
Caso o seu projeto seja Gerido pela Equipe, mas queira migrá-lo para um Projeto Gerido pela Empresa, existe esta documentação da Atlassian sobre a migração de projetos: https://support.atlassian.com/jira-software-cloud/docs/migrate-between-team-managed-and-company-managed-projects/.
Atualmente, não há conteúdo oficial da Atlassian ou JIRA em Português Brasileiro sobre a migração de projetos, sendo necessário o consumo do artigo em inglês acima. É importante ressaltar que essa migração é feita diretamente no JIRA, e as configurações e suporte para essa mudança devem ser validadas diretamente com a equipe do JIRA e Atlassian, se necessário, por ser um procedimento externo ao Movidesk.
3. Usuário de Administrador dentro do JIRA para a integração com o Movi
É necessário ter um usuário com acesso de Administrador no JIRA para a configuração da integração.
Este usuário será utilizado para gerar o Token de API do JIRA necessário nas configurações da integração dentro do Movidesk, conforme abordado mais abaixo neste artigo, assim como será utilizado para gerar as issues da integração dentro do JIRA. O Token da API do JIRA pode ser gerado em: https://id.atlassian.com/manage/api-tokens
Considerando que os 3 itens acima tenham sido validados, e estejam todos dentro dos requisitos para correto funcionamento da integração, podemos avançar para as configurações necessárias.
Configurando a integração com o JIRA no Movidesk
A configuração da integração Movidesk-JIRA se dá em duas frentes, sendo a primeira parte configurada no Movidesk e a segunda ajustada no JIRA. Antes de mais nada, verifique se há um token gerado em seu sistema. Para tal procedimento, acesse a tela de parâmetros do sistema e selecione a aba "Ambiente". Utilize a barra de rolagem para descer até o final da página. Caso o campo "Chave da API" esteja em branco, clique em "Gerar nova chave".
Clicando em Configurações > Conta > Parâmetros, na aba "Ambiente":
Após verificar (ou gerar) o token do seu Movidesk, a configuração de fato, pode ser iniciada. Para isso, a partir da tela principal do sistema, basta acessar "Configurações" e no menu "integrações", acessar "Central de integrações" e selecionar a opção "+ Nova integração".
Executado o procedimento anterior, o sistema apresentará a tela para configuração da integração. Na guia "Principal", defina um nome para a integração cadastrada (no exemplo abaixo, nomeamos por Movidesk - JIRA). Depois, você deve selecionar a opção "Jira Software" clicando na caixa de tipo de integração (por padrão, o sistema traz como primeira opção a integração ao Pipedrive) e em seguida, marque o checkbox "habilitado".
Após realizar as configurações na guia principal, selecione a guia "Dados para conexão". Nesta guia, informe a URL do seu JIRA e os dados para autenticação. Sugerimos que seja utilizado um usuário específico para esta integração, visto que este usuário será indicado como o gerador/cliente da issue.
A próxima guia a ser definida, é a de configurações da integração. Nesta aba você define de que forma funcionará esta integração, se automaticamente (ou não) e ainda, informar qual será o projeto do JIRA ao qual este ticket será relacionado e que tipo de issues serão geradas por padrão, a partir dos tickets do Movidesk. É possível também, definir se as alterações de status dos tickets serão enviadas para o JIRA.
- ENVIAR ALTERAÇÕES DE STATUS DO TICKET DO MOVIDESK PARA A ISSUE DO JIRA - Caso este parâmetro esteja habilitado, as alterações de status dos tickets serão enviadas para o JIRA, desde que estes estejam corretamente correlacionados, fazendo com que a integração de status seja bidirecional. Caso este parâmetro seja desabilitado, apenas as alterações de status das issues do JIRA serão espelhadas aos tickets do Movidesk, sem reciprocidade.
- INTEGRAÇÃO AUTOMÁTICA - Se este parâmetro estiver marcado, a integração ocorrerá de forma automática quando as condições forem atingidas. A integração automática sempre irá gerar uma nova issue no JIRA, enviando a issue sempre para o mesmo projeto definido no Movidesk (neste caso esta informação é obrigatória).
- INTEGRAÇÃO MANUAL - Caso o parâmetro estiver desmarcado, quando as condições forem atingidas, o sistema somente exibirá uma área onde o agente poderá optar por enviar o ticket para o Jira ou não. A integração manual permite que o agente opte entre criar uma nova issue, ou associar o ticket a uma issue já existente. No caso da integração manual, a informação do projeto é opcional e o agente poderá alterar o projeto no momento da abertura da issue.
Após ajustar as configurações da integração, é possível apontar condições para definir quando a integração será executada (quando de forma automática) ou terá os campos exibidos, possibilitando o vínculo a uma issue existente ou criação de uma nova issue no JIRA (quando de forma manual). Essas configurações se dão na guia "Condições" e caso forem deixadas em branco, a integração não fará distinção entre os tickets.
) pois todas são condições de disparo.
Por fim, utilize a guia "Correlação entre campos" para definir a ligação dos campos do Movidesk com os campos do seu JIRA. Você pode correlacionar status/status, categoria/tipo, urgência/prioridade, agente/usuário (esta correlação aponta o responsável pela issue gerada através do ticket e o agente do Movidesk não precisa necessariamente ser o mesmo usuário do JIRA) e campos adicionais JIRA/campos adicionais Movidesk. Os campos à esquerda correspondem ao JIRA, enquanto os da direita referem-se ao seu Movidesk. A correta configuração destes campos é muito importante para que a integração ocorra da maneira desejada.
Ao finalizar as configurações da integração no Movidesk, clique em Salvar e a integração deverá ser gravada com sucesso. Você poderá visualizá-la na central de integrações do sistema.
Configurando a integração com o Movidesk no JIRA
A integração cadastrada no seu Movidesk gera automaticamente uma webhook dentro do JIRA. Para visualizar esta webhook acesse a guia Configuração e clique em Sistema.
Selecione a opção Webhooks.
Com a webhook gerada, no que tange às ações cadastradas, a integração já estará pronta para uso. Entretanto, caso queira que as alterações de status sejam também integradas, algumas configurações adicionais deverão ser definidas no JIRA. Os tickets do Movidesk podem ser atualizados a partir do fluxo de trabalho do JIRA através de funções post. Estas funções atuam como um recurso do fluxo de trabalho do JIRA para que processamentos adicionais sejam efetuados após a execução de uma transição destes fluxos.
Para efetuar estas definições, selecione o projeto ao qual deseja configurar (caso você queira configurar mais de um projeto para que tenha a atualização de status integrada, o procedimento deverá ser repetido um a um). Você pode fazer isso em Projetos > Projeto de sua preferência.
Na tela do projeto escolhido, selecione Configurações do projeto.
Em seguida, selecione Fluxos de Trabalho e, em "Ações", clique no lápis para editar.
Na coluna Transições, clique no nome da transição que deseja usar para iniciar atualização de tickets.
Clique na aba Funções de Post:
E depois na opção "Adicionar função de postagem" do lado superior direito.
Selecione a opção "Desencadear uma Webhook" e em seguida clique em "Adicionar".
No campo Webhook, selecione a alternativa "Movidesk" e em seguida, clique em "Adicionar".
Após concluir as configurações em todos os status que deverão ser utilizados na integração, basta clicar em "Publicar Rascunho".
Desta forma, as configurações da integração estarão completas e serão gravadas com êxito.
Gerando uma issue no JIRA através de um ticket do Movidesk
Conforme visto anteriormente, existem duas maneiras de definição para abertura de issues através de tickets, sendo uma delas de forma automática e outra manualmente.
Quando de maneira automática, sempre que um ticket atingir as condições da integração, uma nova issue será instantaneamente criada no JIRA e vinculada ao ticket de origem. No exemplo abaixo, estamos criando um novo ticket (vale ressaltar que a integração automática também ocorre em tickets já abertos, desde que atinjam as condições para integração pré-configuradas). Note que a tela do ticket está com a sua exibição padrão, sem qualquer campo referente ao JIRA.
Ao clicar em Salvar, as condições da integração do exemplo foram alcançadas e uma nova issue foi criada no JIRA. Observe que o ticket já apresenta um bloco com informações acerca da integração ao lado esquerdo da tela, inclusive com um link direto para acesso à issue, logo abaixo da numeração do ticket.
Veja que ao verificar o histórico de alterações do ticket, o sistema também informa quando foi criada uma nova issue no JIRA, bem como o número da chave de identificação da mesma.
Quando definido que a integração acontecerá manualmente, o bloco dedicado à integração com o JIRA será exibido sempre que as condições pré-configuradas forem atingidas (assim como funciona no modo automático), porém ao contrário da alternativa anterior, uma issue não será gerada automaticamente. Neste caso, o agente poderá optar entre associar o ticket a uma issue já existente, criar uma nova a partir do ticket, ou ainda, simplesmente não gerar integração caso não julgue necessário.
Caso você decida por criar uma nova issue e tenha definido nas configurações da integração um projeto e/ou tipo padrão, note que eles serão pré-selecionados no cadastro deste novo vínculo. Contudo, você pode alterá-los de acordo com o que lhe for mais conveniente.
Numa situação hipotética, onde um novo ticket no Movidesk é aberto para tratar de um problema que já esteja cadastrado no JIRA, a opção "Associar issue" pode ser a melhor opção. Basta informar a chave da issue a ser vinculada e você evitará a abertura de uma nova demanda para o mesmo problema.
Veja que após salvar, o vínculo foi gerado e é informado no bloco da integração, dentro da tela do ticket. Repare que é exibida a opção "Remover link" e você pode desassociar a issue do ticket se assim desejar.
No histórico de alterações do ticket, observe que a integração é informada. Atente para o detalhe da informação de que maneira se criou o elo entre ticket e issue. O sistema difere as alternativas automática e manual e as específica dentro das alterações.
Veja o exemplo a seguir. Vamos cadastrar uma ação no ticket do Movidesk e validar a importação para a issue vinculada.
Repare que a ação foi incluída no ticket.
Agora, verificando a issue no JIRA, observamos que a mesma foi corretamente importada.
Agora, validaremos o caminho oposto. Vamos adicionar um comentário na issue do JIRA e verificar a importação para o ticket (lembrando que esta ação será, por default, interna).
Validamos que o comentário foi cadastrado corretamente no JIRA.
Também alteramos o fluxo de trabalho da issue e o status do ticket deverá ser alterado automaticamente.
Veja que a situação da issue foi alterada.
Tendo realizado as alterações na issue, vamos verificar o comportamento do ticket no Movidesk. Observe que o sistema aponta que o ticket sofreu alterações. Clique sobre o alerta e verifique as ações apontadas no ticket. Note que o comentário inserido na issue foi incorporado ao ticket em forma de ação interna.
Tanto o status do ticket, quanto a situação da issue, também foram atualizados com sucesso.
Extra - Opções da central de integrações
Acessando a central de integrações do Movidesk, além de cadastrar um nova integração, através da caixa de opções é possível realizar o procedimento de clonagem de integrações, habilitar, desabilitar e excluir integrações, bem como, exportar estes dados para Microsoft Excel.
