Integrar o Jira

hc: imagem principal jira
Neste artigo

Conecte o Jira ao Notion para obter uma experiência perfeita que mantém você e sua equipe sempre sintonizados 🔗


A integração do Notion com o Jira permite que você faça algumas coisas diferentes. Você pode inserir os links do Jira nas páginas do Notion para acessar rapidamente ou visualizá-los, ou pode sincronizar os seus projetos e problemas do Jira com a base de dados do Notion para acompanhar todo o seu trabalho em um só lugar. Continue lendo para saber mais sobre as diferentes formas de integração e como você pode configurá-las.

Diferenças da integração com o Jira

O Notion oferece duas integrações com o Jira: Jira e Jira Sync. Pense nelas como as opções básica e completa.

Se você só precisar sincronizar um único projeto do Jira com uma base de dados do Notion uma vez, e não planeja configurar sincronizações adicionais, a sincronização de base de dados simples por meio da integração do Jira pode ser suficiente. Mas lembre-se: ela usa tokens de usuário, que tendem a ser menos confiáveis do que os tokens de administrador usados pelo Jira Sync.

Para uma sincronização contínua e flexível entre vários projetos e bases de dados, o Jira Sync é a opção mais recente e poderosa. Mas lembre-se: é necessário um administrador do Jira para configurá-la.

Obs.: não há migração com um clique na integração antiga do Jira com o Jira Sync. São integrações separadas, portanto, a configuração do novo Jira Sync demandará a reinstalação completa.

Diferença

Jira

Jira Sync

Usado para

• Pré-visualizações de links
• Menções de links
• Bases de dados sincronizadas [versão antiga]

• Bases de dados sincronizadas [novo e melhorado!]

Configuração

Conexão de usuário individual

Proprietário do espaço de trabalho e administrador do Jira

Mais pontos de entrada

Configurações → Conexões

Configurações → Importação

Atualizar bases de dados sincronizadas da forma antiga

As bases de dados sincronizadas da forma antiga têm a seguinte aparência. Se você tiver uma base de dados sincronizada da forma antiga, poderá seguir os passos acima para recriar seus projetos e a base de dados de itens no Notion usando o nova função aprimorada de Sincronização com o Jira.

  1. Clique neste link para acessar a página de integração do Jira e, em seguida, em Adicionar ao Notion.

    • Você também pode encontrar esta página acessando ConfiguraçõesConexõesProcurar conexões na Galeria.

Observação: as pré-visualizações de link funcionam com todos os modelos de implantação do Jira Software (Jira Cloud, Jira Data Center e Jira Server).

Para visualizar os links do Jira:

  1. Acesse ConfiguraçõesConexões.

  2. Se você estiver usando o Jira Cloud, encontre a seção do Jira. Se você estiver usando o Jira Data Center ou o Jira Server, encontre a seção de visualização do Jira (Data Center). Você pode ter que rolar um pouco para baixo para encontrar a seção do data center. Em seguida, selecione Conectar abaixo da seção.

  3. Na janela exibida, selecione sua versão do Jira. Em seguida, insira o URL, o nome de usuário e a senha do seu site e selecione Autenticar.

Depois de autenticar com sucesso, você verá a visualização do Jira ou do Jira (Data Center) na parte superior da lista de conexões. Qualquer link do Jira colado no Notion deve aparecer automaticamente como uma pré-visualização de link.

Como alternativa, você pode configurar pré-visualizações de links diretamente de uma página do Notion. Para isto:

  1. Em uma página do Notion, cole uma URL do Jira.

  2. Na janela exibida, selecione sua versão do Jira, conforme solicitado. Em seguida, insira o URL, o nome de usuário e a senha do seu site e selecione Autenticar.

Observação: as menções de link funcionam com todos os produtos do Jira Cloud.

  1. Cole um link do Jira no Notion.

  2. Selecione "Menção" no menu exibido para referenciar facilmente um projeto ou problema nos seus documentos.

    • Se você ainda não tiver conectado o Jira ao Notion, será solicitado que você o faça quando colar o link do Jira no Notion. Saiba mais sobre as menções do link neste artigo →

