Aller au contenu principal

Widget de chat web

Le canal Web Chat ajoute une fenêtre de chat à votre site web. Les visiteurs cliquent sur le bouton de chat dans un coin de la page et vous écrivent. Leurs conversations arrivent dans la boîte de réception MonoChat comme celles de tout autre canal, où votre équipe, vos flux et vos agents IA leur répondent.

Connecter le canal​

  1. Allez dans Paramètres › Discussion › Canaux et cliquez sur Connecter.
  2. Sélectionnez Web Chat.
  3. Renseignez les réglages ci-dessous et enregistrez. Chaque champ explique à quoi il sert, et la partie droite du formulaire affiche un aperçu de la fenêtre qui change au fil de vos modifications. Basculez l’aperçu entre le bouton de chat fermé, la fenêtre ouverte et un exemple de conversation.
  4. Copiez l’extrait de code affiché par le canal et ajoutez-le à votre site (voir Installer l’extrait).

Vous pouvez connecter plusieurs canaux Web Chat, par exemple un par site web.

Réglages​

RéglageEffet
Nom du canalLe nom du canal dans MonoChat. La fenêtre l’affiche comme en-tête quand le Titre du widget est vide.
Titre du widgetL’en-tête de la fenêtre de chat.
Sous-titreUne ligne sous le titre, par exemple votre délai de réponse habituel. Videz le champ pour masquer la ligne.
LogoUne image affichée à côté du titre : un fichier PNG, JPEG, GIF, SVG ou WebP.
CouleurLa couleur du bouton de chat, de l’en-tête et des messages du visiteur. Le texte posé dessus passe en noir ou en blanc pour rester lisible.
PositionEn bas à droite ou en bas à gauche de la page.
Pièces jointesPermet aux visiteurs d’envoyer des images, des vidéos, des fichiers audio et des documents jusqu’à 10 Mo.
Bouton emojiAffiche à côté de la zone de message un bouton qui propose les emojis les plus courants. Activé par défaut.
Masquer le lanceurMasque le bouton de chat ; vous ouvrez alors la fenêtre depuis votre propre bouton avec l’API JavaScript.
Affichage mobileLa façon dont la fenêtre s’ouvre sur les téléphones : Plein écran ou Compact, un panneau sur les trois quarts inférieurs de la page.
Domaines autorisésLes sites sur lesquels la fenêtre peut apparaître : un hôte exact (www.example.com) ou tous les sous-domaines (*.example.com), avec un port facultatif (localhost:3000). Laissé vide, tout site peut l’afficher.

Langues​

Les boutons et les libellés de la fenêtre suivent la langue du navigateur du visiteur, et s’affichent en anglais quand MonoChat ne dispose pas de cette langue.

Le Titre du widget, le Sous-titre, l’Introduction du formulaire et le Texte du consentement ont une version pour chaque langue de votre espace de travail ; ces langues se définissent dans Paramètres › CRM › Langues (voir Paramètres de langue). Cliquez sur le champ pour rédiger chaque version. La fenêtre affiche la version dans la langue du navigateur du visiteur, ou celle de votre langue par défaut quand cette langue n’en a pas.

Pour afficher la fenêtre dans une seule langue quel que soit le navigateur, appelez MonoChat('setLocale', 'tr-TR') depuis l’API JavaScript.

Formulaire avant la discussion​

Lorsque le formulaire est désactivé, les visiteurs écrivent tout de suite. Pour leur demander une adresse e-mail ou un numéro de téléphone, utilisez un flux (voir Les flux et le widget).

Lorsque le formulaire est activé, la fenêtre demande ces informations avant le premier message :

ChampOptions
NomDésactivé, facultatif ou obligatoire
E-mailDésactivé, facultatif ou obligatoire
TéléphoneDésactivé, facultatif ou obligatoire

Vous pouvez aussi rédiger le texte affiché au-dessus des champs et ajouter une case de consentement avec votre propre texte et un lien vers votre politique de confidentialité. Lorsque cette case est activée, les visiteurs doivent la cocher pour commencer la discussion. Le nom, l’adresse e-mail et le numéro de téléphone sont enregistrés dans le profil du client.

