> ## 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).

# Cómo integrar tu repositorio de GitHub y hacer deploy automático

## Método 1 — Integración con GitHub (automática)
La autenticación con GitHub conecta tu cuenta directamente al repositorio, sin necesidad de crear tokens manuales. Al instalar nuestra aplicación, concedes acceso seguro solo a los repositorios que elijas y mantienes el control total desde el propio GitHub, pudiendo revocar el acceso cuando quieras.

### Paso 1: Conectar tu cuenta de GitHub
1. Accede al panel de Square Cloud y ve a **Mi cuenta → Conexiones**.
2. En la sección **GitHub**, haz clic en **Conectar** y autoriza la aplicación de Square Cloud (flujo OAuth).
3. Elige conceder acceso a **todos los repositorios** o solo a **repositorios seleccionados** y confirma la instalación.

### Paso 2: Elegir el repositorio y la rama en la aplicación
1. Abre la aplicación deseada en el panel y ve a la pestaña **Deploys**.
2. En el bloque **Deploy via GitHub**, confirma que el método seleccionado es **Automático**.
3. En **Integración con GitHub**, selecciona la cuenta u organización en el selector de la izquierda y usa el campo **Search for a repository...** para localizar el repositorio.
4. Haz clic en el repositorio de la lista para seleccionarlo (aparece una marca de selección a su lado).
5. En el panel de la derecha, revisa el **Lenguaje** y el **Tamaño** y elige la **Rama** deseada (por ejemplo, `main`).
6. Haz clic en **Seleccionar repositorio** para guardar.

¡Listo! A partir de ahora, cada push en la rama configurada dispara un nuevo deploy automáticamente.

## Método 2 — Integración por Webhook (manual)
Usa este método si prefieres no conectar tu cuenta mediante OAuth. Aquí generas un token de acceso personal en GitHub y configuras el webhook manualmente en el repositorio.

### Paso 1: Generar el token de acceso en GitHub
1. En GitHub, ve a **Settings → Developer settings → Personal access tokens → Tokens (classic)**.
2. Haz clic en **Generate new token (classic)**.
3. En permisos, selecciona **solo la opción** `repos`.
4. **No definas fecha de expiración**, para evitar interrupciones futuras en el deploy.
5. Haz clic en **Generate token** y copia el token de inmediato — después de salir de la página no podrás verlo de nuevo.

### Paso 2: Configurar el token en Square Cloud
1. Accede al panel y abre tu aplicación.
2. Ve a la pestaña **Deploys**.
3. Pega el token en el campo indicado y haz clic en **Save**.
4. Copia la **URL del webhook** que aparece.

### Paso 3: Configurar el webhook en GitHub
1. En el repositorio, ve a **Settings → Webhooks → Add Webhook**.
2. Pega la URL copiada en el campo **Payload URL**.
3. Define el **Content Type** como `application/json`.
4. Haz clic en **Add Webhook** para confirmar.

### Paso 4: Configurar una rama específica (opcional)
Por defecto, el webhook sigue la rama principal. Para monitorear otra rama, añade el parámetro `?branch=nombre_de_la_rama` al final de la **Payload URL** — por ejemplo, `...webhook?branch=main`.

## Probar la integración
Haz un push en el repositorio, en la rama configurada, y sigue los **logs de deploy** en el panel de la aplicación. Si el deploy inicia por sí solo, la integración está funcionando.

## Preguntas frecuentes
**¿Qué método debo usar?** La integración automática con GitHub es la recomendada y el estándar actual — más simple y sin tokens manuales. Usa el Webhook solo si necesitas una configuración manual.

**¿Necesito configurar los dos métodos?** No. Elige solo uno por aplicación.

**¿Cómo cambio la rama después?** Con el método automático, vuelve a la pestaña **Deploys** y selecciona otra rama. Con el método por webhook, ajusta el parámetro `?branch=` en la Payload URL.