Comment intégrer Twilio à Botpress, étape par étape

Un grand merci à un contributeur de la communauté Botpress , Danilo Limo ! Nous sommes heureux de partager ici son récent tutoriel, posté dans le forum de la communautéBotpress . Il a créé un tutoriel étape par étape sur la façon d'intégrer Botpress avec Twilio, en utilisant Whatsapp et en travaillant sur sa machine Windows. Nous apprécions vraiment notre communauté, et nous serions ravis de partager tous les conseils, tutoriels ou autres contenus que les développeurs créent avec Botpress!

Tutoriel d'intégration
Pas à pas

Ce tutoriel a pour but de démontrer comment le framework botpress est intégré à Whatsapp via la plateforme Twilio.

Remarque : Pour plus de facilité, je décrirai les étapes pour Windows car c'est l'environnement que j'utilise actuellement.

Prérequis :

Pour utiliser Twilio comme intégration de votre botpress avec Whatsapp, il est nécessaire que votre bot ait un accès externe via SSL /TLS [ https ].

Si votre bot est construit dans un environnement local (localhost), vous devrez utiliser une application tunnel telle que NGROK afin de pouvoir accéder à votre localhost de manière externe.

Suivez les étapes ci-dessous :

1. Télécharger NGROK dans ngrok - download
2. Décompressez le fichier et faites pivoter l'exécutable.
3. Dans le dossier /ngrok/bin, lancer le fichier ngrok.exe
4. L'invite de commande [cmd] s'ouvre
5. Dans celui-ci, exécutez la commande suivante : ngrok http 3000, où ngrok est la commande exécutable de l'application, http indique qu'elle sera accessible via le web et 3000 est le port par défaut de l'application. Botpress

If you are developing your bot in cloud environment, such as Heroku for example, just use the external url of your bot which should look something like this: https://<yourbotname>.herokuapp.com/

Twilio

Passons maintenant à Twilio!

1. Créer un compte sur Twilio (je ne décrirai pas ici comment créer un compte sur Twilio car il est très simple et intuitif de créer un compte).
2. Lorsque vous créez le compte, dans le tableau de bord de votre compte, copiez et réservez les clés : accountSID et authToken.

Enregistrez votre numéro de téléphone dans votre compte, car Twilio en aura besoin.

Une fois que c'est fait, il est temps de configurer vos identifiants d'accès à Twilio dans Botpress.

Botpress
Sur le site Botpress , vous effectuez les étapes suivantes :

1. Open the \data\bots<your_bot>\bot.config.json file
2. Inclure, avant le dernier "}", le bloc de code json comme ci-dessous :

"messaging": {
"channels": {
"twilio": {
"enabled": false, "change here to true"
"accountSID": "Enter your key accountSID here",
"authToken": "Enter your key authToken here"
}
}
}

Il devrait ressembler à ceci :

3. Allez dans le dossier \data\global\ et ouvrez le fichier botpress.config.json

4. Le fichier étant ouvert, modifiez le paramètre externalUrl comme suit :

"externalUrl": "https://6a3d-a700.ngrok.io",
"session": {
"enabled": true, “If false change to true”
"maxAge": "1h"
},

Il devrait ressembler à ceci :

• 5. Maintenant, dans le dossier \data\global\config, ouvrez le fichier channel-twilio.json et configurez-le comme suit :

{
"$schema": "bp://types/modules/channel-twilio/config.schema.json",
"enabled": true,
"accountSID": " Enter your key accountSID here",
"authToken": " Enter your key authToken here"
}

Il devrait ressembler à ceci :

6. Now copy the channel-twilio.json file from the \data\global\config folder and paste it into the \data\bots\ folder <your_bot>\config

7. Une fois que c'est fait, il est temps de redémarrer votre Botpress. Une fois que vous aurez redémarré, vous devriez voir l'initiation log l'URL du webhook Twilio dans Botpress. Vous devez vous présenter en tant que :

8. Copiez maintenant l'url du webhook Twilio, allez sur votre compte Twilio et collez-la dans la section webhook, comme indiqué dans l'image ci-dessous :

• 9. Maintenant, tout en restant dans votre compte Twilio, allez dans le menu Messagerie → Essayer → Envoyer un message Whatsapp
• 10. Vous devez activer Twilio Whatsapp, ouvrez donc Whatsapp comme suit :

• 11. Ce code "join lot-idea" active Twilio pour interagir avec votre Botpress.
• 12. Si vous souhaitez désactiver le service Twilio, envoyez simplement un message avec le texte "stop".
• 13. Et le tour est joué ! Votre Botpress est prêt à envoyer et recevoir des messages par WhatsApp. Voir l'interaction des messages, ainsi que le journal :

Et c'est tout !

Un grand merci à Danilo ! Vous pouvez voir son excellent message original dans le forum Botpress . Si vous êtes intéressé par d'autres tutoriels sur Botpress , consultez la Botpress chaîne YouTubeoù nous avons ajouté de nombreux nouveaux contenus pour les développeurs au cours des derniers mois.

En fait, une vidéo pratique vient d'être publiée sur l'intégration du canal Twilio. Botpress Intégration du canal Twilioavec un examen actualisé de l'utilisation de Twilio avec Botpress. Jetez-y un coup d'œil !

‍