Você quer sincronizar bancos de dados do Notion com issues do Jira para que as atualizações em uma ferramenta apareçam automaticamente na outra. A integração nativa do Notion com o Jira oferece sincronização bidirecional para campos como status, prioridade, responsável e resumo. Este artigo explica como configurar essa conexão, definir quais campos sincronizar e evitar problemas comuns como duplicatas ou links quebrados.
Principais Pontos: Configurando a Sincronização Bidirecional do Jira no Notion
- Configurações e Membros > Conexões > Jira: Autorize sua conta Atlassian e selecione quais projetos do Jira sincronizar.
- Mapeamento de propriedades do banco de dados: Mapeie as propriedades do banco de dados do Notion (ex.: Status, Responsável) para os campos das issues do Jira para que as alterações fluam nos dois sentidos.
- Frequência de sincronização e resolução de conflitos: O Notion sincroniza a cada poucos minutos, e a edição mais recente vence se ambos os lados forem alterados ao mesmo tempo.
O que a Sincronização Bidirecional Notion-Jira Faz e o que Você Precisa
A integração do Notion com o Jira cria uma conexão ao vivo entre um banco de dados do Notion e um projeto do Jira. Quando você adiciona ou atualiza uma issue no Jira, o Notion reflete essas alterações no banco de dados vinculado em minutos. Da mesma forma, editar uma issue sincronizada no Notion envia a alteração de volta para o Jira. Essa sincronização bidirecional abrange campos principais: Resumo, Descrição, Status, Prioridade, Responsável, Tipo de Issue, Rótulos e Comentários. A integração não sincroniza anexos, dados de sprint ou campos personalizados, a menos que você os mapeie manualmente usando fórmulas ou propriedades de rollup do Notion.
Antes de começar, você precisa de um workspace do Notion com permissões de administrador ou proprietário e uma conta Jira Cloud (Jira Server ou Data Center não são suportados). Sua conta do Jira deve ter permissão para visualizar e editar issues nos projetos que deseja sincronizar. A integração funciona com Jira Software, Jira Service Management e Jira Work Management.
Como a Sincronização Lida com Conflitos
Quando tanto o Notion quanto o Jira recebem edições no mesmo campo em um curto intervalo, o sistema mantém a alteração mais recente. O Notion verifica atualizações a cada 2 a 5 minutos. Se você editar um campo no Notion e alguém editar o mesmo campo no Jira antes da sincronização ser concluída, a edição posterior sobrescreve a anterior. Para evitar perda de dados, evite editar a mesma issue em ambas as ferramentas simultaneamente.
Passos para Conectar o Notion ao Jira e Ativar a Sincronização Bidirecional
- Abra a página de conexão do Jira no Notion
Vá para Configurações e Membros na barra lateral esquerda e clique em Conexões. Encontre Jira na lista e clique em Conectar. Uma nova aba do navegador será aberta pedindo que você faça login na sua conta Atlassian. - Autorize o Notion a acessar seus projetos do Jira
Após fazer login, clique em Aceitar na tela de permissões. O Notion solicita acesso para visualizar e editar issues em seus projetos do Jira. Conceder essa permissão é necessário para a sincronização bidirecional. - Crie um novo banco de dados vinculado ou conecte um existente
No Notion, crie um novo banco de dados digitando/jirae selecionando Issues do Jira. Alternativamente, abra um banco de dados existente, clique no menu … no canto superior direito, escolha Transformar em Issues do Jira e selecione o projeto do Jira que deseja sincronizar. - Selecione o projeto do Jira e o filtro de issues
Na caixa de diálogo de conexão, escolha o projeto do Jira no menu suspenso. Você também pode aplicar um filtro JQL (ex.:assignee = currentUser()) para sincronizar apenas issues específicas. Clique em Sincronizar para iniciar a importação inicial. - Mapeie as propriedades do Notion para os campos do Jira
Após as issues aparecerem, clique no nome da propriedade em qualquer cabeçalho de coluna e depois em Editar propriedade. Em Sincronizar com campo do Jira, escolha o campo correspondente do Jira no menu suspenso. Por exemplo, mapeie a propriedade Status do Notion para o campo Status do Jira. Repita para todos os campos que deseja sincronizar nos dois sentidos. - Teste a sincronização atualizando uma issue
Altere o status de uma issue no Notion (ex.: de A Fazer para Em Andamento). Aguarde 2 a 5 minutos e abra a mesma issue no Jira. O status deve corresponder. Em seguida, altere o responsável no Jira e verifique o Notion após alguns minutos. Confirme se a atualização aparece.
O que Evitar e Problemas Comuns de Sincronização
Campos mapeados não sincronizam ou mostram erro
Se uma propriedade mapeada mostrar um aviso vermelho ou o ícone de sincronização, o campo do Jira pode ser somente leitura ou não suportado. Por exemplo, chaves de issue do Jira e datas de criação são somente leitura. Remova o mapeamento dessa propriedade e use uma propriedade de fórmula no Notion para exibir o valor. Além disso, verifique se o tipo de propriedade do Notion corresponde ao tipo de campo do Jira: um campo de lista suspensa do Jira deve ser mapeado para uma propriedade Selecionar do Notion, não para uma propriedade Texto.
Issues duplicadas aparecem no banco de dados do Notion
Duplicatas ocorrem quando você cria manualmente uma issue no Notion que já existe no Jira, ou quando conecta o mesmo projeto do Jira a vários bancos de dados do Notion. Para corrigir, exclua a linha duplicada do banco de dados do Notion. Evite duplicatas futuras sempre usando o comando /jira para criar novas issues, que primeiro escreve a issue no Jira e depois traz a chave de volta para o Notion.
Comentários sincronizam, mas aparecem fora de ordem
O Notion exibe os comentários na ordem em que são recebidos do Jira, que pode diferir da ordem no Jira se os comentários foram editados ou excluídos. O histórico de comentários do Jira não é preservado no Notion. Para discussões críticas, use o Jira diretamente e trate os comentários do Notion como uma cópia somente leitura.
A sincronização para de funcionar após uma alteração de permissão no Jira
Se um administrador do Jira remover seu acesso ao projeto ou alterar os esquemas de permissão, a integração para de sincronizar. Vá para Configurações e Membros > Conexões > Jira e clique em Reconectar. Talvez seja necessário fazer login novamente e reautorizar. Verifique se sua conta do Jira ainda tem permissões de Navegar Projetos e Editar Issues para o projeto sincronizado.
| Item | Notion Free | Notion Plus ou Business |
|---|---|---|
| Disponibilidade da integração com Jira | Não incluída | Incluída |
| Máximo de projetos sincronizados por workspace | N/A | Ilimitado |
| Frequência de sincronização | N/A | A cada 2 a 5 minutos |
| Mapeamento bidirecional de campos | N/A | Suportado para campos padrão |
| Suporte a filtro JQL | N/A | Suportado |
Com a sincronização bidirecional ativa, você pode gerenciar issues do Jira sem sair do Notion. Em seguida, tente adicionar uma propriedade de rollup no Notion para contar issues vinculadas do Jira, ou use uma propriedade de fórmula para exibir a chave da issue do Jira automaticamente. Para fluxos de trabalho avançados, considere usar a API do Notion para acionar webhooks do Jira quando uma propriedade do banco de dados for alterada.