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.

Atualizado em: 11/07/2026