Pessoas: Admins do Sistema Jira
Planos: Todos os planos da Miro (para integração do Jira Server/Data Center via OAuth 1.0)
Plataformas: Navegador, aplicativo para desktop (para procedimentos de configuração)
Para garantir que seus cartões do Jira em um board da Miro estejam sempre atualizados, a Miro deve receber mensagens do Jira sempre que ocorrerem alterações nos dados. Esses eventos do Jira são transmitidos para a Miro via um Webhook.
Este guia fornece duas maneiras de criar Webhooks para o Jira Server e o Jira Data Center usando OAuth 1.0 e OAuth2.0.
Crie um Webhook automaticamente
Ao configurar a integração dos seus cartões do Jira, se estiver se conectando ao Jira Server ou Jira Data Center, você pode deixar a opção Ativar criação automática de webhook ativada. Este é o método recomendado.
✏️ A criação automática de webhook exige que você esteja logado no Jira como um admin do sistema Jira.
Configurações dos cartões do Jira, Etapa 2: "Ativar criação automática de webhook" está ativada
Depois que o webhook for criado automaticamente, é uma boa prática ir para a página de WebHooks no Jira e editar o webhook para dar a ele um nome único. Isso é especialmente importante se você planeja conectar vários times do Miro à sua instância do Jira.
✏️ Para conexões OAuth2.0, a conexão do lado do Miro é definida no nível da empresa. Um webhook é criado para todos os times do Miro.
✏️ Para conexões OAuth 1.0, no nível do time do Miro, um webhook é criado por time. No nível da empresa do Miro, um webhook é criado para todos os times.
Criar um webhook manualmente
Se você preferir ou precisar criar o webhook manualmente, siga estas etapas.
Obter a URL do webhook do Miro
- Nas configurações dos cartões do Jira na Miro (Passo 2, ao conectar com o Jira Server/Data Center), desmarque a opção para Criar um webhook automaticamente.
- Copie e cole a URL do Jira da sua organização e clique em Conectar e salvar configurações.
Configurações dos cartões do Jira, Passo 2: "Criar um webhook automaticamente" está desabilitado - Permita a integração com o Jira quando solicitado.
- Após estas etapas, a Miro fornecerá a você o URL do Webhook:
URL do Webhook fornecido pela Miro
✏️ Se você não for um admin de sistema do Jira, por favor, copie o URL do Webhook fornecido pela Miro e envie-o para seu admin de sistema do Jira para que ele possa criar o webhook no Jira usando as instruções abaixo.
Criar o webhook no Jira
Abaixo estão os passos para criar um WebHook no Jira usando a URL obtida do Miro. Você também pode consultar a documentação oficial da Atlassian para Jira Server e para Jira Cloud (embora este artigo foque no Server/Data Center).
- Para navegar até a página de WebHooks no Jira, vá para Administração do Jira > Sistema > Avançado > WebHooks (o caminho exato pode variar ligeiramente dependendo da sua versão do Jira). Alternativamente, você pode usar um link direto anexando
/plugins/servlet/webhooksà URL da sua instância do Jira (por exemplo,https://NomeDaSuaInstanciaJira/plugins/servlet/webhooks). - Clique em Criar um WebHook no canto superior direito da página de WebHooks.
- Insira um Nome descritivo para o WebHook (por exemplo, "Webhook de Integração Miro").
- Defina o status do WebHook como Ativado.
- Cole a URL do Webhook copiada das configurações do Miro no campo de URL.
Configuração do sistema de Webhooks no Jira - Na seção Eventos, em Problema, selecione os eventos atualizado e excluído.
- Clique em Criar para salvar o webhook.
Configurações de eventos do Webhook no Jira - Após o webhook ser criado no Jira, retorne para o Passo 2 nas configurações de cartões do Jira no Miro, certifique-se de que sua URL do Jira está preenchida corretamente e clique em Conectar.
Agora o webhook está criado e configurado. Os cartões do Jira nos seus boards do Miro serão atualizados automaticamente quando alterações forem feitas no Jira.
Webhooks em nível organizacional
NOTA: Se os webhooks em nível de time foram restringidos com filtros JQL (por exemplo, para projetos específicos), o webhook em nível organizacional precisa refletir todos esses filtros JQL ou não ter filtro algum. Revise suas necessidades de JQL antes de migrar para configurações em nível organizacional.
Nas Configurações de Admin da Organização, após a conexão ser configurada, você encontrará a URL do Webhook em instâncias conectadas. Copie o webhook manual e cole-o no seu ambiente Jira.