Webhooks e importación de GitHub
Las tres funciones se usan por API; no tienen pantalla propia.
Webhooks entrantes
Sección titulada «Webhooks entrantes»POST /api/webhooks/incoming?workspace_id=<ws> recibe eventos firmados, de GitHub o propios.
Configuración: el secreto de cada workspace se guarda en el setting webhooks.incoming.<workspace>.secret:
curl -X PUT http://localhost:13333/api/settings -H 'content-type: application/json' \ -d '{"settings": {"webhooks.incoming.ws-default.secret": "<secreto>"}}'Firma:
| Origen | Headers |
|---|---|
| GitHub | x-hub-signature-256, x-github-event y x-github-delivery (GitHub los manda solos si configurás el mismo secreto) |
| Propio | x-taia-webhook-signature = sha256= + HMAC-SHA256 de "<timestamp>.<body>", x-taia-webhook-timestamp (segundos Unix) y x-taia-webhook-id |
Se rechazan las firmas inválidas, los timestamps de más de 5 minutos y las entregas repetidas (mismo id).
Qué hace con GitHub: busca en el issue o PR una referencia a una tarea (task:<id>) y, según el evento, la mueve:
| Evento | Columna destino |
|---|---|
Issue closed |
DONE |
Issue reopened |
IN_PROGRESS |
PR opened, ready_for_review, synchronize… |
REVIEW |
PR closed mergeado / no mergeado |
DONE / REJECTED |
Esos slugs son los del preset Software Dev. Si el workspace no tiene esa columna, la transición queda registrada en la actividad pero no se aplica. Con ?dry_run=1 solo se registra.
Webhooks salientes
Sección titulada «Webhooks salientes»TAIA puede avisar a otros sistemas cuando pasan cosas en un workspace (tareas creadas, movidas, etc.). Los endpoints se configuran en el setting webhooks.outgoing.<workspace>.endpoints, un array JSON:
[{ "id": "ci", "url": "https://example.com/hook", "secret": "…", "events": ["task:moved"], "active": true }]-
Sin
events(o con"*"), se mandan todos. -
Cada entrega lleva los headers
x-taia-eventyx-taia-workspace-idy, si hay secreto,x-taia-signature: sha256=<HMAC del body>. -
Los fallos se reintentan. Las entregas que agotan los reintentos quedan como dead letter:
GET /api/webhooks/outgoinglas lista yPOST /api/webhooks/outgoingcondelivery_idlas reenvía. -
GET /api/webhooks/outgoingyGET /api/settingsno devuelven los secretos: los endpoints se listan conhasSecret.
Importar issues de GitHub
Sección titulada «Importar issues de GitHub»POST /api/import/github crea o actualiza tareas a partir de issues. TAIA no consulta GitHub: los issues los mandás vos, por ejemplo desde un script con gh:
gh issue list --repo acme/web --json number,title,body,state,labels,url > issues.jsoncurl -X POST http://localhost:13333/api/import/github -H 'content-type: application/json' \ -d "{\"repository\": {\"owner\": \"acme\", \"name\": \"web\"}, \"issues\": $(cat issues.json), \"dryRun\": false}"dryRunestruepor defecto: devuelve el plan (crear, actualizar o sin cambios) sin tocar nada.- Volver a importar es idempotente: cada tarea queda marcada con un tag
github:<owner>/<repo>#<n>. - Las tareas nuevas caen en la columna inicial, salvo que mandes
default_status. - También acepta
workspace_id,project,project_idydefault_priority.