Mon édition
Module supplémentaire Agents IA - avancé
Cet article décrit une ancienne fonctionnalité et ne doit être utilisée que par les clients qui ont déjà installé le Widget de chat Ultimate et qui ont besoin d’informations sur sa maintenance. Les nouveaux clients devraient plutôt implémenter des agents IA pour la messagerie via le Web Widget.

En quelques minutes, vous pouvez disposer du Widget de chat Ultimate sur votre site Web. Vous pourrez fournir une assistance clientèle de qualité en un rien de temps ! Le widget est extrêmement personnalisable pour donner un aspect unique à votre marque. Il est conçu pour des performances optimales : sa taille compacte ne ralentira pas les temps de chargement de vos pages.

Dans cet article :

  • Incorporation du widget
  • Chargement du widget
  • Capture des métadonnées
  • Historique de vos conversations
  • Internationalisation et localisation
  • Configuration des messages UltimateGPT
  • Notifications
  • Méthodes
  • Formulaires
  • Localisation
  • Confidentialité des données
  • QUESTIONS FRÉQUENTES

Plateformes prises en charge :

  • Bureau
  • Mobile (Web)

Types de contenu pris en charge :

  • Messages texte, formatage HTML compris
  • Messages UltimateGPT
  • Boutons
  • Fiches et carrousels
  • Liens
  • Prise en charge des images et des GIF

Remontées

  • Remontée par e-mail
  • Création de tickets (nécessite une intégration API simple)

Incorporation du widget

Pour ajouter le widget, incorporez le script dans votre site Web ou via un gestionnaire de balises.

N’oubliez pas de remplacer botID par votre identifiant unique d'agent IA. Trouvez votre ID de bot dans l’URL : https://dashboard.ultimate.ai/bot/{botID}/ ou https://dashboard.ultimate.ai/ultimategpt/{botID}.

Script d’incorporation - dans le fichier HTML

Le script doit être inséré avant de fermer la balise de corps : </body>

<script type="module"> import UltimateChat from 'https://widget.ultimate.ai/sdk/index.mjs'; const chat = UltimateChat.Initialize({ botId: 'YOUR_BOT_ID_HERE', theme: {

'actions-hover': '#4A48B0',

'actions': '#5D5ADC',

'header-text': '#ECECF9',

'chat-button': '#15142d',

'chat-border-radius': 12px,

'header': '#000'

}, navbar: { avatarUrl: 'https://www.ultimate.ai/hubfs/raw_assets/public/ultimate/favicon/apple-touch-icon-152x152.png', title: 'Ultimate.ai', subtitle: 'Our bot will reply instantly', longSubtitle: 'I\'m an AI agent and here to answer your questions.' }, recoverConversation: true, metadata: [ { key: 'name', value: 'John Doe' }, { key: 'email', value: 'john@ultimate.ai', sanitize: true } ] }); </script>

Script d’incorporation - Gestionnaire de balises (GTM ou services similaires) 

<script> function _onUltimateChatLoad() { var chat = UltimateChat.Initialize({ botId: 'YOUR_BOT_ID', theme: {

'actions-hover': '#4A48B0',

'actions': '#5D5ADC',

'header-text': '#ECECF9',

'chat-button': '#15142d',

'chat-border-radius': 12px,

'header': '#000'

}, navbar: { avatarUrl: 'https://www.ultimate.ai/hubfs/raw_assets/public/ultimate/favicon/apple-touch-icon-152x152.png', title: 'Ultimate.ai', subtitle: 'Our bot will reply instantly', longSubtitle: "I'm an AI agent and here to answer your questions." }, recoverConversation: true, metadata: [ { key: 'name', value: 'John Doe' }, { key: 'email', value: 'john@ultimate.ai', sanitize: true } ] }); } </script> <script> (function () { var s = document.createElement('script'); s.type = 'text/javascript'; s.async = true; s.src = 'https://widget.ultimate.ai/sdk/index.iife.js'; s.onload = _onUltimateChatLoad; var x = document.getElementsByTagName('script')[0]; x.parentNode.insertBefore(s, x); })(); </script>

