> ## Documentation Index
> Fetch the complete documentation index at: https://docs.squarecloud.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Como configurar a integração Git na sua aplicação

> Guia completo para configuração da integração Git na Square Cloud com deploy automatizado e gerenciamento profissional de repositórios.

A integração GitHub permite que você conecte seu repositório à Square Cloud para deploy automatizado. Siga este guia passo a passo para configurar a integração completa.

<Steps>
  <Step title="Gerar Token de Acesso GitHub">
    Primeiro, você precisa criar um token de acesso pessoal no GitHub para autenticar a conexão.

    * Acesse a página de [Tokens de acesso pessoal](https://github.com/settings/tokens)
    * Clique em **"Generate new token"** e escolha a opção **"classic"**
    * **Selecione apenas** a opção **"repos"** nas permissões
    * **Não defina tempo de expiração** para evitar interrupções
    * Atribua um nome identificativo ao seu token

    <Frame>
      <img src="https://cdn.squarecloud.app/docs/articles/github/new-personal-access-token.png" alt="Criando um novo token de acesso pessoal no GitHub" style={{ borderRadius: '0.2rem' }} />
    </Frame>

    * Clique em **"Generate token"** e **copie o token** gerado (você não conseguirá vê-lo novamente)

    <Frame>
      <img src="https://cdn.squarecloud.app/docs/articles/github/copy-access-token.png" alt="Copiando o token de acesso do GitHub" style={{ borderRadius: '0.2rem' }} />
    </Frame>
  </Step>

  <Step title="Configurar Token na Square Cloud">
    Agora configure o token na plataforma Square Cloud para estabelecer a conexão.

    * Acesse o [painel de controle](https://squarecloud.app/pt-br/dashboard)
    * Selecione sua aplicação
    * Navegue até a seção **Deploy**
    * **Cole seu token** no campo correspondente
    * Clique em **"Save"**

    <Frame>
      <img src="https://cdn.squarecloud.app/docs/articles/github/deploy-webhook-git.gif" alt="Configurando webhook de deploy automático na Square Cloud" style={{ borderRadius: '0.2rem' }} />
    </Frame>

    Após salvar, uma **URL webhook** será exibida. **Copie esta URL** - você precisará dela no próximo passo.
  </Step>

  <Step title="Configurar Webhook no GitHub">
    Configure o webhook no seu repositório GitHub para que ele comunique com a Square Cloud.

    * Acesse o repositório da sua aplicação no GitHub
    * Vá para **"Settings"** → **"Webhooks"**
    * Clique em **"Add Webhook"**
    * Cole a URL webhook no campo **Payload URL**
    * Defina o **Content Type** como **application/json**
    * Clique em **"Add Webhook"**

    <Frame>
      <img src="https://cdn.squarecloud.app/docs/articles/github/add-webhook.gif" alt="Adicionando webhook ao repositório no GitHub" style={{ borderRadius: '0.2rem' }} />
    </Frame>
  </Step>

  <Step title="Configurar Branch Específica (Opcional)">
    Se desejar que o webhook monitore apenas uma branch específica, configure um parâmetro adicional.

    * No campo **Payload URL** do webhook no GitHub
    * Adicione no final da URL: `?branch=nome_da_branch`

    <Note>
      Exemplo: Para monitorar apenas a branch `main`, adicione `?branch=main` ao final da URL
    </Note>

    <Frame>
      <img src="https://cdn.squarecloud.app/docs/articles/github/setting_branch.gif" alt="Definindo a branch de deploy no GitHub" style={{ borderRadius: '0.2rem' }} />
    </Frame>
  </Step>

  <Step title="Testar Deploy Automatizado">
    Agora teste se a integração está funcionando corretamente.

    * Faça qualquer alteração no seu código
    * Commit e push para o repositório GitHub
    * Sua aplicação na Square Cloud será atualizada automaticamente
    * Verifique os logs de deploy no painel de controle para confirmar o sucesso
  </Step>
</Steps>

## Próximos Passos

Com a integração configurada, você pode:

* Fazer deploy automático a cada push
* Monitorar o status dos deploys no painel
* Configurar diferentes branches para diferentes ambientes
* Aproveitar o sistema de integração contínua da Square Cloud

## Contate-nos

Se você continuar enfrentando **dificuldades técnicas**, nossa **equipe de suporte especializada** está disponível para auxiliá-lo. [**Entre em contato conosco**](https://squarecloud.app/pt-br/support) e teremos prazer em ajudá-lo a resolver qualquer questão.