Hoe Twilio integreren met Botpress, stap voor stap

Hartelijk dank aan een medewerker van de Botpress community, Danilo Limo! We zijn blij dat we hier zijn recente how-to kunnen delen, gepost op het Botpress community forum. Hij maakte een stap-voor-stap tutorial over hoe Botpress te integreren met Twilio, met behulp van Whatsapp en werkend op zijn Windows machine. We waarderen onze community enorm en zouden graag alle tips, tutorials of andere content die ontwikkelaars maken met Botpress delen!

Integratiehandleiding
Stap voor stap

Deze tutorial laat zien hoe het botpress framework geïntegreerd is met Whatsapp via het Twilio platform.

Opmerking: Voor het gemak zal ik de stap-voor-stap beschrijven voor Windows, omdat dat de omgeving is die ik momenteel gebruik.

Vereisten:

Om Twilio te gebruiken als integratie van je botpress met Whatsapp is het noodzakelijk dat je bot externe toegang heeft via SSL /TLS [ https ].

Als je bot gebouwd wordt in een lokale omgeving (localhost), dan zul je een tunnelapplicatie zoals NGROK moeten gebruiken zodat je extern toegang hebt tot je localhost.

Volg de onderstaande stappen:

1. Download NGROK in ngrok - download
2. Pak het bestand uit en draai het uitvoerbare bestand
3. Voer in de map /ngrok/bin het bestand ngrok.exe uit
4. De opdrachtprompt [cmd] wordt geopend
5. Voer daarin het volgende commando uit: ngrok http 3000, waarbij ngrok het uitvoerbare commando van de applicatie is, http aangeeft dat deze via het web wordt benaderd en 3000 de standaardpoort is van 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

Laten we nu naar Twilio gaan!!!

1. Maak een account aan op Twilio (ik zal hier niet beschrijven hoe je een account aanmaakt in Twilio omdat het heel eenvoudig en intuïtief is om een account aan te maken).
2. Wanneer je de account aanmaakt, moet je in het dashboard van je account de sleutels kopiëren en reserveren: accountSID en authToken.

Registreer je telefoonnummer in je account, want Twilio heeft het nodig.

Zodra dat is gebeurd, is het tijd om je Twilio-toegangsreferenties in Botpress in te stellen.

Botpress
In Botpress voer je de volgende stappen uit:

1. Open the \data\bots<your_bot>\bot.config.json file
2. Neem voor de laatste "}" het json-codeblok op zoals hieronder:

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

Het zou er zo uit moeten zien:

3. Ga naar de map \data_global_ en open het bestand botpress.config.json.

4. Wijzig de parameter externalUrl als volgt terwijl het bestand geopend is:

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

Het zou er zo uit moeten zien:

• 5. Open nu in de map \data\globalconfig het bestand channel-twilio.json en configureer het als volgt:

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

Het zou er zo uit moeten zien:

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. Zodra dat is gebeurd, is het tijd om uw Botpress opnieuw op te starten. Zodra u opnieuw opstart, moet u de initiatie log de URL van de Twilio webhook in Botpress. U moet presenteren als:

8. Kopieer nu de Twilio webhook url, ga naar je Twilio account en plak het in de webhook sectie, zoals in de afbeelding hieronder:

• 9. Ga nu, terwijl je nog steeds in je Twilio-account bent, naar menu Messaging → Probeer het uit → Stuur een Whatsapp-bericht
• 10. Je moet Twilio Whatsapp activeren, dus open Whatsapp als volgt:

• 11. Deze "join lot-idea" code activeert Twilio voor interactie met uw Botpress.
• 12. Als je de Twilio-service wilt uitschakelen, stuur je gewoon een bericht met de tekst "stop".
• 13. En dat is het! Je Botpress is voorbereid om berichten te verzenden en ontvangen via WhatsApp. Bekijk de interactie van berichten en het logboek:

En dat was het!

Heel veel dank aan Danilo! Je kunt zijn mooie originele post in het Botpress forum. Als je geïnteresseerd bent in meer Botpress how-to's, kijk dan eens op het Botpress YouTube-kanaalwaar we de afgelopen maanden veel nieuwe content voor ontwikkelaars hebben toegevoegd.

Er is zelfs een zojuist gepubliceerde instructievideo over de Botpress Twilio-kanaalintegratiemet een actueel overzicht van het gebruik van Twilio met Botpress. Bekijk het!

‍