Personnalisations de style

Dans le script du widget, vous disposez de plusieurs options de couleurs que vous pouvez adapter au thème du widget.

theme: { 
'actions-hover': '#4A48B0', 
'actions': '#5D5ADC', 
'header-text': '#ECECF9', 
'chat-button': '#15142d', 
'chat-border-radius': 12px, 
'header': '#000' 
},

Spécifications des ressources :

Avatar - 172x172 px

Chargement du widget

Ouvrir au chargement

Cette option de configuration contrôle le comportement du widget au chargement. Lorsqu'il est configuré sur true, le widget s’ouvre automatiquement dès qu’il est entièrement chargé. Par défaut, cette option est configurée sur false ce qui signifie que le widget de chat reste fermé jusqu’à ce que l’utilisateur l’ouvre manuellement.

L’ouverture du widget est uniquement possible en utilisant le programme (consultez Méthodes -Ouvrir le widget) ou via l'option de configuration openOnLoad. Par défaut, cette option est configurée sur false.

 

Bouton Afficher/Masquer le widget

Cette option de configuration contrôle la visibilité du bouton de bienvenue du widget. Lorsqu'il est configuré sur true, le bouton ne s’affiche pas du tout, c'est-à-dire pas au chargement initial ni après la fermeture du widget.

 

Position du chat

Cette configuration vous permet de contrôler l’endroit de l'écran où vous voulez afficher le widget de chat. Vous pouvez le définir sur Bottom-right ou Bottom-left en fonction de l’endroit où il est le mieux adapté à votre marque. Sinon, le widget affichera par défaut Bottom-right.

Capture des métadonnées

Les métadonnées sont des données qui fournissent un contexte supplémentaire pour l’agent IA. Les métadonnées peuvent être utilisées pour enrichir un chat en fournissant des informations supplémentaires sur le client, son comportement et ses interactions précédentes avec l’entreprise.

En exploitant les métadonnées, les agents IA peuvent fournir une expérience plus personnalisée et plus efficace pour les clients, ce qui peut accroître la satisfaction et la fidélité de ces derniers. En outre, les métadonnées peuvent aider les Support Teams à analyser et améliorer leurs processus d’assistance au fil du temps.

Un site Web peut configurer et mettre à jour les métadonnées disponibles pendant la conversation à tout moment.

Pour ce faire, vous devez ajouter au code du widget les valeurs que vous souhaitez recueillir.

Nous pouvons vous conseiller sur la façon d’adapter le code du widget si vous souhaitez utiliser cette fonctionnalité.

Exemples d’utilisation :

Informations sur les clients : Les métadonnées peuvent fournir des informations sur le client, par exemple son nom, son adresse e-mail, son numéro de téléphone, son emplacement géographique et d’autres détails. Ces informations peuvent aider l’agent IA à personnaliser la conversation et à fournir une assistance plus pertinente.

Historique d’achats : Si le client a déjà effectué des achats auprès de l’entreprise, les métadonnées peuvent fournir des informations sur son historique d’achats, comme les produits qu’il a achetés, la date d’achat et le prix payé. Ces informations peuvent aider l’agent IA à comprendre les besoins du client et à fournir une assistance ciblée.

Historique des interactions : Les métadonnées peuvent aussi fournir des informations au sujet des interactions précédentes du client avec l’entreprise, par exemple ses chats, ses e-mails ou ses appels téléphoniques précédents. Ces informations peuvent aider l’agent IA à comprendre le contexte de la conversation en cours et à fournir une expérience plus fluide au client.

Informations sur l'appareil : Les métadonnées peuvent fournir des informations sur l’appareil qu’utilise le client pour chatter, par exemple le type d’appareil, le système d’exploitation et le navigateur. Ces informations peuvent aider l’agent IA à résoudre les problèmes techniques et fournir une assistance plus ciblée.

Metadata

Pour fournir un contexte supplémentaire pour l’utilisation de l'agent IA :