A integração do Jira Sync conecta seus projetos do Jira ao Notion usando um token de API de administrador (em vez de um token de usuário), o que proporciona uma experiência de sincronização mais consistente e centralizada.

Para garantir uma sincronização confiável, recomendamos criar um token sem escopo selecionando Criar token de API, não Criar token de API com escopos.

Agora você pode tirar o máximo proveito dos recursos do Notion, incluindo automações, rollups e IA do Notion. Use a IA do Notion para obter rapidamente repostas sobre seus projetos do Jira.

Observação:

  • O proprietário do espaço de trabalho deve configurar o Jira Sync primeiro e, em seguida, todos os membros poderão usá-lo.

  • Você pode criar uma conta de serviço do Jira para configurar essa integração — apenas certifique-se previamente de que a conta de serviço tenha acesso a todos os projetos que você deseja sincronizar com o Notion.

  • A base de dados sincronizada funciona com os produtos Jira Cloud (Jira Software, Jira Product Discovery, Jira Work Management e Jira Service Management), com suporte para o Jira Server em breve!

O Jira Sync exibe seus projetos e problemas do Jira como projetos do Notion e base de dados de problemas. Essa configuração permite que você veja e acompanhe vários projetos usando uma variedade de visualizações, filtros e classificações úteis.

Você pode até usar o mapeamento de identidade para conectar as identidades do Jira aos perfis do Notion, de modo que possa ver quem é responsável pelo que na base de dados sincronizada do Notion.

🟡 Obs.: Somente os proprietários doespaço de trabalho podem configurar o Jira Sync, usando um token de administrador do Jira. Depois disso, qualquer membro poderá utilizar a conexão.

Configurar o Jira Sync

Embora qualquer membro possa criar sincronizações, você precisará ser proprietário de espaço de trabalho para configurar o Jira Sync inicialmente.

  1. Acesse Configurações na barra lateral → ImportaçõesSincronização com o Jira.

    • Você também pode colar o link da base de dados do Jira ou usar um comando de barra /jira sync.

    • Se tiver criado anteriormente uma base de dados sincronizada com o Jira no Notion, abra essa base de dados e selecione Melhore sua sincronização com o Jira na parte superior.

  2. Na janela que aparece, selecione Comece a usar.

  3. Digite seu e-mail de administrador do Jira, o URL do site do Jira e o token da API e selecione Avançar.

Observação: ao criar um token de administrador para o Jira Sync, é recomendável definir a data de validade para o mais longe possível no futuro.

O Jira Sync depende desse token para manter uma conexão estável. Se ele expirar, a sincronização poderá ser interrompida e as atualizações poderão ser perdidas.

Adicionar uma nova sincronização

Nota: Os membros precisam autenticar o Jira para Adicionar ou remover projetos. Eles só podem adicionar projetos aos quais tenham acesso no Jira.

  1. Acesse Configurações na barra lateral → ImportaçõesSincronização com o Jira.

    • Você também pode colar o link da base de dados do Jira ou usar um comando de barra /jira sync.

  2. Na janela que aparece, selecione Comece a usar.

  3. Selecione o site do Jira a partir do qual você deseja sincronizar.

  4. Selecione Criar uma nova sincronização ou qualquer sincronização existente que você já tenha no menu suspenso. Se você escolher uma sincronização existente, os seus projetos serão adicionados aos projetos sincronizados existentes e à base de dados de itens.

  5. Na base de dados exibida, você deverá conectar a sua conta do Jira (a menos que você seja o proprietário do espaço de trabalho que configurou a integração). A partir daí, selecione os dados que deseja sincronizar com o Notion. Primeiro, selecione projetos para sincronizar e, em seguida, selecione as propriedades para sincronizar.

Repita as etapas acima se quiser configurar outra sincronização com o Jira para outro site, espaço de equipe ou espaço de trabalho. Os comentários e os anexos (até cinco arquivos por item, não superiores a 1 MB) também serão sincronizados.