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.
Desconectar
Desconectar quita el enlace de la App o el PAT. Los mapeos repo → producto permanecen.
Volver a conectar
Instala la App otra vez (o pega un PAT nuevo). Remapea solo si borraste mapeos.
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.
Desconectar
Desconectar borra OAuth o PAT. Los mapeos de proyecto permanecen.
Volver a conectar
Conecta con GitLab otra vez (o pega un PAT). Guarda un mapeo si faltaba el webhook del 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.
Desconectar
Desconectar quita el token API de Marqab. Actualiza o elimina el webhook de Jira si no vas a reconectar.
Volver a conectar
Introduce URL del sitio, email y un token API nuevo. Pega de nuevo el Cloud ID si usas Forge.
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.
Desconectar
Desconectar desvincula la instalación o el token. Los mapeos permanecen.
Volver a conectar
Instala la app de Sentry otra vez, o pega un token interno y Client Secret nuevos.
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.
Desconectar
Desconectar detiene los mensajes de Marqab. También puedes quitar la app de Slack.
Volver a conectar
Pega un token de bot o webhook nuevo y un canal, luego Prueba la conexión.
Desconectar y volver a conectar
- Propietarios y admins: abre el proveedor → Desconectar. Se borran las credenciales. Los mapeos se conservan.
- Vuelve a conectar con Instalar / Conectar (o pega de nuevo). Una conexión o mapeo nuevo recupera 90 días.
- Los workspaces de solo lectura pueden Desconectar y Probar; Conectar puede exigir un plan superior.
¿Necesitas una mano?
Ajustes → Ayuda y soporte, o ve a Support. Las páginas legales de este sitio están en inglés. Support