Installer l’extrait​

Le canal affiche un extrait de code dans lequel l’adresse du widget et la clé du canal sont déjà renseignées, juste après sa connexion et sous l’aperçu lorsque vous modifiez le canal. Collez-le avant la balise de fermeture </body> de chaque page qui doit afficher le chat :

<script>
window.MonoChat = window.MonoChat || function () { (MonoChat.q = MonoChat.q || []).push(arguments) }
</script>
<script async src="https://<widget address from the channel>/static/loader.js?key=<channel key>"></script>

La fenêtre se charge après votre page et ne la ralentit donc pas.

Passer de l’ancien WebChat

Si votre site contient encore l’extrait d’un ancien canal WebChat, supprimez-le et collez à sa place l’extrait du nouveau canal Web Chat.

Mode pleine page​

Pour donner au chat une page entière, comme une page d’assistance, ajoutez &mode=fullpage à la deuxième balise de l’extrait :

<script async src="https://<widget address from the channel>/static/loader.js?key=<channel key>&mode=fullpage"></script>

La fenêtre occupe alors toute la page et reste ouverte, sans en-tête ni bouton de chat, et close et toggle n’ont aucun effet. Elle se charge avec la page plutôt qu’après, et le réglage Affichage mobile ne s’applique pas.

Google Tag Manager​

  1. Dans votre conteneur, ajoutez une balise Custom HTML et collez-y l’extrait tel quel.
  2. Choisissez le déclencheur All Pages, ou un déclencheur qui ne s’active que sur les pages qui doivent afficher le chat.
  3. Cliquez sur Submit, puis sur Publish.

Si les scripts de votre page appellent MonoChat, ils peuvent s’exécuter avant la balise. Gardez aussi le premier <script> de l’extrait sur la page, afin que leurs appels attendent la fenêtre.

Créateurs de sites et boutiques en ligne​

Si vous ne pouvez pas modifier le code de votre site, collez l’extrait tel quel dans le champ que votre plateforme propose pour ajouter du code à toutes les pages, en fin de page ou dans le pied de page :

PlateformeOù placer l’extrait
WordPressInstallez l’extension WPCode et collez l’extrait dans son champ Footer. Sur WordPress.com, la possibilité d’ajouter du code dépend de votre forfait.
ShopifyOnline Store › Edit code : ouvrez theme.liquid et collez l’extrait juste avant </body>.
WixSettings › Custom Code › Add Custom Code : choisissez toutes les pages et Body – end. Le site doit être publié et avoir un domaine connecté.
SquarespaceLe champ Footer de Code Injection, avec les forfaits Core, Plus et Advanced.
WebflowSite settings › Custom code › Footer code, puis publiez le site.
ikasSales Channel › Extensions › Scripts › Add Script : collez l’extrait comme contenu du script, enregistrez et vérifiez que le script est activé.

API JavaScript​

L’extrait définit une fonction MonoChat sur votre page. Appelez-la depuis vos propres scripts, liens et boutons pour piloter la fenêtre. Les appels effectués avant le chargement de la fenêtre attendent qu’elle soit prête : vous pouvez donc les faire juste après l’extrait.

Commandes​

AppelEffet
MonoChat('open')Ouvre la fenêtre.
MonoChat('close')Ferme la fenêtre.
MonoChat('toggle')Ouvre la fenêtre si elle est fermée, la ferme si elle est ouverte.
MonoChat('hideLauncher')Masque le bouton de chat. La fenêtre s’ouvre toujours avec open et toggle.
MonoChat('showLauncher')Affiche de nouveau le bouton de chat.
MonoChat('setUser', { name, email, phone })Transmet ce que vous savez déjà du visiteur. Voir Visiteurs connectés.
MonoChat('setLocale', 'tr-TR')Affiche la fenêtre dans cette langue, quelle que soit la langue du navigateur. Voir Langues.
MonoChat('on', event, callback)Appelle callback chaque fois que event se produit. Voir Événements.

