Cómo integrar Twilio con Botpress, paso a paso

Muchas gracias a Danilo Limo, colaborador de la comunidad Botpress . Nos complace compartir aquí su reciente tutorial, publicado en el foro de la comunidadBotpress . Él creó un tutorial paso a paso sobre cómo integrar Botpress con Twilio, usando Whatsapp y trabajando en su máquina Windows. Apreciamos mucho a nuestra comunidad y nos encantaría compartir cualquier consejo, tutorial u otro contenido que los desarrolladores creen con Botpress.

Tutorial de integración
Paso a paso

Este tutorial pretende demostrar cómo se integra el framework botpress con Whatsapp a través de la plataforma Twilio.

Nota: Para mayor facilidad describiré el paso a paso para Windows ya que es el entorno que estoy utilizando actualmente.

Requisitos previos:

Para utilizar Twilio como integración de su botpress con Whatsapp es necesario que su bot tenga acceso externo vía SSL /TLS [ https ]

Si tu bot está siendo construido en un entorno local (localhost) necesitarás usar una aplicación de túnel como NGROK para que puedas acceder a tu localhost externamente.

Siga los pasos que se indican a continuación:

1. Descargar NGROK en ngrok - descargar
2. Descomprime el archivo y gira el ejecutable
3. En la carpeta /ngrok/bin ejecute el archivo ngrok.exe
4. Se abrirá el símbolo del sistema [cmd]
5. En ella ejecuta el siguiente comando: ngrok http 3000, donde ngrok es el comando ejecutable de la aplicación, http indica que se accederá vía web y 3000 es el puerto por defecto de 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

¡¡Ahora vamos a Twilio!!

1. Crear una cuenta en Twilio (no voy a describir aquí cómo crear una cuenta en Twilio porque es muy sencillo e intuitivo crear una cuenta).
2. Cuando crees la cuenta, en el panel de control de tu cuenta, copia y reserva las claves: accountSID y authToken.

Registre su número de teléfono en su cuenta, ya que Twilio lo necesitará.

Una vez hecho esto, ahora es el momento de configurar sus credenciales de acceso Twilio en Botpress.

Botpress
En Botpress se realizan los siguientes pasos:

1. Open the \data\bots<your_bot>\bot.config.json file
2. Incluya, antes del último "}", el bloque de código json como se indica a continuación:

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

Debería verse así:

3. Vaya a la carpeta \data\global\ y abra el archivo botpress.config.json

4. Con el archivo abierto, cambie el parámetro externalUrl de la siguiente manera:

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

Debería verse así:

• 5. Ahora, en la carpeta \data\global\config, abra el archivo channel-twilio.json y configúrelo como sigue:

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

Debería verse así:

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. Una vez hecho esto, es hora de reiniciar su Botpress. Una vez que reinicie, usted debe ver el registro de inicio la URL del webhook Twilio en Botpress. Usted debe presentar como:

8. Ahora copia la url del webhook de Twilio, ve a tu cuenta de Twilio, y pégala en la sección webhook, como se muestra en la imagen de abajo:

• 9. Ahora, sin salir de su cuenta de Twilio, vaya al menú Mensajería → Probar → Enviar un mensaje de Whatsapp.
• 10. Tendrá que activar Twilio Whatsapp, así que abra Whatsapp de la siguiente manera:

• 11. Este código "join lot-idea" activa Twilio para interactuar con su Botpress.
• 12. Si quieres desactivar el servicio Twilio sólo tienes que enviar un mensaje con el texto "stop".
• 13. Y ¡listo! Su Botpress está preparado para enviar y recibir mensajes por WhatsApp. Ver la interacción de los mensajes, así como el registro:

Y ya está.

¡Muchas gracias a Danilo! Puedes ver su post original en el foro Botpress . Si estás interesado en más Botpress how-to's, echa un vistazo al Botpress canal de YouTubedonde hemos estado añadiendo mucho contenido nuevo para desarrolladores en los últimos meses.

De hecho, acabamos de publicar un vídeo explicativo sobre la Botpress Integración de canales Twiliocon una revisión actualizada de cómo utilizar Twilio con Botpress. Échale un vistazo.

‍