Widget de site web

Le widget OneTwoAgent place un agent de support IA sur votre site web et dans votre application : chat et Voice dans la langue du client, captures d’écran et fichiers, et transfert à votre équipe dans la même boîte de réception. Vous l’adaptez à votre marque sans CSS.

Widget de support IA pour le SaaSPersonnalisation du widgetVoice dans le widgetCaptures d’écran et pièces jointes

Ce que couvre cet article

  • Ce que les clients peuvent faire dans le widget : chat, Voice, captures d’écran et fichiers, dans leur propre langue.
  • Comment personnaliser le design et le comportement du widget.
  • Comment installer le widget sur votre site web.
  • Comment appliquer des réglages de sécurité comme les domaines autorisés et les pages exclues.

Vous développez un SaaS ou une application avec authentification ?

Exécutez npx -y @onetwoagent/cli@latest init --browser dans votre projet, puis demandez à votre agent de code "Integrate OneTwoAgent". Consultez Connecter OneTwoAgent à votre application pour reconnaître les clients connectés et donner à l’agent des données de compte en direct depuis votre backend.

Ce que les clients peuvent faire dans le widget

L’agent de support IA répond à chaque conversation du widget à partir de votre base de connaissances. Pour les clients connectés, il utilise aussi les données de compte autorisées par votre backend.

  • Discuter dans leur propre langue : l’agent répond dans la langue dans laquelle le client écrit.
  • Talk (Voice) : les clients peuvent parler à l’agent. La parole est détectée automatiquement et Voice répond à voix haute dans 40+ langues ; là où la réponse vocale n’est pas prise en charge, la conversation continue par écrit. Les minutes Voice sont fournies avec les forfaits payants.
  • Envoyer des captures d’écran et des fichiers : images, captures d’écran et photos, ainsi que des fichiers PDF, DOC, DOCX et TXT jusqu’à 8 Mo. Les images sont lues par vision artificielle ; les documents PDF et Word sont analysés, tableaux compris.
  • Coller des liens : l’agent lit la page liée comme contexte pour cette conversation. Les liens des clients sont du contexte, pas vos connaissances approuvées.
  • Joindre une personne : quand l’agent ne peut pas vérifier une réponse, il transfère la conversation à votre équipe au lieu de deviner, et n’importe quel membre de l’équipe peut reprendre la main depuis la boîte de réception.
L’agent répond en espagnol à un client qui a écrit en espagnol
Le client écrit en espagnol ; l’agent répond en espagnol.

1. Ouvrir les réglages du Widget

Allez dans Channels -> Widget. Si le widget n’est pas encore activé, activez-le d’abord.

  • Aperçu en direct de Home, Chat et Talk, sur ordinateur et sur mobile.
  • Réglages de design et de comportement.
  • Code d’installation.

2. Personnaliser le widget

Adaptez le widget à votre produit sans écrire de CSS. Chaque modification apparaît dans l’aperçu en direct pendant que vous l’effectuez.

  • Surfaces : Home, Chat et Talk (Voice). Vous choisissez celle qui s’ouvre en premier.
  • Thème : clair ou sombre.
  • Couleurs : en-tête, bulles de l’assistant et du client, fond du chat, champ de saisie, bouton d’envoi, lanceur, boutons et bouton de fermeture.
  • Typographie : 45 Google Fonts (sans serif, serif et à chasse fixe), réglables séparément pour l’en-tête, les messages de l’assistant, les messages du client, le champ de saisie et le lanceur, chacun avec sa propre taille.
  • Messages : 6 formes de bulles, applicables aux deux côtés si vous le souhaitez, et un choix d’icônes d’envoi.
  • En-tête : nom de l’assistant, ligne de statut et avatar ou logo facultatif.
  • Lanceur : 15 icônes, texte facultatif (icône seule sur mobile si vous préférez) et 13 animations du lanceur.
  • Écran d’accueil : titre, courte ligne au-dessus, bouton principal, jusqu’à 3 liens, orbe animé et styles d’arrière-plan comme maillage, halo, rayons, lueur, étoiles, points, grain et trame, avec réglages de teinte, d’intensité et de mouvement.
  • Talk : voix, message de bienvenue parlé et texture de l’orbe.
  • Textes et comportement : message de bienvenue, texte indicatif du champ de saisie, envoi de fichiers activé ou désactivé, mode compact, domaines autorisés et pages autorisées ou exclues.
Notes
  • Restez simple : les couleurs de votre marque, un nom clair et un court message de bienvenue fonctionnent généralement le mieux.
  • Tous les réglages en détail : Personnaliser le widget.

3. Installer le widget sur votre site web

