--- title: "Integrando o GitHub com o Document360 usando o Zapier" slug: "github-document360" description: "Create articles in your Document360 projects from new GitHub commits automatically." tags: ["Zapier", "Github", "Extensions", "Premium"] updated: 2026-06-27T11:16:19Z published: 2026-06-27T11:16:19Z canonical: "docs.document360.com/github-document360" stale: true --- > ## Documentation Index > Fetch the complete documentation index at: https://docs.document360.com/llms.txt > Use this file to discover all available pages before exploring further. # Integrando o GitHub com o Document360 usando o Zapier Quando desenvolvedores fazem commit de novo código ou atualizações em um repositório do GitHub, as alterações correspondentes frequentemente precisam ser refletidas na sua base de conhecimento. Criar ou atualizar manualmente artigos do Document360 para cada commit consome tempo e é propenso a erros. Ao conectar GitHub e Document360 através do Zapier, você pode automatizar isso: sempre que um evento especificado ocorre em um repositório do GitHub, o Zapier cria automaticamente um artigo correspondente na sua base de conhecimento Document360. --- ## Quando usar essa integração - Sua equipe de engenharia segue uma abordagem docs-as-code e quer que cada commit do GitHub em um repositório específico para gerar automaticamente um rascunho de artigo no Document360 para revisão. - Você mantém um changelog ou uma base de conhecimento de notas de lançamento no Document360 e quer que novos commits ou releases no GitHub acionem automaticamente a criação de artigos. - Seu fluxo de trabalho de desenvolvimento inclui atualizações de documentação junto com alterações no código, e você quer garantir que os artigos da base de conhecimento sejam criados em sincronia, sem uma etapa manual. --- ## Antes de começar - Você deve estar logado na sua [conta Zapier](https://zapier.com/app/dashboard). - Você deve ter uma conta no GitHub com acesso ao repositório 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 1. Faça login na sua [conta Zapier](https://zapier.com/app/dashboard). 2. No menu de navegação à esquerda, clique **em Criar** e depois selecione **Zaps**. 3. Um novo Zap é criado com um fluxo **de Gatilho** e **Ação** . ![Screen recording showing a new Zap being created in the Zapier dashboard with Trigger and Action flow](https://cdn.document360.io/860f9f88-412e-4570-8222-d5bf2f4b7dd1/Images/Documentation/1_ScreenGif-Zapier_Google_Docs.gif) ### Passo 2 — Conecte o GitHub como gatilho 1. No campo **Trigger** , escolha **GitHub**. 2. No campo **de evento Trigger** , selecione o evento que deve acionar o Zap. NOTA Para mudar o aplicativo de gatilho depois, clique em **Alterar** no campo Gatilho. 1. Clique no campo **Conta** — um painel de login aparece. 2. Insira suas credenciais do GitHub e clique **em Autorizar Zapier**. 3. Escolha o repositório desejado e clique **em Continuar**. Zapier executa um teste para confirmar que o gatilho está corretamente configurado. ![Zapier trigger configuration showing GitHub connected with repository selection and trigger test](https://cdn.document360.io/860f9f88-412e-4570-8222-d5bf2f4b7dd1/Images/Documentation/1_ScreenShot-Zapier_Github.png) ### Passo 3 — Conectar o Document360 como a ação 1. No campo **Ação** , escolha **Document360**. 2. No painel Configuração, selecione o evento desejado no campo **Evento** . 3. Clique no campo **Conta** — um painel de login aparece. 4. Insira suas credenciais de login e clique em **Permitir**. Para gerar o token API a partir do Document360: 1. Navegue até **Conexões** > **Extensões** na barra de navegação à esquerda do portal da Base de Conhecimento. 2. No bloco de extensão **do Zapier** , clique **em Conectar**. ![Document360 extensions page showing the Zapier tile with the Connect option](https://cdn.document360.io/860f9f88-412e-4570-8222-d5bf2f4b7dd1/Images/Documentation/Zapier%20integration.png) 1. Clique no **ícone Copiar** para copiar o token. ![Zapier token details popup in Document360 showing the generated API token and copy option](https://cdn.document360.io/860f9f88-412e-4570-8222-d5bf2f4b7dd1/Images/Documentation/Zapier%20token%20ID.png) 1. Volte ao painel Zapier e cole o token da API no campo. 2. Clique **em Sim, continuar para Document360**. ![Zapier sign-in panel showing the Document360 API token field](https://cdn.document360.io/860f9f88-412e-4570-8222-d5bf2f4b7dd1/Images/Documentation/5_Screenshot_Zapier_API_Token_Pasting%281%29.png) 1. Você pode encontrar o projeto Document360 conectado na página **da conta Connect Document360** . Para usar uma conta diferente depois, clique **em Alterar**. 2. Clique **em continuar**. ### Passo 4 — Mapear os campos 1. Mapeie os campos do GitHub para o Document360: ![Zapier field mapping panel showing GitHub commit fields mapped to Document360 article fields](https://cdn.document360.io/860f9f88-412e-4570-8222-d5bf2f4b7dd1/Images/Documentation/6_Screenvideo-Map_fields_from_GitHub_into_Document360.png) | Campo | Descrição | | --- | --- | | **Título** | Por padrão, **Novo Commit no GitHub** está selecionado. Outras opções estão disponíveis conforme suas necessidades. | | **Conteúdo** | Por padrão, Mensagem de **Commit** é selecionada. Outras opções estão disponíveis conforme suas necessidades. | | **Versão** | Escolha 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 o artigo 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. 1. Clique **em continuar**. ### Passo 5 — Teste e publique o Zap 1. Na seção de teste, clique **em Enviar Teste**. 2. Se for bem-sucedido, você receberá a mensagem *enviada pelo Artigo de Teste! Verifique sua conta no Document360 para visualizá-lo*. 3. No seu portal Document360, você encontrará um novo artigo intitulado "Novo commit no GitHub" na categoria que você selecionou. 4. Volte ao painel de configuração do Zapier e clique em **Próximo**, depois **em Publicar**. 5. 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. ![Zapier Zap overview page showing the GitHub to Document360 automation with run history](https://cdn.document360.io/860f9f88-412e-4570-8222-d5bf2f4b7dd1/Images/Documentation/2_ScreenShot-GitHub.png) --- ## Como deletar um Zap 1. Navegue até o painel do Zapier. Uma lista de todos os Zaps existentes é exibida na página de visão geral. 2. 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 - Defina o campo **Publicar** como **Falso** ao mapear campos para que artigos acionados pelo GitHub caiam no Document360 como rascunhos. Isso dá à sua equipe de documentação a chance de revisar, formatar e enriquecer o conteúdo antes de ele ser lançado — já que as mensagens de commit brutas raramente estão prontas para serem publicadas como estão. - Use uma **categoria dedicada** no Document360 para artigos acionados pelo GitHub, como uma categoria de "Changelog" ou "Atualizações de desenvolvimento". Isso mantém o conteúdo gerado automaticamente separado dos artigos feitos à mão e facilita a revisão e a promoção. - Escolha um evento de gatilho específico que combine com seu fluxo de trabalho — por exemplo, um push para um branch de release em vez de cada commit — para evitar gerar artigos para toda mudança rotineira de código que não justifique uma entrada no banco de conhecimento.