Come aggiungere Dashbot a Botpress per l'analisi dei chatbot

In questo articolo illustreremo i passaggi necessari per collegare Botpress a Dashbot, uno strumento di analisi specifico per i chatbot, con un livello gratuito. Includeremo un codice che potrete copiare e incollare, in modo da poter catturare correttamente i tipi di risposta ai contenuti più comuni con poco lavoro!

Perché usare qualcosa di diverso dalle analisi integrate di Botpress? Le analisi esterne consentono di estrarre i dati da Botpress e di utilizzarli nella piattaforma di vostra scelta. Se gestite diversi tipi di bot e desiderate unirli, o se volete un maggiore controllo sulle analisi, una soluzione dedicata come Dashbot può aiutarvi a gestire le vostre analisi con maggiore facilità e controllo.

Informazioni su Dashbot

Per i progetti più piccoli, Dashbot consente di monitorare il coinvolgimento per vedere come sta andando il bot in generale. È anche possibile consultare le singole conversazioni per avere una visione dell'andamento delle stesse. Se il vostro chatbot inizia ad avere un volume elevato, potete usare Dashbot per personalizzare le conversazioni a vostro piacimento. È come avere Power BI per l'analisi dei chatbot.

Dashbot è gratuito per 1000 messaggi/mese, quindi si può facilmente provare. Ha anche altri due livelli, uno per le piccole e medie chatbots con un tetto massimo di messaggi mensili molto più alto, e uno Enterprise personalizzato. Potete scegliere il piano che fa per voi.

Istruzioni

Creare il bot in Dashbot e ottenere la chiave API

1. Andate su reports.dashbot.io/signup e create il vostro account dashbot.
2. Fare clic su "Aggiungi chatbot".
3. Compilare il modulo e inviarlo
4. Scegliete un nome qualsiasi per il vostro chatbot. Questo è solo un riferimento.
5. Selezionare "Universal" per la piattaforma.
6. Scegliete una categoria adatta al vostro caso d'uso.
7. Selezionare prod o dev. Questo è solo un riferimento.
8. Tenere aperta la finestra dopo l'invio. Vi servirà per copiare la chiave api in seguito (due volte!) e anche per verificare e accedere all'analisi del chatbot.

Aggiungere il codice di connessione + la chiave API giusta in Botpress

1. Installate Botpress (se non l'avete ancora fatto!) e apritelo.
   
2. Creare (se non l'avete già fatto) e aprire il bot facendo clic sul suo nome.
3. Passare alla pagina dell'editor di codice.
4. Fare clic sul pulsante più accanto a "Ganci", selezionare "Ganci evento" -> "Prima del middleware in uscita".
5. Nominare il file dashbot-analytics-outgoing.js e inviarlo
6. Nell'editor del gancio appena creato, copiare il testo da qui e incollarlo nel contenuto principale del gancio.
7. Modificare il valore "DASHBOT_KEY" con quello ottenuto al punto 4.
8. [Se si sta provando per la prima volta, impostare DEBUG_DEV su true.
9. Premere Salva
10. Fare clic sul pulsante più accanto a "Ganci", selezionare "Ganci evento" -> "Dopo il Middleware in arrivo".
11. Nominare il file dashbot-analytics-incoming.js e inviare
12. Nell'editor del gancio appena creato, copiare il testo da qui e incollarlo nel contenuto principale del gancio.
13. Modificare il valore "DASHBOT_KEY" con quello ottenuto al punto 4.
14. [Se si sta provando per la prima volta, impostare DEBUG_DEV su true.
15. Premere Salva
16. Aprire l'emulatore e inviare un messaggio.

Assicurarsi che tutto funzioni in Dashbot

1. Tornare a Dashbot e fare clic su verifica.
2. Se il testo del pulsante non viene verificato, tornare indietro e assicurarsi di aver incollato la chiave api giusta e impostare DASHBOT_KEY su true prima di inviare un messaggio.
3. Fare clic sul pulsante "Visualizza rapporti" accanto al pulsante Verificato.
4. Divertitevi a spulciare le analisi dei vostri chatbot!

Importante - per la produzione

Il comportamento predefinito prevede l'invio di analisi solo se il flag di sviluppo è impostato su true (DEBUG_DEV nei due file middleware) o per la produzione, è necessario aggiungere una variabile d'ambiente chiamata EXPOSED_EXTERNAL_ANALYTICS e impostarla su true. La si può aggiungere dove normalmente si configurano le variabili d'ambiente di Botpress .

È tutto! Sentitevi liberi di riutilizzare questo codice per altri scopi di tracciamento. Si possono anche inviare le analisi a Google Analytics, Segment o qualsiasi altra soluzione personalizzata. È sufficiente adattare le funzioni di sendAnalytics alla propria implementazione.

‍