setMetadata(Array<{
key: string;
value: string;
sanitize: boolean;
}> metadata)

Si sanitize est défini sur true, la valeur n’est pas disponible dans les journaux de conversation, elle s’affiche avec une balise

Exemple :

            setTimeout(() => {
                chat.setMetadata([
                    { key: 'orderName', value: 'Jane Doe' },
                    { key: 'orderEmail', value: 'jane@ultimate.ai', sanitize: true }
                ]);
            }, 2000);

Recueil automatique de métadonnées

Le Widget de chat Ultimate peut automatiquement recueillir les métadonnées ayant trait à l’appareil de l’utilisateur.

Configuration

Cette fonctionnalité est activée par défaut.

Vous pouvez la désactiver en configurant autoMetadataCollection sur false

Détails des métadonnées recueillies.

Cette fonctionnalité dépend de la configuration de l’appareil et ne nécessite pas de cookies ni d’adresse IP utilisateur pour fonctionner correctement.

Metadata Description
Langue {{systemLanguage}}

La langue par défaut d’un appareil utilisateur.

c.-à-d. : en-GB, en-US

Vous trouverez la liste complète des codes de langue ici.

(Utiliser la norme BCP 47)
Fuseau horaire {{systemTimezone}}

Le fuseau horaire/la région dans laquelle se trouve l’utilisateur.

c.-à-d. : Europe/Berlin,

Une liste complète des fuseaux horaires se trouve ici dans la colonne ID de la zone.
Type d’appareil {{deviceName}}

Le type d’appareil utilisé par un utilisateur. Les appareils que nous détectons sont les suivants :

Appareils mobiles : iPad, iPhone, Android, Windows Phone

Appareils de bureau : Mac, Windows, Linux

URL de départ

{{url}}

L’URL de la page où l’utilisateur a ouvert le widget.

c.-à-d. : https://www.google.com
Nom du navigateur {{browserName}}

Le nom du navigateur de l’utilisateur.

c.-à-d. : Chrome, Firefox, Opera, etc
Version de navigateur {{browserVersion}}

La version du navigateur de l’utilisateur.

c.-à-d. : 111, 113 etc

 

Historique de vos conversations

Chaque conversation avec le widget est stockée directement dans les journaux de conversation.

Pour des conversations fluides, nous vous conseillons d’activer l’historique des chats. Cela permet aux utilisateurs de reprendre là où ils s’étaient interrompus, même après avoir rechargé la page ou rouvert l’onglet de navigateur.

Pour ce faire, nous utilisons le stockage local du navigateur pour enregistrer l’ID de la conversation. Ainsi, nous pouvons récupérer les données de conversation chaque fois que nous en avons besoin.

Activation

Pour récupérer une conversation précédente, modifiez le paramètre recoverConversation sur true.

Désactivation

Quand vous désactivez l’historique des conversations (en modifiant le paramètre recoverConversation sur false), les lastReadMessageId_{botId} et platformConversationId_{botId} sont supprimés du stockage local du navigateur de l’utilisateur. Pour en savoir plus sur l’utilisation du stockage local, cliquez ici.

recoverConversation was previously named isConversationPersistanceEnabled

 

Configuration des messages UltimateGPT

Libellé de réponse IA

À partir de maintenant, chaque réponse générée par IA affichera un libellé au-dessus d'elle. Cela signifie que les utilisateurs peuvent facilement distinguer le contenu généré par IA des autres messages. Cela permet de rendre l’expérience utilisateur plus claire et plus informative, en tenant compte de la nature du contenu avec lequel il interagit.

Configuration :

Icône Afficher/Masquer les informations messageGeneratedAdditionalInfo (par défaut false)

Sources des messages

Chaque réponse générée par IA affichera désormais les sources des informations, ce qui vous permet de retrouver l'origine de la réponse. Non seulement, cette approche renforce la crédibilité des réponses fournies, mais permet aussi à l’utilisateur d’explorer le sujet plus en détail en mettant à disposition des références fiables.

