Comment utiliser la fonction de messages dans le ChatBotKit Widget

Bienvenue dans notre guide complet sur l'utilisation de la fonctionnalité des messages dans le ChatBotKit AI Widget. Cette fonction permet d'ajouter des messages supplémentaires au début de la session de conversation afin de transmettre des informations contextuelles sur l'utilisateur. Par exemple, vous pourriez vouloir donner à votre robot des informations sur l'utilisateur, comme son nom ou même le type de problème qu'il rencontre.

Below, we will walk you through the process from creating a new website widget, to embedding it into your website, initializing the widget with some message. Let's get started!

Étape 1 : Créer un nouveau widget pour le site web

1. Naviguez vers Intégrations et cliquez sur le bouton Créer une intégration de widget.
2. Remplissez le nom et la description facultative.
3. Connectez-vous à un bot existant ou sélectionnez une histoire, un modèle, un ensemble de données et un ensemble de compétences.
4. Enregistrez l'intégration en cliquant sur le bouton Créer.

Étape 2 : Intégrer le widget dans votre site web

1. Cliquez sur le bouton Installer.
2. Copy the widget snippet (code).
3. Collez l'extrait sur votre site web.

Étape 3 : Initialiser le widget ChatBotKit avec des messages

Une fois le widget installé sur votre site web, vous pouvez l'initialiser avec des messages personnalisés. Cette opération peut être effectuée par programme à l'aide de la fonction chatbotkitWidget.instance objet.

Here's an example of initializing the widget with metadata:

chatbotkitWidget.instance.messages = [
  {type: 'user', text: 'My name is Bob!'}
  // other relevant messages
]

Dans l'exemple ci-dessus, nous ne créons qu'un seul message qui indique au robot que le nom de l'utilisateur actuel est Bob. Nous pouvons ajouter d'autres messages, mais attention, le widget ne peut initialiser les sessions de chat qu'avec la seule option utilisateur message type. This is done for security reasons.

You can also pass the messages right inside the properties when embedding the widget SDK. Here are two additional methods you can use for that:

Intégration via le SDK Widget

Avec cette méthode, nous transmettons un objet encodé JSON directement dans l'attribut de métadonnées du Widget SDK. L'information sera récupérée automatiquement et utilisée pour initialiser le widget.

<script src="https://static.chatbotkit.com/integrations/widget/v2.js" data-widget="{WIDGET_ID}" data-messages="[{&quot;type&quot;:&quot;user&quot;,&quot;text&quot;:&quot;My name is Bob!&quot;}]"></script>

Intégration via l'élément Widget

Avec cette méthode, nous passons un objet encodé JSON directement dans l'attribut meta de l'élément HTML Widget. Notez que nous incluons le SDK mais que nous initialisons le widget manuellement en utilisant le HTML.

<script src="https://static.chatbotkit.com/integrations/widget/v2.js"></script>
<chatbotkit-widget widget="{WIDGET_ID}" meta="[{&quot;type&quot;:&quot;user&quot;,&quot;text&quot;:&quot;My name is Bob!&quot;}]"/>

De la même manière, nous pouvons maintenant communiquer automatiquement au robot des informations supplémentaires qui peuvent s'avérer pertinentes dans la conversation.