Webhooksを使用して、WalkMeイベントデータをサードパーティーシステムに送信する方法

Download as PDF

概要

Webhooks（別名コールバック）を作成したり、カスタマイズしたりして、特定の結果をトリガーするために使用するサードパーティシステムにWalkMeのイベントデータを送信することにより、リアルタイムでデータに基づいた意思決定を行ったり、その場で体験したりすることができます。

イベント自体がトリガーするWebhooksなら、任意のシステムにリアルタイムのWalkMeイベント情報を配信できます。 つまり、 遅延なく情報を受け取ることにより、チームは即時性が重要な情報に対して即座に対応できるようになります。

Webhooksは分析/BIツールにWalkMeイベントデータを追加したり、サードパーティのAPIをトリガーしたりすることに使用できます。 これでユーザーがShoutOutをクリックすると、メールマーケティングシステムのメールリストに追加したり、NPSアンケートに回答した際にSlackチャネルに即座に通知を送信したりすることができます。 Webhooksを使用すると、研究開発の手間をかけずにワークフローにWalkMeを直接構築できます。

Webhooksの詳細については、次の記事を参照してください：Webhooksとは？

ユースケース

• WalkMeイベントデータを分析BI ツールに統合する
• ユーザーがWalkMeを利用した際に、メールリストにユーザーを追加する
• ユーザーがアクションを実行した後に、即座に通知をSlackチャネルに直接送信する

Webhooksを使用してWalkMeデータを送信する手順

1. 1. Insights.walkme.comにあるInsightの統合ページに移動します
      
   2. リアルタイムのインテグレーションの下にあるWebhooksをクリックします
      
   3. +新しいWEBHOOkをクリックします
      
   4. Webhookに名前を付けて、続行をクリックします
   5. Webhookイベント詳細を入力します
      1. イベントドロップダウンメニューからWalkMeイベントを選択します。
      2. オプション条件の追加
      3. 高度>ドロップダウンセクションでは、選択したイベントのプロパティを指定できます
         • 送信先システムの期待される属性に一致するようにプロパティの名前を変更できます。
         • 名前を変更しない場合、これらはWebhookコールで受け取ることになる値です。
         • +プロパティを追加ボタンを使用して、Webhookコールと一緒に送信する追加の静的プロパティを設定することもできます。
           • プロパティ名にスペースは使用できません。
           • 「_」またはcamelCaseを使用して単語を区切ることをお勧めします。
   6. ［Continue（続行）］をクリックします。
   7. Webhook送信先詳細を入力します
      1. 接続先プラットフォーム名を入力します
         • これは、Heap Analytics、Mixpanel、またはGoogle Analyticsなどのイベントデータを送信するサードパーティプラットフォームです
      2. リクエストタイプと接続先URLを入力します
         • これらはWebhookコールをどのように、そしてどこに行うかを指定します
         • これらの詳細は、接続先システムのAPIドキュメントに記載されています
      3. オプションの認証タイプを選択します
         • これが必要かどうかを理解するには、接続先システムのAPIドキュメントを参照してください
         • WalkMeは以下の認証方法に対応しています。
           • 認証なし
           • Bearerトークン：トークンが必要です
           • 基本認証：ユーザー名とパスワードが必要です
           • OAuth 2.0
      4. ［+ ADD PROPERTY（+プロパティを追加）］ボタンを使用して、任意のオプションヘッダーを入力します
         • これらは、Webhookコールを実行するために必要な値です
         • 接続先システムのAPIドキュメントを参照して、必要かどうかを確認します
   8. ［Save（保存）］をクリックします。
   9. エディタでパブリッシュ設定の実行を求められます
      • このステップは、最初に作成したWebhookにのみ必要です
      • 詳細については、次の記事を参照してください：グローバル設定のパブリッシュ方法

Webhookが正常に設定されたことを確認するには、次の手順に従います：

1. アプリケーションを入力します
2. Webhookが追跡しているイベントを実行します
3. 設定した接続先システムがWebhookコールを受信し、目的の結果を実行していることを確認します

利用可能なイベント一覧

以下の表には、Webhookイベントを作成する際に利用可能なすべてのオプションが表示されています。