Como integrar Twilio com Botpress, Passo-a-Passo

Muito obrigado a um colaborador da comunidade Botpress , Danilo Limo! Temos o prazer de partilhar aqui o seu recente how-to, publicado no Botpress fórum da comunidade. Ele criou um tutorial passo a passo sobre como integrar Botpress com Twilio, usando o Whatsapp e trabalhando na sua máquina Windows. Apreciamos muito a nossa comunidade, e gostaríamos de partilhar quaisquer dicas, tutoriais, ou outros conteúdos criados com Botpress!

Tutorial de Integração
Passo-a-passo

Este tutorial visa demonstrar como a estrutura botpress está integrada com a Whatsapp através da plataforma Twilio.

Nota: Para facilitar, descreverei o passo-a-passo para o Windows, uma vez que é o ambiente que estou a utilizar actualmente.

Pré-requisitos:

Para utilizar o Twilio como integração do seu botpress com o Whatsapp é necessário que o seu bot tenha acesso externo via SSL /TLS [ https ]

Se o seu bot estiver a ser construído num ambiente local (localhost), terá de utilizar uma aplicação de túnel como a NGROK para que possa aceder ao seu localhost externamente.

Siga os passos seguintes:

1. Descarregar NGROK em ngrok - descarregar
2. Descompactar o ficheiro e rodar o executável
3. Na pasta /ngrok/bin execute o ficheiro ngrok.exe
4. O prompt de comando [cmd] irá abrir
5. Nele corre o seguinte comando: ngrok http 3000, onde ngrok é o comando executável da aplicação, http indica que será acedido via web e 3000 é a porta padrão 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

Agora vamos ao Twilio!!

1. Criar uma conta no Twilio (não vou descrever aqui como criar uma conta no Twilio porque é muito simples e intuitivo criar uma conta).
2. Quando criar a conta, no painel de instrumentos da sua conta, copie e reserve as chaves: accountSID e authToken.

Registe o seu número de telefone na sua conta, pois o Twilio vai precisar dele.

Uma vez isso feito, agora é altura de criar as suas credenciais de acesso ao Twilio em Botpress.

Botpress
Em Botpress executa os seguintes passos:

1. Open the \data\bots<your_bot>\bot.config.json file
2. Incluir, antes do último "}", o bloco de código json como abaixo:

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

Deve ter este aspecto:

3. Vá à pasta {data}global} e abra o ficheiro botpress.config.json

4. Com o ficheiro aberto, altere o parâmetro externoUrl como se segue:

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

Deve ter este aspecto:

• 5. Agora, na pasta {\data}globalconfig, abra o ficheiro channel-twilio.json e configure-o como se segue:

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

Deve ter este aspecto:

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. Uma vez isso feito, é altura de reiniciar o seu Botpress. Uma vez reiniciado, deve ver o registo de iniciação o URL do gancho web do Twilio em Botpress. Deve apresentar como:

8. Agora copie o twilio webhook url, vá à sua conta Twilio, e cole-o na secção do webhook, como se mostra na imagem abaixo:

• 9. Agora, enquanto ainda estiver na sua conta Twilio, vá ao menu Mensagens → Experimente → Envie uma mensagem Whatsapp
• 10. Terá de activar o Twilio Whatsapp, portanto abra o Whatsapp da seguinte forma:

• 11. Este código "join lot-idea" activa o Twilio para interagir com o seu Botpress.
• 12. Se quiser desactivar o serviço Twilio basta enviar uma mensagem com o texto "stop".
• 13. E é tudo! O seu Botpress está preparado para enviar e receber mensagens pela WhatsApp. Veja a interacção das mensagens, assim como o registo:

E é tudo!

Muito obrigado a Danilo! Podeis ver a sua multa correio original no fórum Botpress . Se estiver interessado em mais Botpress how-to's, consulte o Botpress Canal YouTube, onde nos últimos meses temos vindo a acrescentar muitos novos conteúdos de desenvolvimento.

De facto, existe um vídeo de como fazer, recém-publicado, sobre a Botpress Integração do Canal Twilio, com revisão actualizada de como utilizar Twilio com Botpress. Veja isto!

‍