Hilbana
ES/EN

Webhooks entrantes

Crea o mueve issues desde peticiones firmadas de sistemas externos.

Los webhooks entrantes son el sentido inverso: un sistema externo hace una petición firmada a Hilbana para crear una issue nueva o mover una existente de estado.

Qué es

Se configuran en Ajustes → Webhooks entrantes (solo administradores). Cada uno apunta a un equipo (obligatorio) y a un proyecto (opcional; si no, al General), y te da una URL de recepción y un secreto.

Para qué sirve

Dar de alta issues por programa desde formularios, monitorización, CI u otras herramientas, sin usar la API completa.

Cómo se usa

El sistema externo hace un POST firmado (HMAC-SHA256 con el secreto del webhook) a la URL de recepción, con uno de dos cuerpos:

  • Crear: { "action": "create", "title": "…", "description": "…", "priority": "…" }. El título es obligatorio.
  • Mover: { "action": "move", "identifier": "DRAPPS-123", "state": "completed" }. El estado se indica por categoría (backlog, unstarted, started, completed…), no por nombre.

Detalles

  • La autenticación es por la firma, no por un token en la URL; una firma inválida se rechaza.
  • Cada webhook tiene su propio secreto.

Relacionado: Webhooks salientes · Bandejas de email · Issues.