Comment construire facilement un Chatbot WhatsApp en utilisant Botpress v12 et Smooch
Un chatbot peut être une aide incroyablement utile pour votre entreprise et cet article vous donnera toutes les étapes dont vous avez besoin pour construire le vôtre. En utilisant Botpress v12 et Smooch (maintenant connu sous le nom de Sunshine Conversations par Zendesk), nous vous montrerons comment vous connecter à WhatsApp et construire un bot Q&A simple qui répond à une variété de questions.
Avant de construire le robot
Avant de commencer, vous devrez mettre en place et configurer plusieurs services - vous aurez besoin d'une adresse électronique professionnelle et d'au moins 64 Go d'espace sur votre disque dur.
Télécharger Botpress
Commencez par vous rendre sur la page de documentation deBotpress v12 et téléchargez la version de Botpress que vous préférez.
Créer un compte sur Smooch
Pendant le téléchargement de Botpress v12, rendez-vous sur la page d'inscription de Smooch/Sunshine Conversations. Une fois la procédure d'inscription terminée, vous devrez créer une application et lui donner un nom.
A ce stade, le téléchargement de Botpress devrait être terminé. Si vous avez téléchargé avec l'option "binaire", il vous suffit d'extraire le contenu du téléchargement dans un répertoire de votre choix.
Télécharger Ngrok
Le troisième service que nous utiliserons s'appelle Ngrok, que vous pouvez télécharger ici. Ngrok est un service gratuit que nous utiliserons pour partager sur le web le serveur Botpress qui tourne sur votre machine locale. Suivez les instructions du site pour le télécharger et l'installer. Vous êtes maintenant prêt à créer votre chatbot.
Configurer Botpress avec les clés API de Smooch
Pour démarrer votre chatbot, vous devez d'abord ouvrir le dossier dans lequel nous avons extrait Botpress v12 et exécuter le fichier 'bp'. Cela lancera le chatbot, qui nécessite le téléchargement de certains modules. Ce processus prend un peu de temps, mais il ne devrait être effectué qu'une seule fois, après quoi chaque lancement ultérieur sera plus rapide.
Pendant que l'application Botpress se configure, retournez à votre application sur Smooch et sélectionnez les paramètres. Vous devriez voir des options pour nommer votre robot, lui donner une image, des options de message, un identifiant d'application et des clés API. Lorsque vous voyez les clés API, vous devez créer une nouvelle clé API.
Créer et configurer votre robot
L'installation de Botpress v12 devrait être terminée au moment où vous générez la clé API sur Smooch. À ce stade, votre console vous aura indiqué où ouvrir le Studio Botpress - dans notre cas, il s'agissait de localhost:3000. Naviguez jusqu'à l'URL fournie dans la console et créez votre compte administrateur.
Comme c'est la première fois que vous utilisez Botpress, vous verrez que votre espace de travail ne contient aucun robot. Sélectionnez l'option de création d'un robot et donnez-lui un nom. Le champ "Bot ID" sera automatiquement rempli. Ensuite, sélectionnez un modèle de robot (tel que l'option 'Learn Botpress Basics').
Vous verrez que votre espace de travail a maintenant un robot ! Sélectionnez le robot (cliquez sur son nom). Une barre verticale, sur le côté gauche du Studio, devrait attirer votre attention. Les options présentées ici seront celles avec lesquelles vous travaillerez le plus pendant le développement de votre robot. Dans notre cas, nous commencerons par l'option de l'éditeur de code, qui ouvrira une série de répertoires dans le studio et nous amènera à l'étape suivante.
Sous Configurations dans l'éditeur de code, vous verrez deux dossiers. Pour l'instant, concentrez-vous sur le dossier Current bot.
Sélectionnez bot.config.json sous Configurations et faites défiler jusqu'à 'messaging'. C'est ici que vous pourrez ajouter un objet "channels", qui contiendra un objet "smooch". Dans Smooch, créez une valeur booléenne appelée "enabled" et donnez-lui la valeur true. Vous devrez ensuite créer des chaînes "keyId" et "secret" - qui prendront respectivement l'ID et le secret de la clé API que vous avez générée dans votre application Smooch.
Une fois cette tâche terminée, sauvegardez votre bot.config.json et naviguez dans le dossier Global sous Configurations pour ouvrir le fichier botpress.config.json. Cherchez "externalUrl", qui sera défini comme une chaîne vide. Il s'agit d'un service assez simple, il suffit donc de suivre les instructions sur le site pour exposer le port sur lequel le bot fonctionnera avec Ngrok. Après cela, retournez coller l'URL HTTPS dans la chaîne externalUrl.
Enregistrez le fichier, redémarrez le serveur et ouvrez à nouveau votre bot. Cliquez sur "Train Now" dans le coin inférieur droit. Vous devriez voir "Ready" à la place de "Train Now".
Parlez à votre robot
Retournez à l'application Smooch et vous devriez voir que les webhooks sont configurés automatiquement. Naviguez à nouveau vers les intégrations, sélectionnez WhatsApp et connectez-vous. Choisissez maintenant votre mode d'intégration - pour les besoins de ce guide, "Sandbox" conviendra parfaitement.
Sélectionnez "Activer le bac à sable" et suivez les instructions pour envoyer un message au numéro spécifié dans WhatsApp. Une fois que vous avez réussi à connecter votre Smooch Sandbox pour WhatsApp, vous devriez recevoir un message. Tout autre message sera transmis au webhook que vous avez créé.
Vous pourrez désormais parler avec votre robot !
Faites parler votre robot
Maintenant que nous avons un robot vierge et que nous avons reçu un message confirmant que nos intégrations fonctionnent correctement, commençons par la réponse initiale du robot après que nous ayons dit quelque chose.
Pour ce faire, naviguez vers Q&A dans le Studio Botpress , qui sera la quatrième option du menu latéral de gauche. Vous verrez une invite à ajouter une question en appuyant sur le signe plus dans la barre d'outils. Vous verrez apparaître un écran vous permettant de saisir le texte de la question et de la réponse. Dans notre cas, nous avons posé la question suivante : "Quel est votre fruit préféré ?". La réponse est : "Mon fruit préféré est la tomate, que la plupart des gens confondent avec un légume". Nous pouvons répéter ce processus plusieurs fois, en introduisant à chaque fois une nouvelle question et une nouvelle réponse.
Vous remarquerez qu'en haut à droite de chaque nouvelle question, il est indiqué "incomplet". Si vous survolez cette mention, elle vous indiquera que les questions et réponses n'utiliseront que des correspondances exactes. C'est parce que nous avons besoin d'ajouter plusieurs façons de poser la question afin d'activer et d'aider l'apprentissage automatique pour le robot. Allez-y et ajoutez plusieurs variantes de la question à la Q&R, plus vous en ajoutez, mieux c'est.
Enfin, nous pouvons avoir une conversation avec notre robot, lui poser des questions simples et obtenir une réponse. Cela devrait être assez simple, il suffit de lui poser l'une des questions que vous avez créées, et de recevoir une réponse ! Notez que, comme il s'agit d'une intégration assez simple, toute question inappropriée ou tout message en dehors des paramètres configurés pour ce robot sera simplement ignoré.
Conclusion
Dans ce guide, nous avons abordé la question de l'inscription aux services dont vous avez besoin pour réussir à créer un chatbot avec Botpress v12. Il s'agit de Smooch, Ngrok et Botpress lui-même. Nous avons configuré nos services, les avons intégrés ensemble et avons parlé avec notre bot. En parlant avec le bot, nous avons vu comment il gère une variété d'entrées, et nous avons noté comment il réagit à des entrées incorrectes ou non spécifiques. Si vous souhaitez construire quelque chose de plus robuste, en appelant des API et en travaillant avec des flux, un bon point de départ serait notre exemple de chatbot Photographie de Mars Rover. Si vous souhaitez aller au-delà de WhatsApp et intégrer votre chatbot à d'autres canaux, consultez notre liste de lectureBotpress v12 Channel Integration sur YouTube. Bonne construction de chatbot ! :robot :
Récapitulation étape par étape
Bien qu'il soit recommandé de lire ce guide dans son intégralité, voici un résumé des principales étapes :
1. La préparation
- Téléchargez botpress à partir de https://v12.botpress.com/
- S'inscrire sur app.smooch.io
- Créer une application sur smooch et lui attribuer un nom
- Extraire le contenu du téléchargement de Botpress dans un répertoire de votre choix
- Téléchargez Ngrok à partir de https://ngrok.com/ et assurez-vous de suivre les instructions du site pour l'installation.
2. Démarrage
- Ouvrir le dossier dans lequel Botpress a été extrait
- Exécuter le fichier "bp
- Soyez patient pendant que les modules appropriés sont téléchargés
3. La création
- Générer la clé API
- Attendez que Botpress ait terminé l'installation
- La console vous indiquera où se trouve le Botpress Studio (Exemple : pour moi, c'était localhost:3000).
- Naviguer vers l'url fournie dans la console
- S'inscrire avec un compte administrateur
- Créer une option de bot et la nommer
- Sélectionner le modèle de bot (exemple : "Bot vide")
- L'espace de travail sera désormais doté d'un bot
- Cliquez sur bot en cliquant sur le nom
- Accéder à l'option éditeur de code
4. Configuration de l'espace de travail
- Trouvez le dossier Current Bot sous Configurations dans l'éditeur de code.
- Sélectionnez bot.config.json sous Configurations et faites défiler jusqu'à "messaging".
- Ajouter un objet "channels" (qui contiendra un objet "smooch")
- Dans Smooch, créez une valeur booléenne appelée "enabled" et donnez-lui la valeur "true".
- Créer les chaînes "keyId" et "secret" (qui prendront l'ID et le secret de la clé API générée plus tôt dans Smooch)
- Sauvegardez votre bot.config.json
- Naviguer vers Configurations
- Ouvrez botpress.config.json
- Recherchez "externalUrl" (il s'agit d'une chaîne vide).
- Enregistrer le fichier
- Redémarrer le serveur
- Ouvrir à nouveau le bot
- Cliquez sur "s'entraîner maintenant"
- La mention "prêt" remplacera la mention "train maintenant"
- Retournez à Smooch et vérifiez les webhooks configurés automatiquement
- Aller aux intégrations
- Sélectionner WhatsApp et se connecter
- Choisir le mode d'intégration (exemple : j'ai utilisé "Sandbox")
- Sélectionnez "Activer le bac à sable" et suivez les instructions pour envoyer un message au numéro spécifié dans WhatsApp.
- Vérifier si le message a été reçu
- Les autres messages seront transmis à webhook
- Vous pouvez maintenant parler avec votre robot !
5. Parler avec le robot
- Posez une question au robot
- Lire la réponse
- Posez-lui une "mauvaise" question et notez qu'il ne répondra pas.
Partager ce message sur :
Créez gratuitement votre propre chatbot d'IA personnalisé
Commencez à créer un robot GPT personnalisé grâce à notre interface intuitive de type "glisser-déposer".
Commencez - c'est gratuit ! 🤖Aucune carte de crédit n'est requise
Restez au courant des dernières nouveautés en matière d'IA chatbots