Gestores de incidencias
Convierta una sesión en un ticket mientras la ve: un botón en el reproductor, su propia descripción y el enlace de reproducción ya incluido.
1. Por qué esta integración es manual
Todos los demás puentes de MousePlayer se activan solos. Este no, y es una decisión deliberada.
Un ticket supone trabajo para una persona. Si abriéramos uno por cada clic de rabia, su tablero se llenaría de elementos sin clasificar y, en una semana, su equipo los filtraría, incluidos los problemas reales.
Por eso el activador es usted. Ve una sesión, detecta el problema, pulsa el botón y escribe lo observado. El enlace ya está en la descripción; usted aporta el criterio.
El botón solo aparece para propietarios y administradores, nunca en la vista de un enlace compartido. Quien recibe una grabación no debe poder abrir tickets en su gestor.
2. Los cinco gestores y qué necesita cada uno
| Dónde se crea | Debe proporcionar | |
|---|---|---|
| Jira | una incidencia en un proyecto | URL del sitio, correo de la cuenta, token API, clave del proyecto y tipo de incidencia |
| Linear | una incidencia en un equipo | clave API e ID del equipo |
| Asana | una tarea en un proyecto | token de acceso personal e ID del proyecto |
| Trello | una tarjeta en una lista | clave, token e ID de lista |
| GitHub | una incidencia en un repositorio | token de acceso personal y propietario/repositorio |
Una tarjeta, un proveedor seleccionado a la vez. Añadir otro gestor más adelante consiste en cambiar la selección, no en migrar.
De dónde obtener los identificadores
El ID de equipo de Linear y el de proyecto de Asana aparecen en la URL al abrirlos en un navegador. El ID de lista de Trello es el más difícil de los cinco: añada .json a la URL de un tablero y busque la lista. La clave de proyecto de Jira es el prefijo de cada número de incidencia: ACME en ACME-1234.
3. Nuestro servidor construye el enlace del ticket
La descripción es suya. El enlace de reproducción se genera en nuestro servidor a partir de la sesión que estaba viendo, y el formulario no puede alterarlo.
Esto importa porque otras personas hacen clic en los tickets. Si el enlace procediera del navegador, una solicitud manipulada podría mostrar cualquier dirección a su equipo dentro de algo que parece de sus propias herramientas.
HTTP 200 no significa que el ticket exista
Linear responde mediante GraphQL, y GraphQL devuelve 200 OK con un array errors cuando rechaza la operación. Un puente que solo mirara el estado notificaría éxito para un ticket que nunca se creó. Leemos el cuerpo.
Cuando el gestor devuelve el identificador de la nueva incidencia, lo mostramos en la confirmación para que pueda verificar su existencia en lugar de confiar en un mensaje verde.
4. Qué no se incluye deliberadamente
Sin tickets automáticos
Véase lo anterior. Si quiere automatización, el puente webhook puede enviar señales de frustración a Zapier o Make; allí decide qué merece un ticket.
Sin sincronización bidireccional
Cerrar el ticket no cambia nada en MousePlayer y nada en MousePlayer lo reabre. Una sincronización parcial es peor que ninguna, porque las personas empiezan a depender de ella.
Sin archivos adjuntos
La grabación se conserva y se ve en MousePlayer. Exportar un vídeo a un gestor trasladaría datos personales a un sistema con reglas de conservación distintas de las acordadas con sus visitantes.
El token se almacena cifrado con AES-256-GCM y nunca vuelve a mostrarse. Tampoco entra en la cola interna: esta llamada se realiza mientras espera, directamente desde la solicitud.
5. GitLab, Azure DevOps y ClickUp
Tres gestores más, el mismo botón y la misma activación manual.
| Debe proporcionar | |
|---|---|
| GitLab | host, ID del proyecto y token; también funciona su propia instancia de GitLab |
| Azure DevOps | organización, proyecto, tipo de elemento de trabajo y un PAT |
| ClickUp | ID de lista y token personal |
GitLab pide un host porque puede ser suyo
A diferencia de los otros, GitLab suele estar autoalojado, por eso el host es un campo y no una constante. Pegue gitlab.com si esa es su instancia.
Azure DevOps tiene dos particularidades
El cuerpo es un documento JSON Patch, no un objeto, y el tipo de contenido debe ser application/json-patch+json - cualquier otro devuelve 415. El signo de dólar delante del tipo de elemento de trabajo en la URL es parte de la dirección, no un marcador que olvidamos rellenar.
ClickUp requiere el token sin prefijo
Sin Bearer delante. Un token precedido de esa palabra se rechaza con 401, igual que un token incorrecto.
Todas las marcas mencionadas pertenecen a sus respectivos propietarios. MousePlayer no mantiene ninguna relación comercial con estos proveedores.