Como criar facilmente um Chatbot do WhatsApp usando Botpress v12 e Smooch
Um chatbot pode ser uma ajuda incrivelmente útil para o seu negócio e esta publicação fornece-lhe todos os passos necessários para criar o seu próprio chatbot. Usando Botpress v12 e Smooch (agora conhecido como Sunshine Conversations by Zendesk) Mostraremos como se conectar ao WhatsApp e criar um bot de perguntas e respostas simples que responde a uma variedade de perguntas.
Antes de criar o bot
Antes de começarmos, terá de instalar e configurar vários serviços - estes requerem um e-mail profissional e, pelo menos, 64 GB de espaço no seu disco rígido.
Descarregar Botpress
Comece por navegar para a página de documentaçãoBotpress v12 e transfira a sua versão preferida de Botpress.
Criar uma conta no Smooch
Enquanto Botpress v12 é transferido, navegue para a página de registo do Smooch/Sunshine Conversations. Depois de concluir o processo de registo, terá de criar uma aplicação e atribuir-lhe um nome.
Nesta altura, a sua transferência de Botpress deverá ter terminado. Se descarregou com a opção 'binary', basta extrair o conteúdo da descarga para um diretório à sua escolha.
Descarregar Ngrok
O terceiro serviço que iremos utilizar chama-se Ngrok, que pode ser descarregado aqui. O Ngrok é um serviço gratuito que utilizaremos para partilhar o servidor Botpress em execução na sua máquina local para a Web. Siga as instruções no site para fazer o download e instalar. Agora está pronto para começar a criar o seu chatbot.
Configurar Botpress com chaves API do Smooch
Para começar a utilizar o seu chatbot, primeiro tem de abrir a pasta para onde extraímos o Botpress v12 e executar o ficheiro 'bp'. Isto irá iniciar o bot, o que requer o download de alguns módulos. Este processo demora algum tempo, mas só deve ser feito uma vez, após o que cada lançamento subsequente será mais expedito.
Enquanto a aplicação Botpress está a ser configurada, volta a navegar para a tua aplicação no Smooch e selecciona as definições. Deves ver opções para dar um nome ao teu bot, atribuir-lhe uma imagem, opções de mensagens, uma ID de aplicação e chaves de API. Quando vires chaves de API, deves criar uma nova chave de API.
Criar e configurar o seu bot
A configuração do Botpress v12 deve estar concluída na altura em que gerar a chave API no Smooch. Nesta altura, a sua consola ter-lhe-á dito onde abrir o Botpress Studio - no nosso caso, foi localhost:3000. Navegue para o URL fornecido na consola e registe-se na sua conta de administrador.
Como esta é a primeira vez que executa Botpress, verá que o seu espaço de trabalho não tem bots. Seleccione a opção para criar um bot e dê-lhe um nome. Isso preencherá automaticamente o campo ID do bot para você. Em seguida, seleccione um modelo de bot (como a opção 'Learn Botpress Basics').
Verá que o seu espaço de trabalho tem agora um bot! Seleccione o bot (clique no seu nome). Uma barra que corre verticalmente, no lado esquerdo do Studio, deve chamar a sua atenção. As opções aqui apresentadas serão aquelas com que mais trabalhará durante o desenvolvimento do seu bot. No nosso caso, começaremos pela opção do editor de código, que abrirá uma série de directórios no estúdio e nos levará ao próximo passo.
Em Configurações no editor de código, verá duas pastas. Por enquanto, concentre-se no bot Atual.
Seleccione bot.config.json em Configurações e desloque-se para "mensagens". É aqui que poderás adicionar um objeto "channels", que conterá um objeto "smooch". Em Smooch, crie um valor booleano chamado "enabled" (ativado) e atribua-lhe o valor true (verdadeiro). Em seguida, terá de criar as cadeias de caracteres 'keyId' e 'secret' - , que irão receber o ID e o secret da chave API que gerou na sua aplicação Smooch, respetivamente.
Quando esta tarefa estiver concluída, guarde o seu bot.config.json e navegue para a pasta Global em Configurações para abrir o botpress.config.json. Procure por 'externalUrl', que será definido como uma string vazia. Esse é um serviço bastante simples, portanto, basta seguir as instruções no site para expor a porta em que o bot será executado com o Ngrok. Depois disso, volte para colar o URL HTTPS na string externalUrl.
Salve o arquivo, reinicie o servidor e abra seu bot novamente. Clique em "Train Now" (Treinar agora) no canto inferior direito. Deverá ver "Ready" (Pronto) onde antes estava "Train Now" (Treinar agora).
Fale com o seu Bot
Regressa à aplicação Smooch e deverás ver que os webhooks são configurados automaticamente. Volta a navegar para as integrações, selecciona WhatsApp e depois liga-te. Agora, escolhe o teu modo de integração - para efeitos deste guia, "Sandbox" funcionará bem.
Selecciona 'Activate Sandbox' e segue as instruções para enviar uma mensagem para o número especificado no WhatsApp. Depois de teres ligado com sucesso a tua Smooch Sandbox para WhatsApp, deves receber uma mensagem. Quaisquer outras mensagens serão reencaminhadas para o webhook que criaste.
Agora já podes falar com o teu bot!
Faça o seu Bot responder
Agora que temos um bot em branco e recebemos uma mensagem a confirmar que as nossas integrações funcionam corretamente, vamos começar com a resposta inicial do bot depois de dizermos alguma coisa.
Para fazer isso, navegue até Q&A no Botpress Studio, que será a quarta opção no menu da barra lateral esquerda. Verá uma mensagem para adicionar uma pergunta tocando no sinal de mais na barra de ferramentas. Aparecerá um ecrã que lhe dará a opção de introduzir texto para a pergunta e para a resposta. No nosso caso, definimos a pergunta como "Qual é a sua fruta favorita?". A resposta é: "A minha fruta favorita é o tomate, que a maioria das pessoas confunde com um vegetal! Podemos repetir este processo algumas vezes, dando-lhe uma nova pergunta e resposta de cada vez.
Verá que, no canto superior direito de cada nova pergunta, está escrito incompleto. Se passar o mouse sobre isso, ele dirá que as perguntas e respostas usarão apenas a correspondência exata. Isso ocorre porque precisamos adicionar várias maneiras diferentes de fazer a pergunta para habilitar e ajudar o aprendizado de máquina para o bot. Vá em frente e adicione diversas variações da pergunta às P&R. Quanto mais você adicionar, melhor.
Por fim, podemos ter uma conversa com o nosso bot, fazer-lhe algumas perguntas simples e obter uma resposta. Isto deve ser bastante simples, basta fazer-lhe uma das perguntas que criou e receber uma resposta! Tenha em atenção que, como se trata de uma integração bastante simples, quaisquer perguntas incorrectas feitas ou mensagens fora dos parâmetros configurados para este bot serão simplesmente ignoradas.
Conclusão
Neste guia, abordámos a inscrição nos serviços de que necessita para ter êxito na criação de um chatbot com Botpress v12. Isso incluiu o Smooch, o Ngrok e o próprio Botpress . Configurámos os nossos serviços, integrámo-los e falámos com o nosso bot. Ao falar com o bot, vimos como ele lida com uma variedade de entradas, e notamos como ele responde a entradas impróprias ou inespecíficas. Se quiser construir algo mais robusto, chamando APIs e trabalhando com fluxos, um bom lugar para começar seria o nosso exemplo de chatbot Mars Rover Photography. Se quiser ir além do WhatsApp e integrar o seu chatbot com outros canais, consulte a nossa lista de reproduçãoBotpress v12 Channel Integration no YouTube. Boa construção de bots! :robot:
Recapitulação passo a passo
Embora seja recomendável ler este guia na íntegra, eis um resumo aproximado das principais etapas:
1. Preparação
- Descarregar botpress de https://v12.botpress.com/
- Inscrever-se em app.smooch.io
- Criar uma aplicação no smooch e atribuir-lhe um nome
- Extraia o conteúdo da transferência Botpress para um diretório à sua escolha
- Descarregue o Ngrok a partir de https://ngrok.com/ e certifique-se de que segue as instruções do sítio para a instalação
2. Arranque
- Abrir a pasta para onde foi extraído o ficheiro Botpress
- Executar o ficheiro "bp
- Seja paciente enquanto os módulos adequados são descarregados
3. Criação
- Gerar a chave da API
- Aguardar até que Botpress termine a configuração
- A consola dir-lhe-á onde abrir o Botpress Studio (Exemplo: para mim foi localhost:3000)
- Navegar para o url fornecido na consola
- Inscrever-se com uma conta de administrador
- Criar uma opção de bot e dar-lhe um nome
- Selecionar modelo de bot (Exemplo: "Bot vazio")
- O espaço de trabalho passa a ter um bot
- Clique no bot clicando no nome
- Navegar para a opção do editor de código
4. Configuração
- Localize a pasta Bot atual em Configurações no editor de código
- Seleccione bot.config.json em Configurações e desloque-se para "mensagens".
- Adicionar um objeto "channels" (conterá um objeto "smooch")
- No Smooch, criar um valor booleano chamado "enabled" e atribuir-lhe o valor true
- Criar os strings "keyId" e "secret" (que vão pegar no ID e no secret da chave API gerada anteriormente no Smooch)
- Salve seu bot.config.json
- Navegar para Configurações
- Abrir botpress.config.json
- Procure por "externalUrl' (será definido como uma cadeia vazia)
- Guardar ficheiro
- Reiniciar o servidor
- Abrir o bot novamente
- Clique em "treinar agora"
- "Ready" substituirá "train now"
- Regressar ao Smooch e verificar os webhooks configurados automaticamente
- Ir para as integrações
- Selecionar WhatsApp e ligar
- Selecionar o modo de integração (exemplo: utilizei "Sandbox")
- Seleccione "Ativar Sandbox" e siga as instruções para enviar uma mensagem para o número especificado no WhatsApp
- Verificar se a mensagem foi recebida
- Outras mensagens serão reencaminhadas para o webhook
- Já pode falar com o seu bot!
5. Falar com o Bot
- Faça uma das suas perguntas ao bot
- Ler a resposta
- Faça-lhe uma pergunta "errada" e note que ele não responde
Partilhar isto em:
Crie o seu próprio chatbot de IA personalizado gratuitamente
Comece a criar um bot GPT personalizado com a nossa interface intuitiva de arrastar e soltar.
Começar - é grátis! 🤖Não é necessário cartão de crédito
Mantenha-se atualizado com as últimas novidades sobre IA chatbots