Assistenza

Un visitatore ha un problema e lo scrive dal sito, con il bottone Serve aiuto?. La richiesta arriva nella pagina Assistenza, legata al progetto di quel sito. Non è un ticket: è una richiesta da leggere. Decidi tu se diventa un ticket, se va su un ticket che esiste già o se va scartata.

Accendere l'Assistenza

L'Assistenza è spenta finché non la accendi, progetto per progetto. Un progetto spento rifiuta ogni richiesta.

1. Apri le Impostazioni del progetto e accendi Ricevi le richieste di assistenza dai siti.
2. Nel progetto compare la scheda Assistenza. Lì trovi i passi, il codice pronto per il sito e un testo da dare a un assistente che scrive codice.
3. Scrivi una richiesta di prova dal sito: compare entro pochi secondi.

Scrivono solo i siti che il progetto ammette: è lo stesso elenco usato per gli errori, Origini consentite nelle impostazioni del progetto.

Aggiungere il bottone al sito

Il bottone è un file a parte del pacchetto JavaScript: chi non lo usa non scarica niente in più. Basta una riga nella pagina:

<script
  src="https://cdn.jsdelivr.net/npm/@bussolabs/[email protected]/dist/helpdesk.min.js"
  data-endpoint="https://bugs.example.com"
  data-project-id="<id del progetto>"
  data-public-key="<chiave pubblica del progetto>"
  defer
></script>

• data-endpoint è l'indirizzo della tua installazione di CloseYourIt.
• La chiave pubblica non è segreta: può stare nel codice della pagina.
• data-lang sceglie la lingua dei testi, it o en. Senza, vale la lingua della pagina; se non è italiano, l'inglese.
• data-position="left" sposta il bottone a sinistra. Di base sta a destra, in basso.

Con un bundler:

import { mountHelpdesk } from "@bussolabs/closeyourit-js/helpdesk"

const remove = mountHelpdesk({
  endpointUrl: "https://bugs.example.com",
  projectId: "<id del progetto>",
  publicKey: "<chiave pubblica del progetto>",
  lang: "it",
  position: "left",
})

mountHelpdesk restituisce la funzione che toglie il bottone. Il modulo ha i suoi stili isolati: quelli della pagina non lo toccano e i suoi non escono. Il messaggio arriva fino a 4.000 caratteri; l'email è facoltativa.

Per le altre opzioni dell'SDK vedi JavaScript.

Cosa arriva con la richiesta

• Il messaggio, la pagina da cui è stato scritto e il browser.
• L'email di chi scrive, solo se l'ha lasciata.
• La visita: è la stessa di errori e registrazioni delle sessioni. Nella richiesta, Errori nella stessa visita mostra gli errori successi a quella persona.

Nessuna email parte in automatico verso chi scrive.

Leggere e smistare

La pagina Assistenza si apre sulle richieste nuove. La vede solo chi ha il permesso Gestisci le richieste di assistenza sul progetto (vedi Permessi).

• Cerca nel testo e filtra per Progetto o per Stato.
• Un clic sulla riga apre il messaggio intero e i dettagli.
• Trasforma in ticket apre una bozza con il testo di chi ha scritto. Il ticket nasce a tuo nome, senza l'email del visitatore.
• Se il problema ha già un ticket, cerca il ticket del progetto e premi Collega. Il ticket mostra quante richieste ha dietro. Scollega riporta la richiesta fra le nuove.
• Scarta toglie una richiesta dalle nuove: pubblicità, prove, doppioni. La ritrovi con il filtro Stato e la riporti indietro con Recupera.
• Con l'AI configurata, le richieste che dicono la stessa cosa compaiono come simili. Collega allo stesso ticket le unisce.

Rispondere

Scrivi nel riquadro Rispondi della richiesta e premi Invia la risposta. La risposta parte per email e resta nella conversazione. Se la persona risponde a quella email, la sua risposta non arriva in CloseYourIt.

Si può rispondere solo se chi ha scritto ha lasciato l'email.

I dati di chi scrive

• L'email è salvata cifrata e si cancella da sola dopo 180 giorni. Il messaggio resta.
• L'indirizzo di rete di chi scrive non viene salvato.