A integração para o Jira incentiva a colaboração entre as equipes de produto e de suporte. A integração v4 para o Jira oferece suporte ao Atlassian Jira Cloud (OnDemand), Jira Data Center e ao Jira Server (OnPremise) versão 7x ou superior.
Os tópicos abordados neste artigo são:
- Requisitos de instalação
- Instalação e configuração da integração
- Restrição de acesso ao aplicativo Jira Cloud
- Adição de campos ao aplicativo do 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 o impeçam de criar e atualizar 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
-
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.com
à lista de exceções de conteúdo
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 Find new 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.
- 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 Save para salvar.
- Se você está usando o Jira Cloud, pode verificar o funcionamento da integração adicionando um usuário
add_on_zendesk_for_jira
ao grupojira-users
no administrador do Jira.
No Jira Cloud, a integração cria um usuário administrador grátis chamado Zendesk for Jira. É possível alterar o avatar do usuário na página Profile.
Restrição de acesso ao aplicativo Jira Cloud
Se você desejar controlar o acesso ao aplicativo (por exemplo, administradores ou apenas agentes), é possível fazer a alteração na instância do produto Zendesk.
Como restringir o acesso ao aplicativo Jira Cloud
- No Zendesk Support, clique no ícone Admin. (
), visite Aplicativos > Gerenciar e localize o aplicativo Jira Cloud.
- Passe o mouse sobre o aplicativo Jira Cloud. Usando o menu suspenso no canto direito do ícone do aplicativo, selecione Alterar configurações.
- Em Instalação, marque a caixa de seleção Habilitar restrições de função?.
- Clique na caixa de texto Restrições de função e selecione as funções que terão permissão para usar o aplicativo.
- Clique em Atualizar para salvar as alterações.
E pronto. Suas equipes podem começar a colaborar usando o Zendesk e o Jira. Para descobrir como fazer isso, consulte Uso da integração do Zendesk para o Jira Cloud.
Adição de campos ao aplicativo do Jira no Zendesk Support
Quando você cria um problema do Jira de um ticket do Zendesk Support, precisa inserir os detalhes do problema em questão no formulário Criar novo problema do Jira:
- Projeto
- Tipo de problema
- Relatador
- Atribuído
- Resumo
- Descrição
Esses campos padrão não podem ser removidos. No entanto, é possível incluir campos adicionais do Jira nesse formulário, sejam campos pré-existentes ou personalizados.
Para obter mais informações, consulte Specifying field behavior no website da Atlassian.
Configuração do formulário de criação do problema
Você pode definir os campos do Jira que os agentes podem ver criando um novo problema do Support, uma melhoria significativa no aplicativo do Jira v4.
Esses campos são específicos para um determinado projeto ou tipo de problema do Jira. Os campos do problema definidos como “required” (obrigatórios) no Jira serão exibidos no formulário independentemente das configurações desse formulário.
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 Jira settings e visite 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.
Instruções específicas do Jira Server
- 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 informações sobre como obtê-los, consulte "Obtenção de endereços IP" em Configuração do firewall para uso com o Zendesk
- Os intervalos de endereços IP da integração do Jira (Pod 19) em Obtenção de endereços IP para outros produtos Zendesk.
- Recomendamos que a criptografia SSL seja usada para assegurar a comunicação entre Jira e Zendesk, especialmente para os 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.
- 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 Zendesk e Jira. - Na configuração do complemento no Jira, a "URL base do Jira" pode não ser a mesma URL que você usa para acessar o Jira em seu servidor privado. A URL base do Jira precisa ser um endereço de acesso público para que a instância do produto Zendesk a use para fazer as solicitações de rede para sua instância do Jira. Você pode conectar esse endereço de acesso público ao seu endereço de servidor privado pelo NAT ou proxy reverso.
- O complemento da Zendesk no Jira precisa ser executado com privilégios administrativos. Sugerimos que você crie uma conta dedicada conforme a seguir e adicione-a aos grupos
jira-administrators
ejira-software-users
.Nome completo: Zendesk for Jira
Nome de usuário: addon_zendesk
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 produto Zendesk e o Jira após a reinicialização do servidor do Jira ou da limpeza do cache de plug-in
Se você está reintegrando as mesmas contas da Zendesk e Jira, seus dados de problemas vinculados permanecem intactos.
Como reinstalar a integração
- No Jira, navegue até Apps > Manage your apps.
- Clique no menu acordeão Zendesk Support for Jira e selecione Configure.
- Selecione Disconnect.
- Volte à página de gerenciamento de aplicativos, clique no menu acordeão Zendesk Support for Jira e em Uninstall.
- Conclua o processo de configuração. Consulte Instalação e configuração da integração.
0 Comentários
Artigo fechado para comentários.