Come creare campi personalizzati dalla chat in diretta

In questa guida rapida imparerai come creare campi personalizzati nell'app Callbell utilizzando le informazioni inviate tramite la nostra chat in diretta.

Step 1: Genera il frammento di codice della chat in diretta

Dopo aver creato un'integrazione di chat in diretta e personalizzarla secondo le tue preferenze, vai alla seconda sezione della pagina di configurazione del widget. Lì vedrai un frammento di codice che è stato generato per essere copiato e incollato nel tuo sito web al fine di far funzionare la chat in diretta.

Step 2: Modifica il frammento di codice

Nel nostro caso, ciò che vogliamo fare è inviare informazioni dal nostro sito web all'app Callbell ogni volta che un utente inizia a interagire con la chat. Possiamo farlo apportando semplicemente alcune piccole modifiche al frammento di codice generato sopra. Vedi l'esempio qui sotto:

<script>
  if (!window.callbellSettings) {
    window.callbellSettings = {}
  }
  window.callbellSettings["uuid"] = "000000-0000-abcd-1234-0000000000";
  window.callbellSettings["script_token"] = "script_token";
  window.callbellSettings["extra_params"] = {
    "identifier": '12345567',
    "course": "Scienze informatiche",
    "semestre": "4°"
  }
</script>
<script>
  (function(){var ...);
</script>

In questo esempio, i campi extra sono codificati rigorosamente, ma possono essere informazioni inviate dal tuo backend.

info

Nota che il campo identifier è obbligatorio. Se non viene inviato, l'utente potrà comunque interagire con la chat e inviare e ricevere messaggi, ma non verrà creato alcun campo personalizzato. L'identificatore viene salvato sul contatto come campo personalizzato, come tutte le altre chiavi di extra_params. Non identifica l'utente né la conversazione: il webchat riconosce un utente che torna tramite il proprio cookie di sessione, quindi inviare lo stesso identifier da un altro browser non riapre la stessa conversazione.

info

È possibile inviare un massimo di 20 campi extra per creare campi personalizzati nell'app Callbell.

Esempio

Nell'esempio qui sotto, stiamo generando un UUID casuale come identificatore e ottenendo la lingua del browser.

<script>
  if (!window.callbellSettings) {
    window.callbellSettings = {}
  }
  window.callbellSettings["uuid"] = "000000-0000-abcd-1234-0000000000";
  window.callbellSettings["script_token"] = "script_token";
  window.callbellSettings["extra_params"] = {
    identifier: self.crypto.randomUUID(),
    language: navigator.language,
  }
</script>
<script>
  (function(){var ...);
</script>

E così verrà mostrato nell'app Callbell.