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.

Actualizado el: 11/07/2026