AJUDA
Como Conectar Sua Primeira Integração
Um passo a passo, com screenshot real, de como adicionar uma conexão de provider — usando Jira como exemplo.
Antes de começar
Você precisa ser Admin — adicionar uma integração nova é só de Admin, diferente de outras configurações (como regra de métrica) que um Gestor também pode mudar. Qualquer pessoa com acesso à tenant ainda consegue ver a lista de integrações conectadas e disparar uma sincronização, só não registrar uma nova.
Vá em Integrations no menu principal. Você vê uma grade de cards de provider — Jira, Linear, GitHub, Azure DevOps, Vercel, ArgoCD, Waroom, incident.io — cada um mostrando quantas conexões já tem, se tiver alguma.
Passos
1. Clique num card de provider pra expandir
Clicar em qualquer card de provider — já conectado ou não — abre um painel abaixo da grade com um formulário de adicionar integração no topo e a lista de conexões já registradas pra esse provider embaixo. Não existe uma página separada de "adicionar integração"; tudo fica nessa mesma tela.
2. Preenche o formulário
Os campos dependem do provider. Pro Jira: um token de API, a Base URL do Jira, o email da conta dona do token, e uma Project Key opcional (deixe em branco pra sincronizar o site inteiro em vez de um projeto só). Você também pode opcionalmente já atribuir a integração a um time específico, ou deixar sem time e vincular depois. Alguns providers — GitHub, Waroom, ArgoCD entre eles — deixam sincronizar tudo que o token vê primeiro e atribuir repositório/board a time depois, já com dado real pra escolher.
Dado ilustrativo, apenas para demonstração.
3. Clica em "Register integration"
A credencial é validada contra o provider na hora — um token inválido falha aqui mesmo, de forma clara, em vez de ficar salvo quebrando uma sincronização silenciosamente três semanas depois.
4. Sincroniza
Depois de registrada, a integração aparece na lista de conectadas com seu próprio histórico de sincronização, independente de qualquer outra integração desse provider. A sincronização roda de forma incremental, disparada manualmente na mesma lista ou uma vez por dia sozinha.
Relacionado
Veja todo provider suportado e como a sincronização funciona na página de Integrações.
Perguntas sobre conectar uma integração
Dá pra conectar dois boards do mesmo provider?
Sim — um único provider pode ter várias integrações, como dois boards Jira, um por time, cada um sincronizando e sendo atribuído a um time de forma independente.
O que acontece se eu errar a credencial?
Falha no passo "Register integration", na hora — a credencial errada nunca fica salva, então não pode quebrar uma sincronização silenciosamente depois.
Por que não consigo ver o formulário "Register integration"?
Só Admin pode adicionar uma integração nova. Um Gestor consegue ver a lista conectada e disparar sincronização, mas o formulário de adicionar em si é só de Admin.
Conecte sua primeira integração
Começar grátis