← Volver a la documentación

Integración con GitHub

Vincula un repositorio de GitHub a un proyecto de Willet para que los pull requests actualicen los estados de las tareas automáticamente.

Cómo funciona

Cuando se abre un pull request en un repositorio vinculado y hace referencia a una tarea de Willet con una palabra clave de cierre, la tarea pasa a en_progreso. Cuando el pull request se fusiona, la tarea pasa a lista. La integración solo avanza el estado de una tarea — las tareas ya completadas o canceladas nunca se modifican, y un PR reabierto o revertido no regresa una tarea a un estado anterior. Los cambios de estado se atribuyen a "Willet (GitHub)" y la URL del PR queda registrada en el historial de la tarea.

Configuración

La vinculación se gestiona a través de las herramientas MCP de Willet, no desde el panel. Pídele a cualquier agente de IA conectado a Willet que lo configure por ti, o ejecuta las herramientas directamente. Necesitarás el rol de administrador o propietario en la organización de Willet, y acceso de administrador en el repositorio de GitHub.

  1. Inicia sesión en Willet con GitHub. Solicitaremos los permisos necesarios para registrar webhooks en tus repositorios.
  2. Pídele a tu agente que llame a la herramienta link_github_repo con el slug de tu organización, el slug del proyecto y el repositorio en formato propietario/repositorio.
  3. Si a tu autorización de GitHub guardada le faltan permisos, la herramienta te devolverá una URL — ábrela, vuelve a autorizar y luego ejecuta link_github_repo de nuevo.
link_github_repo org_slug=<org> project_slug=<project> repo=<owner>/<repo>

Referenciar tareas en PRs

Referencia una tarea por su clave legible (el prefijo del proyecto más el número de tarea, como WD-42) o por su ULID de 26 caracteres. Incluye la referencia en el título del PR, la descripción o el nombre de la rama, y combínala con una palabra clave de cierre. Puedes poner tantas tareas como quieras después de una palabra clave.

Fixes WD-12, WD-13 and WD-14

Palabras clave de cierre

La coincidencia no distingue mayúsculas ni acentos, y funciona en todos los idiomas que Willet soporta. Las palabras clave estándar en inglés (close/closes/closed, fix/fixes/fixed, resolve/resolves/resolved, complete/completes/completed) funcionan, además de sus equivalentes naturales en alemán, español, francés, italiano, japonés, coreano y turco. Ambos órdenes son válidos — "fix <tarea>" o "<tarea> fixed" — para adaptarse a los idiomas donde el verbo va al final de forma natural.

Seguridad

Cada repositorio vinculado tiene su propio secreto HMAC de webhook por mapeo, así que un webhook sin firma o repetido no puede mover tareas. Los eventos de webhook de un repositorio sin mapeo en Willet se descartan. La integración confía en el mapeo repositorio↔proyecto en sí: cualquier persona que pueda fusionar un PR en el repositorio vinculado puede avanzar el estado de una tarea, así que no vincules repositorios cuyos colaboradores no deberían poder actualizar tus tareas.