> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://help.squarecloud.app/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# Como integrar seu repositório do GitHub e fazer deploy automático

## Método 1 — Integração via GitHub (automática)
A autenticação via GitHub conecta sua conta diretamente ao repositório, sem precisar criar tokens manuais. Ao instalar nossa aplicação, você concede acesso seguro apenas aos repositórios escolhidos e mantém o controle total pelo próprio GitHub, podendo revogar o acesso quando quiser.

### Passo 1: Conectar sua conta do GitHub
1. Acesse o painel da Square Cloud e vá em **Minha conta → Conexões**.
2. Na seção **GitHub**, clique em **Conectar** e autorize a aplicação da Square Cloud (fluxo OAuth).
3. Escolha conceder acesso a **todos os repositórios** ou apenas a **repositórios selecionados** e confirme a instalação.

### Passo 2: Escolher o repositório e a branch na aplicação
1. Abra a aplicação desejada no painel e vá até a aba **Deploys**.
2. No bloco **Deploy via GitHub**, confirme que o método selecionado é **Automático**.
3. Em **Integração via GitHub**, selecione a conta ou organização no seletor da esquerda e use o campo **Search for a repository...** para localizar o repositório.
4. Clique no repositório na lista para selecioná-lo (um marcador de seleção aparece ao lado dele).
5. No painel da direita, confira a **Linguagem** e o **Tamanho** e escolha a **Branch** desejada (por exemplo, `main`).
6. Clique em **Selecionar repositório** para salvar.

Pronto! A partir de agora, cada push na branch configurada dispara um novo deploy automaticamente.

## Método 2 — Integração via Webhook (manual)
Use este método se preferir não conectar sua conta via OAuth. Aqui você gera um token de acesso pessoal no GitHub e configura o webhook manualmente no repositório.

### Passo 1: Gerar o token de acesso no GitHub
1. No GitHub, acesse **Settings → Developer settings → Personal access tokens → Tokens (classic)**.
2. Clique em **Generate new token (classic)**.
3. Em permissões, selecione **apenas a opção** `repos`.
4. **Não defina tempo de expiração**, para evitar interrupções futuras no deploy.
5. Clique em **Generate token** e copie o token imediatamente — depois de sair da página você não conseguirá vê-lo novamente.

### Passo 2: Configurar o token na Square Cloud
1. Acesse o painel e abra a sua aplicação.
2. Vá até a aba **Deploys**.
3. Cole o token no campo indicado e clique em **Save**.
4. Copie a **URL do webhook** que será exibida.

### Passo 3: Configurar o webhook no GitHub
1. No repositório, vá em **Settings → Webhooks → Add Webhook**.
2. Cole a URL copiada no campo **Payload URL**.
3. Defina o **Content Type** como `application/json`.
4. Clique em **Add Webhook** para confirmar.

### Passo 4: Configurar uma branch específica (opcional)
Por padrão, o webhook acompanha a branch principal. Para monitorar outra branch, adicione o parâmetro `?branch=nome_da_branch` ao final da **Payload URL** — por exemplo, `...webhook?branch=main`.

## Testando a integração
Faça um push no repositório, na branch configurada, e acompanhe os **logs de deploy** no painel da aplicação. Se o deploy iniciar sozinho, a integração está funcionando.

## Dúvidas frequentes
**Qual método devo usar?** A integração automática via GitHub é a recomendada e o padrão atual — mais simples e sem tokens manuais. Use o Webhook apenas se precisar de uma configuração manual.

**Preciso configurar os dois métodos?** Não. Escolha apenas um por aplicação.

**Como troco a branch depois?** No método automático, volte à aba **Deploys** e selecione outra branch. No método via webhook, ajuste o parâmetro `?branch=` na Payload URL.