Configuration :

Afficher / masquer les sources IA en utilisant le paramètre showLlmSources (par défaut true)

Notifications

Notifications visuelles

Ces notifications sont une représentation visuelle des messages entrants. Chaque fois que vous fermez ou réduisez le widget et qu’un nouveau message est reçu, une notification rouge indique le nombre de messages qui ont été reçus mais non ouverts. 

Notifications sonores

Les notifications sonores se servent d’alertes sonores qui améliorent l’attention de l’utilisateur et sont activées dans les conditions suivantes :
  1. Transfert à un agent : lorsqu’un agent se joint à une demande de transfert.
  2. Alerte en arrière-plan : quand un message arrive quand l’utilisateur consulte un autre onglet de navigateur.
  3. Alerte de widget réduit : lorsqu’un nouveau message arrive et que le widget est réduit.
Options de configuration
Activation/Désactivation de la notification sonore Les clients peuvent configurer l’état par défaut des notifications sonores en utilisant le mot-clé allowSoundNotifications dans le script du widget :
  • Pour activer les notifications sonores par défaut, configurez allowSoundNotifications sur true.
  • Pour désactiver la notification par défaut, configurez allowSoundNotifications sur false.
Une fois cette configuration effectuée, les utilisateurs peuvent toujours activer ou désactiver les notifications sonores manuellement selon leurs préférences.

Ouvrir/Fermer le widget

Vous pouvez facilement contrôler le widget à partir de n’importe quel emplacement de votre site Web à l’aide de commandes simples :

  • Pour afficher le widget openWidget()
  • Pour masquer le widget closeWidget()

Supprimer le widget

Exemple d’utilisation :

Fournissez l’accès au widget uniquement aux utilisateurs connectés et vérifiez que le widget est fermé une fois un utilisateur déconnecté.

Mise en œuvre :

Faire appel à une méthode destroy()

Comportement :

  • Supprime l’iframe du widget de chat du DOM (modèle d’objet de document)

  • Déconnecter la connexion WebSocket

 

Formulaires 

Les messages de formulaire sont un type de message structuré qui vous permet de capturer les données utilisateur dans une conversation en cours en affichant un formulaire qui peut contenir des saisies de texte ainsi que certaines listes déroulantes. 

Utilisation des formulaires avec les agents IA - avancé

Les formulaires sont un excellent moyen de recueillir des données client sans que l’agent IA ne pose plusieurs questions. On les utilise souvent avec les questions de sécurité, les questions d’identification ou les demandes de modification de données.

Pour créer un formulaire, accédez à Settings / Ultimate Chat Widget / Forms et créez un formulaire en fonction des instructions de la page.

Il est possible de créer des champs de formulaire comme :

  • Text
  • E-mail
  • Sélectionner

Une fois votre formulaire créé, accédez à votre dialogue respectif pour lequel vous souhaitez ajouter le formulaire et suivez les étapes ci-dessous. 

Étapes :

  1. Ajoutez un message agent IA avec le code raccourci pour capturer le formulaire et l’insérer. Sur l'illustration ci-dessous, nous ajoutons notre formulaire de lead_capture. Cependant, vous ajouterez le nom de votre formulaire entre template: et )) % dans le snippet ci-dessous.

    %((template: nameOfTemplate))%

  2. Ajoutez un bloc message visiteur (texte libre) juste après le message de agent IA . Cela permet de capturer les réponses de l'utilisateur.

  3. Ajoutez un autre bloc de message agent IA après le message du visiteur, avec une sorte de confirmation qu’il a rempli le formulaire, par exemple, un remerciement.

  4. Les réponses de l'utilisateur sont enregistrées dans les métadonnées. Si vous voulez les utiliser plus tard dans le chat, vous devrez les récupérer (c’est totalement facultatif). Pour ce faire, nous utilisons Actions.

Nettoyage des réponses des clients

