GitHub

Con un webhook de GitHub, el CRM registra cada corrida de tus workflows de deploy:

• cada despliegue muestra su último deploy exitoso: versión (tag), commit, fecha y autor;
• un deploy fallido abre un incidente y avisa con el repositorio, la rama o el tag, el commit, el autor, el entorno, en qué job y en qué paso falló y el link al log;
• si un job queda esperando un runner más de 10 minutos (configurable), abre el incidente “El runner no toma trabajos”;
• los requerimientos nombrados en los commits de un deploy a producción quedan marcados “en producción” con la versión.

Conectar un repositorio

1. En el CRM, entrá a Operación, abrí el despliegue y tocá Deploys. Agregá el repositorio (dueño/nombre).

2. El CRM muestra lo que hay que cargar en GitHub. El Secret se muestra una sola vez: copialo ahora. Si lo perdés, se regenera y hay que volver a cargarlo.

3. Tocá Abrir los webhooks del repositorio (o entrá a GitHub → el repositorio → Settings → Webhooks → Add webhook) y completá:

   Campo	Valor
   Payload URL	La que muestra el CRM.
   Content type	application/json
   Secret	El que muestra el CRM.
   Eventos	“Let me select individual events”: Workflow runs, Workflow jobs y Pushes.

4. Guardá. La próxima corrida de deploy aparece en el CRM.

• Workflow runs: cada corrida y su resultado.
• Workflow jobs: en qué paso falló y si el runner dejó de tomar trabajos.
• Pushes: qué commits salieron en cada deploy.

Nota

GitHub firma cada aviso con el secreto, y el CRM verifica la firma antes de creerle: nadie puede inventar un deploy.

Qué workflows cuentan como deploy

Los que tienen la palabra configurada (por defecto, “deploy”) en el nombre o en el archivo del workflow.

Decirle el entorno al CRM

El CRM deduce el entorno del tag o de la rama: staging o develop son staging; el resto, producción. Para decirlo explícito, poné env= en el run-name del workflow:

name: Deploy
run-name: "Deploy env=production ${{ github.ref_name }}"
on:
  push:
    tags: ["prod*"]
jobs:
  deploy:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - run: echo "Tu deploy acá"

Vincular commits con requerimientos

Si el mensaje de un commit nombra un código del tablero (“RF-120: historial de pedidos”), el commit queda vinculado a ese ítem. Con Claude Code, el hook del repositorio lo hace solo después de cada commit (ver Claude).