betool betool

Documentation

Chat widget web

Widget de chat embarquable sur n'importe quel site, en script JS unique.

Chat widget web

Le chat widget est un script JS que vous embarquez sur votre site (marketing, support, app). Il ouvre une bulle de conversation animée par un de vos pipelines betool.

Caractéristiques

  • Une ligne de script à coller dans votre <head>. Aucune dépendance npm.
  • Token public — révocable à tout moment côté admin. Pas de secret côté client.
  • Conversations persistantes — l'utilisateur retrouve son contexte entre les visites.
  • Multi-pipelines — un même site peut servir plusieurs widgets (pré-vente, support, doc).

Mise en place

  1. Administration → Chat widgets → Nouveau widget.
  2. Donnez un nom, choisissez le pipeline cible.
  3. Copiez le snippet généré :
<script
  src="https://platform.betoolia.com/widget/v1/widget.js"
  async
></script>
<script>
  window.addEventListener('load', () => {
    window.BetoolChat.init({
      token: 'pub_wdg_xxxxxxxxxxxxxxxx',
    })
  })
</script>

Le widget apparaît en bas à droite par défaut.

Personnalisation

Depuis l'admin du widget :

  • Apparence — couleur d'accent, position, libellés.
  • Comportement — ouverture automatique après X secondes, message d'accueil.
  • Périmètre — restreindre les domaines autorisés (CORS).

Sécurité

Le token est public par design : il scope un seul widget. Si quelqu'un l'utilise depuis un domaine non autorisé, la requête est refusée côté serveur. Pour révoquer un widget compromis : Administration → Chat widgets → Révoquer.

Limites

  • Pas (encore) de co-browsing (l'agent ne voit pas la page de l'utilisateur).
  • Le widget ne gère pas l'envoi de pièces jointes lourdes (>10 Mo). Pour ça, utilisez un pipeline email.