Integration von Twilio mit Botpress, Schritt für Schritt

Vielen Dank an einen Mitarbeiter von Botpress , Danilo Limo! Wir freuen uns, hier seine jüngste Anleitung zu veröffentlichen, die er im Botpress Community-Forum gepostet hat. Er hat eine Schritt-für-Schritt-Anleitung zur Integration von Botpress mit Twilio erstellt, die Whatsapp verwendet und auf seinem Windows-Rechner läuft. Wir schätzen unsere Community sehr und würden gerne alle Tipps, Tutorials oder andere Inhalte, die Entwickler mit Botpress erstellen, mit Ihnen teilen!

Integrations-Tutorial
Schritt für Schritt

In diesem Tutorial soll gezeigt werden, wie das botpress Framework über die Twilio-Plattform in Whatsapp integriert wird.

Anmerkung: Der Einfachheit halber beschreibe ich die einzelnen Schritte für Windows, da dies die Umgebung ist, die ich derzeit verwende.

Voraussetzungen:

Um Twilio als Integration Ihres botpress mit Whatsapp zu nutzen, ist es notwendig, dass Ihr Bot einen externen Zugang über SSL /TLS [ https ] hat.

Wenn Ihr Bot in einer lokalen Umgebung (localhost) erstellt wird, müssen Sie eine Tunnelanwendung wie NGROK verwenden, damit Sie von außen auf Ihren localhost zugreifen können.

Folgen Sie den nachstehenden Schritten:

1. Herunterladen NGROK in ngrok - herunterladen
2. Entpacken Sie die Datei und drehen Sie die ausführbare Datei
3. Führen Sie im Ordner /ngrok/bin die Datei ngrok.exe aus
4. Die Eingabeaufforderung [cmd] wird geöffnet
5. Führen Sie darin den folgenden Befehl aus: ngrok http 3000, wobei ngrok der ausführbare Befehl der Anwendung ist, http angibt, dass der Zugriff über das Internet erfolgt und 3000 der Standardport von 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

Jetzt geht es zu Twilio!

1. Erstellen Sie ein Konto bei Twilio (ich werde hier nicht beschreiben, wie man ein Konto bei Twilio erstellt, da es sehr einfach und intuitiv ist, ein Konto zu erstellen).
2. Wenn Sie das Konto erstellen, kopieren und reservieren Sie in Ihrem Konto-Dashboard die Schlüssel: accountSID und authToken.

Registrieren Sie Ihre Telefonnummer in Ihrem Konto, da Twilio sie benötigt.

Wenn das erledigt ist, müssen Sie nun Ihre Twilio-Zugangsdaten unter Botpress einrichten.

Botpress
Unter Botpress führen Sie die folgenden Schritte durch:

1. Open the \data\bots<your_bot>\bot.config.json file
2. Fügen Sie vor dem letzten "}" den json-Codeblock wie unten ein:

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

Sie sollte folgendermaßen aussehen:

3. Gehen Sie zum Ordner \data\global\ und öffnen Sie die Datei botpress.config.json

4. Ändern Sie bei geöffneter Datei den Parameter externalUrl wie folgt:

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

Sie sollte folgendermaßen aussehen:

• 5. Öffnen Sie nun im Ordner \data\global\config die Datei channel-twilio.json und konfigurieren Sie sie wie folgt:

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

Sie sollte folgendermaßen aussehen:

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. Sobald das erledigt ist, müssen Sie Ihr Botpress neu starten. Nach dem Neustart sollten Sie das Initiierungsprotokoll und die URL des Twilio-Webhooks unter Botpress sehen. Sie müssen sich als:

8. Kopieren Sie nun die Twilio-Webhook-URL, gehen Sie zu Ihrem Twilio-Konto und fügen Sie sie in den Webhook-Bereich ein, wie in der Abbildung unten gezeigt:

• 9. Gehen Sie jetzt, während Sie noch in Ihrem Twilio-Konto sind, zum Menü Messaging → Try it out → Send a Whatsapp message
• 10. Sie müssen Twilio Whatsapp aktivieren, also öffnen Sie Whatsapp wie folgt:

• 11. Dieser "join lot-idea"-Code aktiviert Twilio für die Interaktion mit Ihrer Botpress.
• 12. Wenn Sie den Twilio-Dienst deaktivieren möchten, senden Sie einfach eine Nachricht mit dem Text "stop".
• 13. Und das war's! Ihr Botpress ist bereit, Nachrichten per WhatsApp zu senden und zu empfangen. Sehen Sie sich die Interaktion der Nachrichten sowie das Protokoll an:

Und das war's!

Vielen Dank an Danilo! Ihr könnt seinen schönen Originalbeitrag im Botpress Forum sehen. Wenn Sie an weiteren Anleitungen auf Botpress interessiert sind, schauen Sie sich den Botpress YouTube-Kanalwo wir in den letzten Monaten viele neue Inhalte für Entwickler hinzugefügt haben.

Es gibt sogar ein gerade veröffentlichtes How-to-Video zur Botpress Twilio-Kanal-Integrationmit einem aktuellen Überblick über die Verwendung von Twilio mit Botpress. Probieren Sie es aus!

‍