Come costruire facilmente un chatbot WhatsApp utilizzando Botpress v12 e Smooch
Un chatbot può essere un aiuto incredibilmente utile per la vostra attività e questo post vi fornirà tutti i passaggi necessari per costruire il vostro. Utilizzando Botpress v12 e Smooch (ora noto come Sunshine Conversations di Zendesk) vi mostreremo come collegarvi a WhatsApp e costruire un semplice bot Q&A che risponda a una serie di domande.
Prima di costruire il Bot
Prima di iniziare, è necessario impostare e configurare diversi servizi , che richiedono un'e-mail aziendale e almeno 64 GB di spazio sul disco rigido.
Scarica Botpress
Iniziate a navigare nella pagina della documentazione di Botpress v12 e scaricate la vostra versione preferita di Botpress.
Crea un account su Smooch
Mentre Botpress v12 viene scaricato, andare alla pagina di registrazione di Smooch/Sunshine Conversations. Una volta completata la procedura di registrazione, dovrete creare un'app e darle un nome.
A questo punto, il download di Botpress dovrebbe essere terminato. Se si è scaricato con l'opzione "binario", è sufficiente estrarre il contenuto del download in una directory a scelta.
Scaricare Ngrok
Il terzo servizio che utilizzeremo si chiama Ngrok, che potete scaricare qui. Ngrok è un servizio gratuito che useremo per condividere sul web il server Botpress in esecuzione sulla vostra macchina locale. Seguite le istruzioni sul sito per scaricare e installare. Ora siete pronti per iniziare a creare il vostro chatbot.
Configurare Botpress con le chiavi API di Smooch
Per iniziare il chatbot, è necessario aprire la cartella in cui abbiamo estratto Botpress v12 ed eseguire il file 'bp'. Questo avvierà il bot, che richiede il download di alcuni moduli. Questo processo richiede un po' di tempo, ma dovrebbe essere necessario solo una volta, dopodiché ogni avvio successivo sarà più rapido.
Mentre l'app Botpress si sta configurando, tornare alla propria app su Smooch e selezionare le impostazioni. Dovrebbero essere disponibili opzioni per dare un nome al bot, un'immagine, opzioni per i messaggi, un ID app e chiavi API. Quando si vedono le chiavi API, si deve creare una nuova chiave API.
Creare e configurare il bot
La configurazione di Botpress v12 dovrebbe essere completa nel momento in cui si genera la chiave API su Smooch. A questo punto, la console vi dirà dove aprire Botpress Studio , nel nostro caso localhost:3000. Accedere all'URL fornito nella console e registrarsi per l'account di amministratore.
Poiché è la prima volta che si esegue Botpress, si vedrà che l'area di lavoro non ha bot. Selezionare l'opzione per creare un bot e dargli un nome. Questo popolerà automaticamente il campo ID bot. Selezionare quindi un modello di bot (ad esempio l'opzione "Impara le basi di Botpress ").
Vedrete che nel vostro spazio di lavoro ora c'è un bot! Procedere selezionando il bot (fare clic sul suo nome). Una barra che scorre verticalmente, sul lato sinistro dello Studio, dovrebbe attirare la vostra attenzione. Le opzioni presentate qui saranno quelle con cui lavorerete di più durante lo sviluppo del vostro bot. Nel nostro caso, inizieremo con l'opzione editor di codice, che aprirà una serie di directory nello studio e ci porterà alla fase successiva.
Nell'editor di codice, sotto Configurazioni, sono presenti due cartelle. Per ora, concentrarsi sul bot corrente.
Selezionare bot.config.json in Configurazioni e scorrere fino a "messaggistica". Qui si potrà aggiungere un oggetto "channels", che conterrà un oggetto "smooch". In Smooch, creare un valore booleano chiamato "enabled" e assegnargli il valore true. Sarà quindi necessario creare le stringhe "keyId" e "secret" - che prenderanno rispettivamente l'ID e il secret dalla chiave API generata nella propria applicazione Smooch.
Una volta completata questa operazione, salvare il bot.config.json e navigare nella cartella Global sotto Configurations per aprire botpress.config.json. Cercare "externalUrl", che sarà impostato su una stringa vuota. Si tratta di un servizio abbastanza semplice, quindi basta seguire le istruzioni del sito per esporre la porta su cui il bot funzionerà con Ngrok. Dopodiché, tornare a incollare l'URL HTTPS nella stringa externalUrl.
Salvare il file, riavviare il server e riaprire il bot. Fare clic su "Allenati ora" nell'angolo in basso a destra. Dovrebbe comparire la scritta "Ready" al posto di "Train Now".
Parlare con il proprio Bot
Tornate all'app Smooch e vedrete che i webhook sono configurati automaticamente. Tornare alle integrazioni, selezionare WhatsApp e connettersi. A questo punto, scegliete la modalità di integrazione : per lo scopo di questa guida, "Sandbox" andrà bene.
Selezionare "Attiva Sandbox" e seguire le istruzioni per inviare un messaggio al numero specificato in WhatsApp. Dopo aver collegato con successo la Sandbox di Smooch per WhatsApp, si dovrebbe ricevere un messaggio. Tutti gli altri messaggi saranno inoltrati al webhook creato.
Ora potrete parlare con il vostro bot!
Fate parlare il vostro bot
Ora che abbiamo un bot vuoto e abbiamo ricevuto un messaggio che conferma che le nostre integrazioni funzionano correttamente, iniziamo con la risposta iniziale del bot dopo che abbiamo detto qualcosa.
A tale scopo, spostarsi su Q&A nello Studio Botpress , che sarà la quarta opzione in basso nel menu della barra laterale sinistra. Verrà richiesto di aggiungere una domanda toccando il segno più nella barra degli strumenti. Verrà visualizzata una schermata con la possibilità di inserire il testo sia per la domanda che per la risposta. Nel nostro caso, abbiamo impostato la domanda su "Qual è il tuo frutto preferito?". La risposta è stata: "Il mio frutto preferito è il pomodoro, che la maggior parte delle persone scambia per una verdura". Possiamo ripetere questo processo più volte, dando ogni volta una nuova domanda e una nuova risposta.
Si noterà che in alto a destra di ogni nuova domanda c'è la dicitura "incompleto". Se si passa il mouse su questa dicitura, si capisce che la domanda e l'offerta utilizzeranno solo la corrispondenza esatta. Questo perché è necessario aggiungere più modi diversi di porre la domanda per abilitare e aiutare l'apprendimento automatico del bot. Procedere con l'aggiunta di diverse varianti della domanda alla Q&A, più se ne aggiungono meglio è.
Infine, possiamo conversare con il nostro bot, ponendogli alcune semplici domande e ottenendo una risposta. Dovrebbe essere abbastanza semplice: basta porre una delle domande create e ricevere una risposta! Si noti che, trattandosi di un'integrazione piuttosto semplice, qualsiasi domanda impropria o messaggio al di fuori dei parametri configurati per questo bot sarà semplicemente ignorato.
Conclusione
In questa guida abbiamo trattato l'iscrizione ai servizi necessari per riuscire a creare un chatbot con Botpress v12. Si tratta di Smooch, Ngrok e Botpress stesso. Abbiamo configurato i nostri servizi, li abbiamo integrati e abbiamo parlato con il nostro bot. Parlando con il bot abbiamo visto come gestisce una varietà di input e abbiamo notato come risponde a input impropri o non specifici. Se volete costruire qualcosa di più robusto, che richiami le API e lavori con i flussi, un buon punto di partenza è il nostro esempio di chatbot per la fotografia di Mars Rover. Se volete andare oltre WhatsApp e integrare il vostro chatbot con altri canali, date un'occhiata alla nostra playlistBotpress v12 Channel Integration su YouTube. Buona costruzione di bot! :robot:
Ricapitolazione passo per passo
Anche se si consiglia di leggere questa guida nella sua interezza, ecco un riassunto approssimativo dei passi principali:
1. Preparazione
- Scaricare botpress da https://v12.botpress.com/
- Iscriviti su app.smooch.io
- Creare un'app su smooch e assegnarle un nome
- Estrarre il contenuto del download di Botpress in una directory a scelta.
- Scaricate Ngrok da https://ngrok.com/ e assicuratevi di seguire le istruzioni sul sito per l'installazione.
2. Avvio
- Aprite la cartella in cui è stato estratto Botpress
- Eseguire il file "bp
- Siate pazienti mentre vengono scaricati i moduli appropriati
3. Creazione
- Generare la chiave API
- Attendere che Botpress finisca di configurarsi
- La console vi dirà dove si trova Botpress Studio (ad esempio: per me era localhost:3000).
- Navigare all'URL fornito nella console
- Registrarsi con un account amministratore
- Creare un'opzione bot e darle un nome
- Selezionare il modello di bot (esempio: "Bot vuoto")
- Lo spazio di lavoro avrà ora un bot
- Fare clic sul bot facendo clic sul nome
- Passare all'opzione Editor di codice
4. Configurazione
- Trovare la cartella Current Bot sotto Configurations nell'editor di codice.
- Selezionare bot.config.json in Configurazioni e scorrere fino a "messaggistica".
- Aggiungere un oggetto "channels" (che conterrà un oggetto "smooch")
- In Smooch, creare un valore booleano chiamato "enabled" e assegnargli il valore true.
- Creare le stringhe "keyId" e "secret" (che prenderanno ID e secret dalla chiave API generata in precedenza in Smooch)
- Salvare bot.config.json
- Navigare in Configurazioni
- Aprire botpress.config.json
- Cercare "externalUrl" (sarà impostato su una stringa vuota).
- Salvare il file
- Riavviare il server
- Aprire di nuovo il bot
- Fare clic su "treno ora".
- "Pronto" sostituirà "treno ora"
- Tornare a Smooch e verificare i webhook configurati automaticamente
- Vai alle integrazioni
- Selezionare WhatsApp e connettersi
- Scegliere la modalità di integrazione (esempio: io ho usato "Sandbox")
- Selezionate "Attiva Sandbox" e seguite le istruzioni per inviare un messaggio al numero specificato in WhatsApp.
- Controllare se il messaggio è stato ricevuto
- Ulteriori messaggi saranno inoltrati a webhook
- Ora puoi parlare con il tuo bot!
5. Parlare con il Bot
- Ponete al bot una delle vostre domande
- Leggi la risposta
- Ponetegli una domanda "sbagliata" e notate che non risponde.
Condividi questo articolo su:
Costruite gratuitamente il vostro chatbot AI personalizzato
Iniziate a costruire un bot GPT personalizzato con la nostra intuitiva interfaccia drag & drop.
Iniziare è gratis! 🤖Non è richiesta la carta di credito
Rimanete aggiornati sulle ultime novità in materia di IA chatbots