Installation standard (recommandée).

  1. 1Copiez le script du widget depuis Channels -> Widget -> Install code
  2. 2Ajoutez-le à votre site pour qu’il se charge sur chaque page.
  3. 3Meilleur emplacement : dans <head>, avant </head>.
  4. 4Si <head> n’est pas disponible, placez-le avant </body> (cela fonctionne, mais peut charger un peu plus lentement).
Notes
  • Après installation et publication, le widget doit apparaître sur votre site en production.

4. Installer sur les plateformes courantes

  • Shopify : Online Store>Themes>Edit code -> layout/theme.liquid -> collez avant </head> -> Save
  • Wix Option A : Settings -> Custom Code -> Add New Tool -> collez le code -> Load on all pages -> placez-le dans Head -> Save et publiez.
  • Wix Option B : ajoutez le script via la zone globale de scripts/plugins du site et vérifiez qu’il se charge sur toutes les pages.
  • Webflow : Project Settings>Custom Code>collez dans Head Code -> Save et publiez.
  • WordPress : utilisez un plugin de scripts header (section Header) ou collez-le dans header.php avant </head>.
  • Sites codés sur mesure : placez le script dans le template HTML global à l’intérieur de <head> ou avant </body>.

Ou envoyez ceci à votre développeur

5. Réglages de sécurité et de contrôle

Réglages recommandés pour un comportement plus sûr et plus propre.

  • Domaines autorisés : évitez que le code du widget soit réutilisé sur des sites non liés.
  • Exemples de domaines : yourdomain.com, www.yourdomain.com, shop.yourdomain.com.
  • Pages exclues : masquez le widget là où il n’est pas pertinent.
  • Exclusions courantes : checkout, confirmation de commande, compte/login, confidentialité et pages techniques.
  • Exemples de chemins : /checkout, /account, /thank-you.
Notes
  • Commencez simplement : activez le widget partout puis excluez seulement les pages que vous ne voulez vraiment pas.

6. Comment fonctionnent les conversations du widget

  • Chaque conversation du widget apparaît dans Conversations, dans la même boîte de réception que WhatsApp, Instagram et Telegram.
  • L’agent de support IA répond à partir de votre base de connaissances et, pour les clients connectés, des données de compte autorisées, dans la langue du client.
  • N’importe quel membre de l’équipe peut reprendre la main et répondre directement. Tant qu’un membre de l’équipe gère la conversation, l’IA reste silencieuse ; cliquez sur Resume AI pour la lui rendre.
  • Dans le widget, le client voit "{name} joined the conversation" quand un membre de l’équipe répond, et "Assistant resumed" quand l’IA répond de nouveau.

Dépannage

  • Le widget ne s’affiche pas : confirmez que le script est sur le site en production (pas seulement en prévisualisation), publiez les changements et vérifiez les domaines autorisés si cette option est activée.
  • Le widget apparaît seulement sur certaines pages : vérifiez les règles de pages exclues et confirmez que le script est installé globalement.
  • Les messages n’arrivent pas : vérifiez qu’il s’agit du bon compte business OneTwoAgent et que le widget est activé dans Channels -> Widget.

Guides associés

Poursuivez avec les prochaines étapes de configuration autour des canaux, des réservations, du planning ou de l’automatisation.

Questions fréquentes

Puis-je installer le widget sans intégration personnalisée complète ?

Oui. La configuration normale consiste en un seul script de widget sur votre site, plus les réglages de design et de comportement dans le tableau de bord.

Le widget fonctionne-t-il sur mobile aussi bien que sur desktop ?

Oui. Le widget est conçu pour les visiteurs desktop et mobile, avec les conversations dans la même boîte de réception.

Dans quelles langues le widget répond-il ?

Dans la langue du client. L’agent répond dans la langue dans laquelle le client écrit. Avec Voice, la parole est détectée automatiquement et Voice répond à voix haute dans 40+ langues ; là où la réponse vocale n’est pas prise en charge, la conversation continue par écrit. Les 10 langues du tableau de bord ne définissent que l’interface de votre équipe.

Les clients peuvent-ils envoyer des captures d’écran ou des fichiers ?

Oui. Les clients peuvent joindre des images, des captures d’écran et des photos, ainsi que des fichiers PDF, DOC, DOCX et TXT jusqu’à 8 Mo. L’agent les lit et répond à partir de leur contenu. Vous pouvez désactiver l’envoi de fichiers dans les réglages du Widget.

Comment reconnaître les clients connectés et conserver leur historique de conversation d’une visite à l’autre ?

Consultez Connecter OneTwoAgent à votre application. Ce guide couvre la CLI OneTwoAgent, l’intégration via un agent de code et l’intégration manuelle côté serveur pour les applications dotées de leur propre système de connexion.

Besoin d’aide

support@onetwoagent.com