Ferramentas de seguimento de incidencias
Converta unha sesión nun tícket mentres a ve: un botón no reprodutor, as súas palabras na descrición e a ligazón da reprodución xa engadida.
1. Por que esta é manual
Todas as demais pontes de MousePlayer se activan soas. Esta non e ese é todo o deseño.
Un tícket é traballo para unha persoa. Se abrísemos un por cada clic de rabia, o panel encheríase de elementos sen clasificar e nunha semana o equipo filtraríaos, tamén os reais.
Por iso o activador é vostede. Ve unha sesión, detecta algo, preme o botón e escribe o que viu. A ligazón da gravación xa está na descrición; vostede achega o criterio.
O botón só aparece para propietarios e administradores, nunca nunha vista de ligazón compartida. Alguén a quen enviou unha gravación non debería poder abrir tíckets na súa ferramenta.
2. As cinco ferramentas e o que necesita cada unha
| Onde chega | O que proporciona | |
|---|---|---|
| Jira | unha incidencia nun proxecto | URL do sitio, correo da conta, token API, clave do proxecto e tipo de incidencia |
| Linear | unha incidencia nun equipo | clave API e ID do equipo |
| Asana | unha tarefa nun proxecto | token de acceso persoal e ID do proxecto |
| Trello | unha tarxeta nunha lista | clave, token e ID da lista |
| GitHub | unha incidencia nun repositorio | token de acceso persoal e owner/repo |
Unha tarxeta, un provedor seleccionado á vez. Engadir outra ferramenta despois é un cambio de selección, non unha migración.
De onde veñen os identificadores
O ID do equipo Linear e o ID do proxecto Asana son visibles no URL ao abrir o equipo ou proxecto nun navegador. O ID da lista Trello é o máis difícil dos cinco: engada .json ao URL do taboleiro e busque a lista desexada. A clave do proxecto Jira é o prefixo anterior a cada número de incidencia: ACME en ACME-1234.
3. O noso servidor constrúe a ligazón do tícket
A descrición que escribe é súa. A ligazón da reprodución non: constrúese no noso lado a partir da sesión que realmente vía e o formulario non pode influír nela.
Importa porque outras persoas premen o tícket. Se a ligazón viñese do navegador, unha petición manipulada podería poñer calquera enderezo diante do equipo dentro de algo que parece unha ferramenta propia.
HTTP 200 non significa que exista o tícket
Linear responde por GraphQL e GraphQL responde 200 OK cunha matriz errors cando rexeita. Unha ponte que só mirase o código de estado informaría de éxito para un tícket que nunca se creou. Lemos o corpo.
Se unha ferramenta devolve o identificador da nova incidencia, poñémolo na confirmación para que poida comprobar que existe en lugar de fiarse dunha mensaxe verde.
4. O que deliberadamente non hai
Sen tíckets automáticos
Vexa arriba. Se quere automatización, a ponte de webhook pode enviar sinais de frustración a Zapier ou Make e pode decidir alí o que merece un tícket.
Sen sincronización bidireccional
Pechar o tícket non cambia nada en MousePlayer e nada en MousePlayer o volve abrir. Unha sincronización que funciona nunha dirección e media é peor que ningunha porque a xente comeza a confiar nela.
Sen anexos
A gravación queda connosco e vese connosco. Exportar un vídeo a outra ferramenta levaría datos persoais a un sistema con regras de conservación distintas das acordadas cos visitantes.
O token gárdase cifrado con AES-256-GCM e nunca volve mostrarse. Tampouco se inclúe na cola interna: esta chamada ocorre mentres agarda, directamente desde a petición.
5. GitLab, Azure DevOps e ClickUp
Tres ferramentas máis, o mesmo botón e o mesmo activador manual.
| O que proporciona | |
|---|---|
| GitLab | host, ID do proxecto e un token; tamén funciona co seu propio GitLab |
| Azure DevOps | organización, proxecto, tipo de elemento de traballo e un PAT |
| ClickUp | ID da lista e un token persoal |
GitLab pide un host porque pode ser seu
A diferenza das demais, GitLab adoita estar aloxado por vostede, polo que o host é un campo, non unha constante. Pegue gitlab.com se está alí.
Azure DevOps ten dúas particularidades
O corpo é un documento JSON Patch, non un obxecto, e o tipo de contido debe ser application/json-patch+json pois calquera outro responde 415. O signo do dólar diante do tipo de elemento de traballo no URL forma parte do enderezo, non é un marcador que esquecemos cubrir.
ClickUp quere o token sen prefixo
Sen Bearer diante. Un token coa palabra engadida rexéitase con 401, o que parece exactamente un token incorrecto.
Todas as marcas mencionadas aquí pertencen aos seus respectivos propietarios. MousePlayer non ten relación comercial con estes provedores.