Événements​

ÉvénementQuandcallback reçoit
readyLa fenêtre est chargée.Rien
openLa fenêtre s’ouvre, depuis le bouton de chat ou par un appel.Rien
closeLa fenêtre se ferme.Rien
unreadLe nombre de réponses non lues change : une réponse arrive alors que la fenêtre est fermée, ou le visiteur l’ouvre.Le nombre de réponses non lues

Enregistrez vos callbacks juste après l’extrait pour ne pas manquer ready.

Visiteurs connectés​

Lorsque le visiteur est connecté à votre site, transmettez ses informations avec setUser. Chaque champ est facultatif, et la fenêtre ne lit que name, email et phone.

  • Le formulaire avant la discussion est prérempli avec ces informations. Il est ignoré lorsqu’il a tout ce qu’il demande, sauf si la case de consentement est activée : les visiteurs la cochent toujours eux-mêmes.
  • Elles sont enregistrées dans le profil du client dans MonoChat, pour que votre équipe voie qui écrit.
  • Si l’adresse e-mail ou le numéro de téléphone n’est pas valide, aucune de ces informations n’est enregistrée.

Exemples​

Ouvrir la fenêtre depuis votre propre bouton et masquer le bouton de chat :

<button onclick="MonoChat('open')">Discutez avec nous</button>
<script>
MonoChat('hideLauncher')
</script>

Transmettre un utilisateur connecté et afficher la fenêtre dans la langue de la page :

<script>
MonoChat('setUser', { name: 'Jane Doe', email: 'jane@example.com', phone: '+1 555 010 0000' })
MonoChat('setLocale', document.documentElement.lang)
</script>

Afficher le nombre de réponses non lues sur votre propre bouton :

<button onclick="MonoChat('open')">Assistance <span id="chat-unread"></span></button>
<script>
MonoChat('hideLauncher')
MonoChat('on', 'unread', function (count) {
document.getElementById('chat-unread').textContent = count || ''
})
</script>

Envoyer un événement à votre outil d’analyse lorsqu’un visiteur ouvre la fenêtre :

<script>
MonoChat('on', 'open', function () {
gtag('event', 'chat_opened')
})
</script>

Conversations​

Chaque visiteur est un client dans MonoChat, et sa conversation est conservée dans son navigateur : un visiteur qui revient avec le même navigateur voit les 200 derniers messages, pendant 90 jours après le dernier message. Un autre navigateur ou un autre appareil démarre une nouvelle conversation. Les réponses de votre équipe et l’indicateur de saisie apparaissent dans la fenêtre en temps réel.

Le bouton emoji à côté de la zone de message propose les emojis les plus courants. Les visiteurs peuvent aussi saisir n’importe quel emoji depuis leur clavier.

Les messages qu’envoie un visiteur affichent des coches, comme sur WhatsApp : une coche grise quand le message est envoyé, deux coches grises quand il est arrivé dans MonoChat, et deux coches bleues dès qu’un membre de votre équipe a ouvert la conversation. Dans MonoChat, vos réponses s’affichent comme distribuées quand la fenêtre du visiteur les reçoit, et comme lues quand le visiteur ouvre la fenêtre.

Quand la fenêtre est fermée, une nouvelle réponse affiche le nombre de messages non lus sur le bouton de chat et joue un son bref. Les navigateurs ne jouent le son qu’après que le visiteur a cliqué ou tapé quelque part sur la page.

Types de messages​

La fenêtre affiche les messages comme l’écran de discussion de MonoChat : le nom de l’agent au-dessus de ses réponses, une ligne avec la date là où commence un nouveau jour, et l’heure dans chaque bulle, avec les coches sur les messages du visiteur.

En plus du texte, des emojis et des fichiers, vos réponses peuvent utiliser les types ci-dessous. Envoyez-les depuis le nœud de flux Envoyer un message, les messages courts, les apps et les fonctions (voir Types de messages).