Le nettoyage des réponses est quelque chose que vous voudrez faire si vous demandez des données ICP à vos clients. Vous connaissez déjà ce concept grâce aux entités de contenu. Par exemple, nous nettoyons par défaut les adresses e-mail et les numéros IBAN. Pour en savoir plus au sujet du nettoyage, consultez les articles ci-dessous.

Explications sur le traitement des données des Agents IA - avancé

Recette : Nettoyage des données à caractère personnel (ICP) avec les entités de contenu

Comment nettoyer les données de formulaire

En fonction de votre type d’utilisation des formulaires, vous devrez peut-être nettoyer les informations. C’est très simple. 

  1. Cliquez sur la barre bleue indiquant « si... » pour ouvrir le volet des détails.
  2. Cliquez sur la case « Nettoyer la réponse de l’utilisateur » pour que les informations soient masquées dans Agents IA - avancé.

Ainsi, quand vous consultez la conversation dans Agents IA - avancé, elle ressemblera à ce qui suit.

 

Localisation

Il est possible de modifier la langue du widget à l’exécution. Pour modifier la localisation de la méthode d’appel du widget : setLocale(<string>)

Valeur par défaut : en_US

Autres langues prises en charge : nl_NL

Tester la localisation

Utilisez le paramètre de test pour changer la langue du widget. https://widget.ultimate.ai/demo/?botId={Your.Bot.ID}&locale={Your.Locale}
C.-à-d. https://widget.ultimate.ai/demo/?botId=65da6df65ab8b465b87222586&locale=nl_NL

Exemple d’utilisation : Synchronisez la langue de l’interface du widget avec la langue du site Web. Appelez une méthode pour mettre à jour la langue du widget quand la langue du site Web change de langue.

Confidentialité des données

Notre widget est conforme SOC2 et RGPD

  • Vous ne pouvez pas utiliser les cookies.
  • Le stockage local est utilisé pour fournir la meilleure expérience conversationnelle.

URL de politique de confidentialité personnalisée

Il est possible d’ajouter vos propres termes de confidentialité, accessibles par le biais de notre widget, en les ajoutant à la barre de navigation.

privacyPolicyUrl: URL

C.-à-d. privacyPolicyUrl: https://www.ultimate.ai/security-privacy

Stockage local

Notre widget ne stocke pas de cookies sur l’appareil des utilisateurs, mais un stockage côté utilisateur est nécessaire pour la prise en charge des fonctionnalités du widget. Ils sont présentés ci-dessous :

Nom du paramètre Description
platformConversationId_{botId} Nous stockons l’ID de la conversation afin de rétablir la conversation au rechargement de la page. (il est possible de le désactiver - consultez cette section)
lastReadMessageId_{botId}

Nous stockons l’ID du dernier message lu de l’utilisateur. Plus tard, cela est utilisé pour calculer le compteur de notifications.

Questions fréquentes

  1. Dois-je me connecter à un CRM pour tester le widget ? Non, la connexion CRM n’est pas nécessaire. Vous pouvez l’implémenter sur un site Web de sandbox ou nous demander de vous fournir un environnement si ce n’est pas possible.
    Nous ajouterons notre widget à notre plateforme pour compléter la fonctionnalité d'agent IA. 

  2. Pouvons-nous savoir si les utilisateurs ont cliqué sur un lien ? Malheureusement, il est actuellement impossible d’effectuer le suivi des clics sur un lien. Nous évaluerons l’ajout de cette fonctionnalité ultérieurement.

  3. Le formatage HTML est-il disponible dans DLB ? Malheureusement pas dans l’immédiat. Vous pouvez essayer d’utiliser un éditeur en ligne, comme HTML5 Editor - Free Online Content Widget.

  4. Est-il possible d’avoir plusieurs conversations ? Cette fonctionnalité n'est pas prise en charge actuellement.

  5. Le Widget de chat Ultimate utilise-t-il des cookies ? Non, notre widget ne stocke pas de cookies sur l’appareil des utilisateurs. Consultez la section ci-dessus pour plus de détails sur les spécifications de stockage côté client.

Réalisé par Zendesk