Antes de empezar
- Necesitas el rol de owner o admin en el workspace de Marqab.
- Mapea una fuente a un producto después de conectar. Los repos y proyectos sin mapa se ignoran.
- Una conexión o mapeo nuevo recupera los últimos 90 días.
- Los secretos de webhook se muestran una vez. Rótalos solo si puedes actualizar el proveedor el mismo día.
GitHub
Los pull requests fusionados y los releases publicados se vuelven actividad, resúmenes y notas de release.
Configuración
- Ajustes → Integraciones → GitHub. Solo owners y admins.
- Elige Install GitHub App y la organización o los repositorios.
- Mapea cada repositorio (owner/repo) a un producto.
- Marqab recupera los últimos 90 días de PRs fusionados. Los merges y releases nuevos llegan al momento.
Si no. GitHub Enterprise, o si falta el botón de la App: pega un token personal, pon la URL de la API si hace falta y añade un webhook de pull requests y releases.
GitLab
Los merge requests fusionados, releases y pushes de tags alimentan la misma actividad y las mismas notas.
Configuración
- Ajustes → Integraciones → GitLab.
- Elige Connect with GitLab y autoriza Marqab en gitlab.com.
- Mapea cada proyecto a un producto. Marqab registra el webhook del proyecto por ti.
- Se recuperan los últimos 90 días de MRs fusionados.
Si no. GitLab propio, o si falta Connect: pega un token personal, pon la URL base, mapea proyectos y añade un webhook de proyecto.
Jira
Los issues que pasan a Done se vuelven tickets cerrados. Los abiertos pueden verse en la ficha del producto.
Configuración
- Ajustes → Integraciones → Jira.
- Introduce la URL del sitio, el correo de Atlassian y un token de API.
- Mapea cada clave de proyecto a un producto.
- Añade el webhook que muestra Marqab (Issue updated).
Si no. Si está instalada la app Forge de Marqab, pega también el Cloud ID y añade el campo de producto Marqab a la pantalla.
Sentry
Issues nuevos y reaparecidos, más las resoluciones, llegan al producto. Los abiertos se pueden listar en vivo.
Configuración
- Ajustes → Integraciones → Sentry. Instala la app Marqab si aparece, o conecta una integración interna.
- En una integración interna: concede Project, Issue & Event y Organization Read. Activa el webhook de issues.
- Pega el token y el Client Secret. Pon el slug de la org.
- Mapea cada slug de proyecto Sentry a un producto o a un componente.
Si no. Las integraciones internas usan la URL de webhook por workspace que muestra Marqab.
Slack
Marqab publica resúmenes de release y un digest los lunes en un canal que elijas. No se extrae nada.
Configuración
- Instala la app de Slack de Marqab y copia el Bot User OAuth Token.
- Ajustes → Integraciones → Slack: pega el token y un canal (por ejemplo #releases).
- Opcional: pon el workspace de Slack para que funcionen los botones «abrir en Slack» del owner.
- Prueba la conexión. Los releases se publican al salir; el digest corre los lunes a las 09:00 UTC.
Si no. Una Incoming Webhook URL sigue valiendo si no quieres un token de bot.
¿Necesitas una mano?
Ajustes → Ayuda y soporte, o ve a Support. Las páginas legales de este sitio están en inglés. Support