Botpress 、Dashbotをチャットボット分析に追加する方法

この記事では、Botpress を Dashbot（チャットボット専用の分析ツール）に接続するために必要な手順を、無料層で詳しく説明します。コピー＆ペースト可能なコードも含まれていますので、ほとんど作業をすることなく、最も一般的なコンテンツのレスポンスタイプを適切にキャッチすることができます！

なぜBotpress の内蔵アナリティクス以外を使うのですか？外部アナリティクスを使用すると、Botpress からデータを取り出し、お好みのプラットフォームで使用することができます。異なる種類のボットを運用しており、それらを統合したい場合、またはアナリティクスをよりコントロールしたい場合は、Dashbot のような専用のソリューションを使用すると、アナリティクスをより簡単に管理できます。

ダッシュボットについて

小規模なプロジェクトであれば、Dashbot を使ってエンゲージメントを監視し、ボットが一般的にどのように動作しているかを確認することができます。また、個々の会話を調べて、会話の状況を視覚的に理解することもできます。チャットボットのボリュームが多くなってきたら、Dashbot を使って会話を自分好みにカスタマイズすることができます。チャットボットの分析にPower BIを使っているようなものだと考えてください。

Dashbot は月額1000メッセージまで無料なので、気軽に試すことができます。Dashbot には、月間メッセージ数の上限がより高い小規模・中規模chatbots 向けのプランと、エンタープライズ向けのプランがあります。お好みのプランをお選びください。

使用方法

Dashbotでボットを作成し、APIキーを取得する

1. reports.dashbot.io/signupにアクセスし、dashbotアカウントを作成してください。
2. チャットボットを追加」をクリックします。
3. フォームに記入して送信する
4. チャットボットの名前を自由に決めてください。これは参考用です。
5. プラットフォームは「ユニバーサル」を選択する。
6. あなたのユースケースに合ったカテゴリーを選んでください。
7. prodまたはdevを選択してください。これは参考用です。
8. 送信後のウィンドウは開いたままにしておいてください。後で api キーをコピーしたり（2回！）、チャットボットのアナリティクスを確認したり、アクセスしたりするために必要です。

接続コードと正しいAPIキーをBotpress

1. Botpressをインストールし（まだなら！）、開く。
   
2. ボットを作成し（まだ作成していない場合）、名前をクリックしてボットを開きます。
3. コードエディターのページに移動する。
4. フック "の横にあるプラスボタンをクリックし、"イベント・フック"→"送信ミドルウェアの前 "を選択する。
5. ファイル名をdashbot-analytics-outgoing.jsとし、送信する。
6. 新しく作成したフックのエディターで、ここからテキストをコピーし、フックのメインコンテンツに貼り付けます。
7. DASHBOT_KEY "の値をステップ4で取得した値に変更します。
8. [推奨】初めて試す場合は、DEBUG_DEVをtrueに設定する。
9. セーブを押す
10. フック "の横にあるプラスボタンをクリックし、"イベントフック"→"着信ミドルウェア後 "を選択する。
11. ファイル名をdashbot-analytics-incoming.jsとし、submitする。
12. 新しく作成したフックのエディターで、ここからテキストをコピーし、フックのメインコンテンツに貼り付けます。
13. DASHBOT_KEY "の値をステップ4で取得した値に変更します。
14. [推奨】初めて試す場合は、DEBUG_DEVをtrueに設定する。
15. セーブを押す
16. エミュレーターを開き、メッセージを送信する。

Dashbotですべてが動作することを確認する

1. Dashbotに戻り、検証をクリックする。
2. ボタンのテキストが検証された状態で表示されない場合は、メッセージを送信する前に、正しいapiキーを貼り付け、DASHBOT_KEYをtrueに設定したことを確認してください。
3. 検証済みボタンの隣にある「レポートを表示」ボタンをクリックします。
4. チャットボットの分析を楽しんでください！

重要 - 生産のために

デフォルトの動作は、developmentフラグがtrueに設定されている場合（2つのミドルウェア・ファイルのDEBUG_DEV）、またはProductionの場合、EXPOSED_EXTERNAL_ANALYTICSという環境変数を追加し、trueに設定する必要があります。この環境変数は、通常Botpress 環境変数を設定する場所に追加できます。

以上です！このコードは他のトラッキング目的にも自由に再利用できます。Google AnalyticsやSegment、あるいはカスタムソリューションにアナリティクスを送信することもできます。あなたの実装に合わせてsendAnalytics関数を調整するだけです。

‍