A integração do Zendesk Support para o Jira incentiva a colaboração entre as equipes de produto e de suporte. Por exemplo, agentes podem vincular ou criar problemas do Jira a partir de um ticket do Zendesk. Eles podem então usar o link para rastrear o progresso feito pela equipe de produto na resolução do problema.
A integração é compatível com Atlassian Jira Cloud, Jira Data Center e Jira Server versão 7x e superior. A integração não tem suporte para o aplicativo móvel do Jira Cloud.
Este artigo abrange os seguintes tópicos:
- Requisitos de instalação
- Compatibilidade entre tipos de campo personalizado do Jira
- Instalação e configuração da integração
- Restrição de acesso ao aplicativo do Jira no Zendesk Support
- Adição de campos ao formulário de criação do problema no Jira no Zendesk Support
- Uso da opção do usuário dedicado à integração
- Instruções específicas do Jira Server
- Reinstalação da integração
Tópicos relacionados:
Requisitos de instalação
Você deve ter permissões de administrador no Jira e no Zendesk Support para configurar a integração.
Além disso, você deve atender aos seguintes requisitos:
- Ser membro dos grupos jira-administrators e jira-software-users.
- Não possuir esquemas de permissão que não permitam que você crie ou atualize projetos.
- O campo reporter deve estar na tela Create Issue para os respectivos projetos.
- Usar o Jira Internal Directory como seu diretório de usuário (se aplica apenas ao servidor do Jira).
-
Os complementos do Atlassian devem ter permissão para acessar seus projetos no Jira. Por padrão, esse componente está ativado. Para verificar isso, consulte a página Project Permissions para cada projeto no Jira. As várias ações do projeto devem ter um Project Role chamado
Project Role (atlassian-addons-project-access). -
Os cookies de terceiros devem estar habilitados. No entanto, se os cookies de terceiros precisarem permanecer desativados em seu sistema, adicione
jiraplugin.zendesk.come também o seu subdomínio do Jira à lista de exceções de conteúdo.
Compatibilidade entre tipos de campo personalizado do Jira
Com o Zendesk Support para integração do Jira, você pode criar um problema do Jira a partir de um ticket usando o aplicativo Jira no Zendesk Support, localizado na barra lateral da interface do agente. O formulário usado para criar problemas do Jira inclui campos padrão, mas os administradores do Zendesk Support podem adicionar campos personalizados no Jira a esse formulário.
Consulte Uso do recurso de sincronização do campo do Jira para obter uma lista dos tipos de campos personalizados do Jira compatíveis com o aplicativo Jira no Zendesk Support. Você pode adicionar tipos compatíveis de campo personalizado ao formulário de criação de problemas do Jira. Também é possível adicionar tipos compatíveis de campos personalizados às visualizações de problemas vinculados do Jira.
Instalação e configuração da integração
O processo de configuração da integração envolve a instalação do Zendesk Support para o aplicativo do Jira no Atlassian Marketplace em sua conta do Jira e a configuração do aplicativo.
Como instalar e configurar a integração
- No Jira, clique em Apps na barra de navegação superior e selecione Explore more apps.
- Na página Marketplace apps, pesquise por Zendesk.
- Localize e clique na entrada Zendesk Support for Jira dos resultados de pesquisa.
- Clique em Get app.
- Clique em Get it now.
- Quando a caixa de notificação de instalação concluída com êxito for exibida, clique em Configure.
- Insira seu subdomínio da Zendesk. Por padrão, a caixa de seleção Create a new dedicated Zendesk user for this integration vem selecionada. Sugerimos que você use esse recurso para permitir que todas as transferências do Jira para o Zendesk Support não venham do administrador que configurou a integração, mas de um usuário dedicado. Isso criará automaticamente um novo usuário administrador em sua conta Zendesk que será utilizado apenas pela integração para o Jira. Para obter mais informações, consulte Uso da opção do usuário dedicado à integração.
- Clique em Authenticate.
- Clique em Allow.
- Uma segunda página do navegador é exibida solicitando que você entre em sua conta Zendesk. Insira suas credenciais de acesso. A página será fechada.
- Na página de configurações do aplicativo, selecione os detalhes a exibir nos problemas do Jira vinculados.
- Clique em Salvar.
No Jira Cloud, a integração cria um usuário administrador grátis chamado Zendesk Support for Jira. É possível alterar o avatar do usuário na página Profile.
Para verificar se a integração funciona, verifique se o usuário do Zendesk Support for Jira está aparecendo em um campo suspenso de usuário no Jira.
Restrição de acesso ao aplicativo do Jira no Zendesk Support
Se você deseja controlar o acesso ao aplicativo no Zendesk Support, por exemplo, apenas agentes ou administradores, é possível fazer a alteração no Zendesk.
Como restringir o acesso ao aplicativo do Jira no Zendesk Support
- Na Central de administração, clique em
Aplicativos e integrações na barra lateral e selecione Aplicativos > Aplicativos do Zendesk Support. - Na aba Instalados no momento, clique no aplicativo Jira.
- Em Instalação, marque a caixa de seleção Habilitar restrições de função? para restringir o acesso ao aplicativo a funções específicas. Em seguida, selecione as funções.
- Marque a caixa de seleção Ativar restrições de grupo? para restringir o acesso ao aplicativo a grupos específicos. Em seguida, selecione os grupos.
- Clique em Atualizar para salvar e aplicar as alterações.
Suas equipes já podem começar a colaborar usando o Zendesk e o Jira. Consulte Uso da integração do Zendesk Support para o Jira.
Adição de campos ao formulário de criação do problema no Jira no Zendesk Support
Quando você cria um problema no Jira de um ticket do Zendesk Support, precisa inserir os detalhes do problema em questão no formulário Criar novo problema no Jira:
- Projeto
- Tipo de problema
- Relatador
- Atribuído
- Resumo
- Descrição
Esses campos padrão não podem ser removidos e são específicos ao projeto e tipo de problema no Jira selecionado.
Os administradores do Zendesk Support podem adicionar campos existentes ou personalizados do Jira a este formulário. Adicionar campos ao formulário de criação de problema os torna visíveis para todos os agentes ao criar problemas para o projeto e o tipo de problema selecionados.
Consulte Uso do recurso de sincronização do campo do Jira para obter uma lista dos tipos de campos personalizados do Jira compatíveis com o aplicativo Jira no Zendesk Support.
- No Zendesk Support, visite o ticket que deseja usar como base para o novo problema no Jira.
- Clique em Criar problema no aplicativo do Jira ao lado do ticket.
- No campo Projeto, selecione o projeto.
O botão Configurar campos é exibido após você selecionar o projeto. Esse botão é visível apenas para administradores do Zendesk Support.
- Selecione o Tipo de problema.
- Clique em Configurar campos.
Uma lista suspensa contendo os campos disponíveis é exibida.
- Selecione os campos que deseja adicionar ao formulário de criação do problema no Jira.
Esses campos ficarão visíveis para todos os agentes ao criar problemas para esse projeto e tipo de problema.
- Conclua a criação do problema, conforme descrito em Criação de um problema no Jira a partir de um ticket.
- Clique em Criar problema.
Uso da opção do usuário dedicado à integração
Se você escolher criar um usuário dedicado à integração em sua conta do Zendesk Support, será criado automaticamente um novo usuário confirmado (Jira Integration) com um endereço de e-mail (jira_integration_XXXXXX@jira.zendesk-integrations.com). Esta conta de usuário é totalmente gerenciada pela integração e será suspensa se a integração for removida.
- Esta opção de usuário dedicado à integração exige uma licença disponível para o agente. Uma vez em uso, essa licença não estará disponível para outros agentes.
- A conta do administrador que instalou a integração para o Jira e o usuário dedicado à integração precisam ter permissões de administrador e estar ativos para que a integração funcione. Se você suspender ou fizer o downgrade da conta do administrador ou do usuário dedicado à integração, a integração não funcionará.
Após o término do processo de autenticação e criação, o serviço de integração estará pronto para o uso. Todos os comentários e ações de sincronização de campos serão realizados como se tivessem sido feitos pelo usuário dedicado à integração.
Se você quiser parar de utilizar o usuário dedicado à integração, poderá desconectar a integração no Jira. Uma vez desconectado, o Jira parará de utilizar o usuário dedicado à integração. O usuário dedicado à integração na conta do Zendesk Support sofrerá um downgrade para usuário final e será suspenso. Desinstalar o plug-in também resultará em downgrade e suspensão do usuário.
Como desconectar o usuário dedicado à integração
- No Jira, clique em Settings e acesse Apps > Manage apps.
- Clique para expandir o aplicativo Zendesk Support for JIRA e em Configure.
- Clique em Disconnect para desconectar seu subdomínio.
- Insira novamente o seu subdomínio e desmarque a opção para criar um usuário dedicado à integração.
- Clique em Authenticate para autenticar novamente seu subdomínio.
Requisitos e considerações de configuração específicos do Jira Server
-
Acesso ao Zendesk: Para garantir que o Zendesk estabeleça a conexão com o seu Jira Server, é necessário que você crie uma lista de autorização dos itens a seguir:
- Os endereços IP para a sua conta Zendesk. Para obter mais informações sobre como consegui-los, consulte Obtenção de endereços IP.
- Os intervalos de endereços IP da integração do Jira (Pod 19) descritos em Obtenção de endereços IP para outros produtos Zendesk.
- Criptografia SSL: recomendamos o uso da criptografia SSL para proteger a comunicação entre o Jira e o Zendesk, principalmente em ambientes de produção. Se o SSL estiver ativado, você deve possuir uma pilha completa de certificado de SSL de uma autoridade de certificação. Não há suporte para certificados autoassinados. O certificado intermediário normalmente não é instalado no servidor do Jira, o que pode causar erros.
-
Problemas com certificado SSL: se você encontrar erros de certificado SSL na página de configuração do plug-in (por exemplo, não conseguir acessar
jiraplugin.zendesk.com), isso pode ocorrer porque o Jira não confia no certificado do Zendesk. Para resolver esse problema, siga estas etapas:- Localize o keystore Java chamado
cacerts, que o Jira usa para autoridades de certificação (AC) confiáveis. Ele pode ser encontrado em:%Jira Install%\jre\lib\security\cacerts. - Importe o certificado emissor da AC raiz pública do Zendesk para esse keystore.
- Reinicie os serviços do Jira para aplicar as alterações.
- Localize o keystore Java chamado
-
Configuração da porta: certifique-se de que a porta correta esteja aberta (normalmente é a
80/8080/443, dependendo das configurações de SSL) em sua rede para tráfegos de entrada e de saída entre o Zendesk e o Jira. - URL base do Jira: ao configurar o complemento no Jira, a URL base do Jira pode ser acessada publicamente. Essa URL pode ser diferente daquela que você usa para acessar o Jira no seu servidor privado. Você pode conectar o endereço público ao seu servidor privado via NAT ou proxy reverso.
- Migração de ambiente: se você configurar o complemento em um ambiente de servidor do Jira para teste ou sandbox e migrar o ambiente para produção posteriormente, não copie o arquivo zendesk_plugin.properties por cima. Replicar ou substituir esse arquivo em um ambiente distinto pode causar falha de integração do Jira.
-
Privilégios administrativos: o complemento do Zendesk no Jira requer privilégios administrativos para funcionar corretamente. Recomendamos criar uma conta dedicada com as seguintes credenciais e adicioná-la aos grupos jira-administrators e jira-software-users:
-
- Nome completo: Zendesk for Jira
-
Nome de usuário: addon_zendesk
Se esse nome de usuário não for encontrado, a integração tentará usar a conta de administrador que instalou o complemento. Se isso falhar, será usada como padrão a primeira conta de administrador disponível.
-
Reinstalação da integração
- Na alteração do usuário de integração
- Na alteração da instância do Jira vinculada à sua conta do Zendesk Support
- Na alteração da instância do Zendesk Support vinculada à sua instância do Jira (incluindo sandboxes)
- No restabelecimento da conexão entre o Zendesk e o Jira após a reinicialização do servidor do Jira ou a limpeza do cache de plug-in
Se você está reintegrando as mesmas contas do Zendesk e Jira, seus dados de problemas vinculados permanecem intactos.
Como reinstalar a integração
- No Jira, navegue até Apps > Manage your apps.
- Clique em Zendesk Support for JIRA e selecione Configure.
- Clique em Disconnect.
- Volte à página de gerenciamento de aplicativos, clique em Zendesk Support for JIRA e em Uninstall.
- Conclua o processo de configuração. Consulte Instalação e configuração da integração.