TypeAffichage dans la fenêtre
Image, vidéo, audio, stickerDans la bulle.
DocumentUne carte avec le type et le nom du fichier, qui télécharge le fichier.
Réponses rapidesDes boutons sous le dernier message. Un clic envoie le titre du bouton comme réponse du visiteur.
BoutonUn message avec un en-tête facultatif (un texte, une image, une vidéo ou un document), un pied de page et des boutons qui envoient une réponse, ouvrent une adresse web ou appellent un numéro de téléphone.
URL d'actionUn message avec un seul bouton qui ouvre une adresse web.
ListeLes lignes dans la bulle, regroupées par section. Un clic sur une ligne l’envoie comme réponse du visiteur.
CarrouselDes cartes que le visiteur fait défiler horizontalement, chacune avec une image ou une vidéo, un titre, un sous-titre et des boutons.
PositionUn repère avec le nom et l’adresse du lieu, qui ouvre le lieu dans Google Maps.
Demande de positionUn bouton Envoyer la position. Le navigateur demande l’autorisation au visiteur, puis sa position arrive dans MonoChat sous forme de message de position.
ContactsLe nom et l’entreprise de chaque contact, avec des liens qui appellent ses numéros de téléphone et écrivent à ses adresses e-mail.

Les réponses rapides, les boutons de réponse, les lignes de liste et la demande de position ne fonctionnent que sur le dernier message, pour que les visiteurs ne puissent pas répondre à une ancienne question.

Icônes des boutons​

Les boutons qui ouvrent une adresse web peuvent afficher une icône : choisissez-la dans le champ Icône d’un message URL d'action ou d’un bouton URL web. Ce champ n’apparaît que lorsque vous créez le message pour Web Chat : les autres canaux n’affichent pas d’icônes. Les icônes sont Lien, Site web, WhatsApp, Instagram, Messenger, Facebook, Telegram, TikTok, Téléphone, E-mail et Localisation ; un bouton sans icône affiche l’icône de lien.

Les flux et le widget​

Les messages de bienvenue, les horaires d’ouverture, les réponses hors horaires, la demande d’adresse e-mail ou de numéro de téléphone et les messages proactifs se configurent avec des flux, pas avec les réglages du canal.

L’événement Action client reçue démarre un flux depuis la fenêtre :

  • Widget de chat ouvert pour la première fois : le visiteur ouvre la fenêtre et n’a pas de conversation ouverte. MonoChat démarre la conversation, ou rouvre celle qui était fermée, pour que le flux puisse écrire au visiteur avant lui. Rouvrir la fenêtre pendant que la conversation est ouverte ne le déclenche pas à nouveau.
  • Widget de chat ouvert : le visiteur ouvre la fenêtre, à chaque fois, la première comprise. Un visiteur sans conversation ouverte en obtient une, comme ci-dessus.
  • Widget de chat fermé : le visiteur ferme la fenêtre pendant une conversation ouverte.

Lorsque le formulaire avant la discussion est activé, la fenêtre compte comme ouverte une fois que le visiteur a rempli le formulaire.

Afficher une page contenant le widget ne déclenche aucun d’eux. Un visiteur qui n’a pas écrit ne devient client dans MonoChat que si un flux écoute l’action.

En mode pleine page, la fenêtre s’ouvre avec la page, donc charger la page compte comme ouvrir la fenêtre. Chaque canal compte au plus 60 ouvertures de la fenêtre par minute, et les ouvertures suivantes ne démarrent aucun flux.

Pour accueillir les visiteurs, démarrez un flux avec Action client reçue réglé sur Widget de chat ouvert pour la première fois et ajoutez un nœud Envoyer un message avec votre message de bienvenue. Créez-le avec le constructeur de messages, avec des boutons de réponse, une liste ou des liens avec des icônes.

Powered by MonoChat​

La fenêtre affiche une petite ligne Powered by avec le logo MonoChat. Ce n’est pas un réglage du canal : elle ne peut être masquée que pour toute une installation MonoChat.