Strumenti di gestione ticket
Trasformi una sessione in un ticket mentre la guarda: un pulsante nel lettore, la descrizione con parole sue e il link di riproduzione già incluso.
1. Perché questo connettore è manuale
Tutti gli altri connettori MousePlayer si attivano da soli. Questo no, ed è una scelta voluta.
Un ticket è lavoro per una persona. Aprirne uno a ogni clic di rabbia riempirebbe la bacheca di elementi non esaminati: entro una settimana il team li filtrerebbe e sparirebbero anche i problemi reali.
L’attivatore è quindi lei. Guarda una sessione, vede il problema, preme il pulsante e descrive ciò che ha visto. Il link è già nella descrizione; lei apporta il giudizio.
Il pulsante compare solo per proprietari e amministratori, mai nella vista da link condiviso. Chi riceve una registrazione non deve poter aprire ticket nel suo sistema.
2. I cinque strumenti e cosa richiede ciascuno
| Dove arriva | Da fornire | |
|---|---|---|
| Jira | un ticket in un progetto | URL sito, e-mail account, token API, chiave progetto, tipo di ticket |
| Linear | un ticket in un team | chiave API, ID team |
| Asana | un’attività in un progetto | token di accesso personale, ID progetto |
| Trello | una scheda in un elenco | chiave, token, ID elenco |
| GitHub | un ticket in un repository | token di accesso personale, proprietario/repository |
Un riquadro, un fornitore selezionato alla volta. Aggiungerne un altro in seguito significa cambiare selezione, non migrare.
Dove trovare gli identificativi
L’ID team Linear e l’ID progetto Asana sono visibili nell’URL quando li apre nel browser. L’ID elenco Trello è il più difficile: aggiunga .json all’URL della bacheca e cerchi l’elenco. La chiave progetto Jira è il prefisso di ogni numero di ticket: ACME in ACME-1234.
3. Il link nel ticket viene costruito dal nostro server
La descrizione è sua. Il link invece viene assemblato da noi dalla sessione che stava effettivamente guardando e il modulo non può modificarlo.
Conta perché altre persone faranno clic sul ticket. Se il link arrivasse dal browser, una richiesta manipolata potrebbe presentare al team qualsiasi indirizzo dentro qualcosa che sembra provenire dai suoi strumenti.
HTTP 200 non significa che il ticket esista
Linear risponde via GraphQL e GraphQL restituisce 200 OK con un array errors quando rifiuta. Un connettore che guardasse solo lo stato segnalerebbe successo per un ticket mai creato. Leggiamo il corpo.
Se lo strumento restituisce l’identificativo del ticket, lo mostriamo nella conferma: può verificarne l’esistenza invece di fidarsi di un messaggio verde.
4. Cosa volutamente non c’è
Nessun ticket automatico
Come spiegato sopra, per automatizzare il connettore webhook può inviare segnali di frustrazione a Zapier o Make, dove decide cosa merita un ticket.
Nessuna sincronizzazione bidirezionale
Chiudere il ticket non cambia nulla in MousePlayer e nulla in MousePlayer lo riapre. Una sincronizzazione parziale è peggio di nessuna, perché le persone iniziano a farci affidamento.
Nessun allegato
La registrazione resta e si guarda su MousePlayer. Esportare un video in uno strumento trasferirebbe dati personali in un sistema con regole di conservazione diverse da quelle concordate con i visitatori.
Il token è conservato cifrato con AES-256-GCM e mai più mostrato. Non entra nella coda interna: questa chiamata avviene mentre attende, direttamente dalla richiesta.
5. GitLab, Azure DevOps e ClickUp
Altri tre strumenti, stesso pulsante e stessa attivazione manuale.
| Da fornire | |
|---|---|
| GitLab | host, ID progetto e token: funziona anche la sua istanza GitLab |
| Azure DevOps | organizzazione, progetto, tipo di elemento di lavoro e PAT |
| ClickUp | ID elenco e token personale |
GitLab chiede l’host perché può essere suo
A differenza degli altri, GitLab è spesso ospitato autonomamente: l’host è quindi un campo, non una costante. Incolli gitlab.com se è lì che si trova la sua istanza.
Azure DevOps ha due particolarità
Il corpo è un documento JSON Patch anziché un oggetto e il tipo di contenuto deve essere application/json-patch+json - qualsiasi altro restituisce 415. Il simbolo del dollaro davanti al tipo di elemento di lavoro nell’URL fa parte dell’indirizzo, non è un segnaposto dimenticato.
ClickUp vuole il token senza prefisso
Nessun Bearer davanti. Un token preceduto da quella parola viene rifiutato con 401, proprio come un token errato.
Tutti i marchi citati appartengono ai rispettivi titolari. MousePlayer non ha rapporti commerciali con questi fornitori.