Se sua equipe usa o Confluence Server como wiki central para documentação de projetos e também mantém uma base de conhecimento interna ou voltada para o cliente no Document360, manter ambas as plataformas sincronizadas manualmente é um trabalho repetitivo. Ao conectar o Confluence Server e o Document360 através do Zapier, você pode automatizar isso: sempre que uma nova página ou post de blog é criado em um espaço Confluence, o Zapier automaticamente cria um artigo correspondente no Document360.
Usando o Confluence Cloud em vez disso?
Se você usar o Confluence Cloud em vez do Confluence Server, pode conectá-lo ao Document360 usando um modelo pré-montado do Zapier: Tente este Zap →
Quando usar essa integração
- Sua equipe cria páginas de projeto ou posts de blog no Confluence Server e quer que essas entradas apareçam automaticamente como artigos no Document360, sem copiar manualmente.
- Você mantém documentação paralela tanto no Confluence (para uso interno da equipe) quanto no Document360 (para um público mais amplo) e quer que o novo conteúdo do Confluence acione automaticamente a criação do artigo no Document360.
- Você está migrando conteúdo do Confluence Server para o Document360 gradualmente e quer que o conteúdo novo criado durante a transição chegue às duas plataformas simultaneamente.
Antes de começar
- Você deve estar logado na sua conta Zapier.
- Você deve ter uma conta do Confluence Server com acesso ao espaço que deseja monitorar.
- Você deve ter seu token da API do Document360 pronto. Para gerar uma, navegue até Conexões > Extensões, localize o bloco Zapier e clique em Conectar para copiar o token.
Como configurar o Zap
Passo 1 — Crie um novo Zap
- Faça login na sua conta Zapier.
- No menu de navegação à esquerda, clique em Criar e depois selecione Zaps.
- Um novo Zap é criado com um fluxo de Gatilho e Ação .
Passo 2 — Conecte o Servidor Confluence como gatilho
- No campo Trigger , escolha Servidor Confluence.
- No campo de evento Trigger , selecione Nova Página ou Post do Blog.
NOTA
Para mudar o aplicativo de gatilho depois, clique em Alterar no campo Gatilho.
- Clique no campo Conta — um painel de login aparece.
- Insira a URL base do seu site Confluence, e-mail da conta e token da API, depois clique em Sim, Continuar para o Servidor Confluence.
- Clique em continuar. Zapier executa um teste para confirmar que o gatilho está corretamente configurado.
- No painel de configuração do Trigger , selecione o espaço que você quer monitorar.
- Escolha o tipo de conteúdo — seja post de blog ou página — dependendo do que deve desencadear o Zap.
- Se você tiver um espaço recém-criado que não aparece na lista, clique em Atualizar lista para atualizá-lo.
- Clique em Testar para gatilhar, depois clique em Continuar.
Passo 3 — Conectar o Document360 como a ação
- No campo Ação , escolha Document360.
- No painel Configuração, selecione o evento desejado no campo Evento .
- Clique no campo Conta — um painel de login aparece.
- Insira suas credenciais de login e clique em Permitir.
Para gerar o token API a partir do Document360:
- Navegue até Conexões > Extensões na barra de navegação esquerda do portal da Base de Conhecimento.
- No bloco de extensão do Zapier , clique em Conectar.
- Clique no ícone Copiar para copiar o token.
- Volte ao painel Zapier e cole o token da API no campo.
- Clique em Sim, continuar para Document360.
- Você pode encontrar o projeto Document360 conectado na página da conta Connect Document360 . Para usar uma conta diferente depois, clique em Alterar.
- Clique em continuar.
Passo 4 — Mapear os campos
- Mapeie os campos necessários para o artigo do Document360:
| Campo | Descrição |
|---|---|
| Versão | Selecione o espaço de trabalho no seu projeto Document360 onde o artigo deve ser criado. |
| Idioma | Escolha o idioma dentro do espaço de trabalho selecionado. |
| Categoria | Selecione a categoria onde o artigo será criado. |
| Publicar | Coloque em Verdadeiro para publicar imediatamente. Defina para False para salvar como rascunho. |
NOTA
O botão Continuar só é ativado depois que todos os campos necessários já foram mapeados.
- Clique em continuar.
Passo 5 — Teste e publique o Zap
- Na seção de teste, clique em Passo de Teste.
- Se for bem-sucedido, você receberá a mensagem de que um documento foi enviado para o Document360.
- No seu portal Document360, você encontrará um novo artigo intitulado com o nome da página ou post do blog da Confluence, localizado na categoria que você selecionou.
- Volte ao painel de configuração do Zapier e clique em Próximo, depois em Publicar.
- Você verá uma mensagem de sucesso: seu Zap está ligado. Clique em Gerenciar seu Zap para ir à página de visão geral do Zap.
Visão geral do Zap
Uma vez ativado, você pode visualizar e gerenciar o Zap a partir do painel Zapier. A página de visão geral mostra o histórico de disparo, ação e execução do Zap.
Como deletar um Zap
- Navegue até o painel do Zapier. Uma lista de todos os Zaps existentes é exibida na página de visão geral.
- Clique no ícone de ações do Zap () à direita do Zap que você quer remover e clique em Deletar. O Zap é deletado permanentemente.
Melhores práticas
- Monitore um espaço específico de Confluence em vez de toda a sua instância de Confluence. Apontar o Zap para um único espaço facilita o controle de qual conteúdo entra no Document360 e evita puxar páginas de equipe não relacionadas.
- Defina Publish como False ao mapear campos para que o conteúdo proveniente da Confluence apareça no Document360 como rascunho. As páginas Confluence frequentemente contêm formatação ou referências internas que precisam ser ajustadas antes de estarem prontas para uma base de conhecimento pública.
- Mapee o título da página Confluence ao campo título do artigo do Document360 para que o nome do artigo no Document360 corresponda à fonte. Isso facilita rastrear os artigos até sua origem na Confluence e manter ambas as plataformas alinhadas.