betool betool

Documentazione

Widget chat web

Widget chat integrabile in qualsiasi sito web con un unico script JS.

Widget chat web

Il widget chat è uno script JS che integri nel tuo sito web (marketing, supporto, app). Apre una bolla di conversazione alimentata da una delle tue pipeline betool.

Funzionalità

  • Un unico tag script da incollare nel tuo <head>. Nessuna dipendenza npm.
  • Token pubblico — revocabile in qualsiasi momento dal pannello di amministrazione. Nessun segreto lato client.
  • Conversazioni persistenti — gli utenti riprendono da dove avevano lasciato tra una visita e l'altra.
  • Multi-pipeline — un sito può servire più widget (pre-vendita, supporto, documentazione).

Configurazione

  1. Amministrazione → Widget chat → Nuovo widget.
  2. Assegna un nome e scegli la pipeline di destinazione.
  3. Copia lo snippet generato:
<script
  src="https://platform.betool.ai/widget/v1/widget.js"
  async
></script>
<script>
  window.addEventListener('load', () => {
    window.BetoolChat.init({
      token: 'pub_wdg_xxxxxxxxxxxxxxxx',
    })
  })
</script>

Il widget appare nell'angolo in basso a destra per impostazione predefinita.

Personalizzazione

Dal pannello di amministrazione del widget:

  • Aspetto — colore d'accento, posizione, etichette.
  • Comportamento — apertura automatica dopo X secondi, messaggio di benvenuto.
  • Ambito — limita i domini consentiti (CORS).

Sicurezza

Il token è pubblico per progettazione: definisce l'ambito di un singolo widget. Se qualcuno lo usa da un dominio non autorizzato, la richiesta viene rifiutata lato server. Per revocare un widget compromesso: Amministrazione → Widget chat → Revoca.

Limitazioni

  • Nessun co-browsing ancora (l'agent non può vedere la pagina dell'utente).
  • Il widget non gestisce allegati di grandi dimensioni (>10 MB). Per questo, usa una pipeline email.