Jak dodać Dashbota do Botpress w celu analizy chatbotów?

W tym artykule opiszemy szczegółowo kroki potrzebne do połączenia Botpress z Dashbotem, narzędziem analitycznym specyficznym dla chatbota, z bezpłatną warstwą. Zamieszczamy kod, który można skopiować i wkleić, aby prawidłowo wychwycić najpopularniejsze typy odpowiedzi na treści przy niewielkim lub zerowym nakładzie pracy!

Dlaczego warto korzystać z czegoś innego niż wbudowana analityka Botpress? External Analytics pozwala wyciągać dane z Botpress i wykorzystywać je na wybranej platformie. Jeśli prowadzisz różne rodzaje botów i chcesz je połączyć lub chcesz mieć większą kontrolę nad analityką, dedykowane rozwiązanie, takie jak Dashbot, może pomóc w zarządzaniu analityką z większą łatwością i kontrolą.

Informacje o Dashbot

W przypadku mniejszych projektów Dashbot pozwala monitorować zaangażowanie, aby zobaczyć, jak ogólnie radzi sobie bot. Możesz także przeglądać poszczególne konwersacje, aby uzyskać wizualne zrozumienie ich przebiegu. Jeśli twój chatbot zaczyna przybierać dużą objętość, możesz użyć Dashbota, aby dostosować rozmowę do swoich upodobań. Możesz myśleć o tym jak o Power BI do analizy chatbotów.

Dashbot jest darmowy dla 1000 wiadomości / miesiąc, więc można go łatwo wypróbować. Ma również dwa inne poziomy, jeden dla małych i średnich chatbots ze znacznie wyższym miesięcznym limitem wiadomości oraz niestandardowy Enterprise. Możesz wybrać plan, który Ci odpowiada.

Instrukcje

Tworzenie bota w Dashbot i pobieranie klucza API

1. Przejdź do strony reports.dashbot.io/signup i utwórz swoje konto dashbot.
2. Kliknij "Dodaj chatbota".
3. Wypełnij formularz i prześlij go
4. Wybierz dowolną nazwę dla swojego chatbota. To jest tylko w celach informacyjnych.
5. Jako platformę wybierz "Uniwersalną".
6. Wybierz kategorię, która pasuje do Twojego przypadku użycia.
7. Wybierz prod lub dev. Służy to wyłącznie jako odniesienie.
8. Zachowaj otwarte okno po przesłaniu. Będzie ono potrzebne do późniejszego skopiowania klucza api (dwukrotnie!), a także do weryfikacji i uzyskania dostępu do analityki chatbota.

Dodanie kodu połączenia + właściwego klucza API w Botpress

1. Zainstaluj Botpress (jeśli jeszcze tego nie zrobiłeś!) i otwórz go.
   
2. Utwórz (jeśli jeszcze tego nie zrobiłeś) i otwórz bota, klikając jego nazwę.
3. Przejdź do strony edytora kodu.
4. Kliknij przycisk plusa obok "Hooks", wybierz "Event Hooks" -> "Before Outgoing Middleware".
5. Nazwij swój plik dashbot-analytics-outgoing.js i prześlij go.
6. W edytorze nowo utworzonego haka skopiuj tekst stąd i wklej go do głównej treści haka.
7. Zmień wartość "DASHBOT_KEY" na tę uzyskaną w kroku 4.
8. [Zalecane] Jeśli wypróbowujesz go po raz pierwszy, ustaw DEBUG_DEV na true
9. Zapisz
10. Kliknij przycisk plusa obok "Hooks", wybierz "Event Hooks" -> "After Incoming Middleware".
11. Nazwij swój plik dashbot-analytics-incoming.js i prześlij go.
12. W edytorze nowo utworzonego haka skopiuj tekst stąd i wklej go do głównej treści haka.
13. Zmień wartość "DASHBOT_KEY" na tę uzyskaną w kroku 4.
14. [Zalecane] Jeśli wypróbowujesz go po raz pierwszy, ustaw DEBUG_DEV na true
15. Zapisz
16. Otwórz emulator i wyślij wiadomość.

Upewnienie się, że wszystko działa w Dashbocie

1. Wróć do Dashbota i kliknij przycisk weryfikacji.
2. Jeśli tekst przycisku nie zostanie zweryfikowany, wróć i upewnij się, że wkleiłeś właściwy klucz api i ustaw DASHBOT_KEY na true przed wysłaniem wiadomości.
3. Kliknij przycisk "Wyświetl raporty" znajdujący się obok przycisku Zweryfikowane.
4. Miłej zabawy podczas przeglądania analityki chatbota!

Ważne - dla produkcji

Domyślnym zachowaniem jest wysyłanie analiz tylko wtedy, gdy flaga deweloperska jest ustawiona na true (DEBUG_DEV w dwóch plikach oprogramowania pośredniczącego) lub w przypadku produkcji należy dodać zmienną środowiskową o nazwie EXPOSED_EXTERNAL_ANALYTICS i ustawić ją na true. Można ją dodać tam, gdzie zwykle konfiguruje się zmienne środowiskowe Botpress .

To wszystko! Zachęcamy do ponownego wykorzystania tego kodu do innych celów śledzenia. Możesz nawet wysłać swoje dane analityczne do Google Analytics, Segmentu lub dowolnego niestandardowego rozwiązania. Wystarczy dostosować funkcje sendAnalytics, aby pasowały do Twojej implementacji.

‍