ユーザージャーニーと情報フロー

各アプリには独自の機能がありますが、カスタマーエクスペリエンスは、同じ種類のアプリに対して同じ全体的なフローに従います。ほとんどのアプリには、インストールまたはセットアップフェーズと実行フェーズがあります。

アプリのインストールとセットアップ

アプリのインストール、セットアップ、および構成フェーズでは、ユーザーがアプリをアカウントに接続し、アプリのアクセス許可を設定し、アプリまたはアプリが接続するプラットフォームの資格情報を入力し、アカウントレベルのアプリ設定を定義します。

アプリのインストール

アプリのインストールとセットアップは、アプリが私的使用のみを目的としているか、Exchange マーケットプレースに登録する予定かによって異なります。

プライベートアクセスアプリ

アプリがユーザー専用の場合、インストールとセットアップは省略可能です。

構成ページにアクセスするには、[公開] タブで、アプリの 3 ドットメニューをクリックし、[構成] を選択します。

設定ページは、Web インターフェイス内で iframe として読み込まれます。

一般公開されているアプリ

アプリが Exchange マーケットプレースにリストされている場合、顧客がアプリを使用するにはインストールが必要です。セットアップ手順はオプションですが、強くお勧めします。

アプリのアクティベーション

ユーザーは、Exchange マーケットプレースでリストを見つけ、追加ボタンをクリックすることで、アプリをアクティブ化できます。Answers チャットボットブロックとConversations コンテキストカードの場合、アプリはすぐに使用可能になり、Answers または Conversations 内に表示されます。

使用するコンポーネント:

アプリシェル

アプリのセットアップ

アプリの構成ページが定義されている場合、ユーザーはアプリをインストールした直後にアプリのセットアップにアクセスします。ユーザは [設定(Configuration)] ページに転送され、Web インターフェイス内に iframe として読み込まれます。

ユーザーは、Exchange の [マイアプリ] タブでインストールされているアプリを見つけることで、いつでも構成ページにアクセスできます。設定ページを再度開くには (使用可能な場合)、リストの [開く] ボタンをクリックします。設定ページは、Web インターフェイス内で iframe として読み込まれます。

使用するコンポーネント:

アプリシェル
構成ページの UI
アプリ設定データベース

アプリの実行

次のセクションでは、アプリの実行フェーズで何が起こるか、およびアプリの種類に必要なコンポーネントについて説明します。

コンテキストカード
Answers チャットボットブロック
Moments - フローエレメント
People データ同期

コンテキストカードの実行 (iframe の読み込み)

コンテクストカードに Infobip アカウント、Conversations エージェント、またはエンドユーザーに関する情報が必要な場合は、OAuth フローを実装してこの情報を取得する必要があります。

コンテクストカードの実行中に使用されるコンポーネント

アプリシェル
積荷目録
コンテキストカード UI
アプリ設定データベース (使用する場合)

Answers チャットボットブロック作成

Answers チャットボットブロックは、Answers チャットボットエディターでチャットボットデザイナーが使用できます。設計者は、チャットボットフロー全体の任意のステップにチャットボットブロックを配置し、チャットボット属性のリストから入力フィールドと出力フィールドを選択し、使用するチャットボットをアクティブ化できます。チャットボットの設定中に、Answersは、そのアカウントに対してアクティブ化されたすべてのチャットボットブロックをチャットボット要素として表示します。ブロックがチャットボットフローに追加されると、ユーザーはアプリのマニフェストで定義されているように、要求と応答の属性を選択できます。

Answers チャットボットブロック作成時に使用されるコンポーネント

アプリシェル
積荷目録
API エンドポイント

Answers チャットボットブロック実行

Answers チャットボットブロックがアクティブで、ユーザーがそれと相互作用すると、チャットボットブロックがアクティブになります。Answers は、チャットボットの動的属性を使用して入力フィールドに入力し、エンドポイントまたはミドルウェアへの API 呼び出しを構築します。必要に応じて、ミドルウェアは Answers からの呼び出しを API エンドポイントの正しい形式に変換できます。一般的な翻訳は次のとおりです。

アプリ設定データベースから API 要求へのアカウントの詳細の追加
アプリ設定データベースから API 要求へのアプリ設定の追加
API エンドポイントでヘッダーパラメーターを使用する場合の API 要求の再構築 (現在、Exchange では Query パラメーターと Path パラメーターのみがサポートされています)

Answers チャットボットブロックの実行中に使用されるコンポーネント

アプリシェル
積荷目録
API エンドポイント
API ミドルウェア (使用する場合)
アプリ設定データベース (使用する場合)

Answers チャットボットブロック実行中に使用可能なデータ

Infobip 内からアプリを実行すると、マニフェストで指定した request/uri からエンドポイントが呼び出され、アカウントを識別する情報が送信されます。

署名は、次の 2 つの要素に基づいて作成されます。

タイムスタンプ値
要求本文

署名は、"X-Ib-Exchange-Req-Signature" と呼ばれる 3 つのヘッダーの 1 つにあります。このヘッダーには、タイムスタンプ値の後に使用している要求本文が含まれ、データとして空白や区切り文字はありません (タイムスタンプ + 本文)。

ヘッダー：

X-IB-Exchange-Req-AccountKey: [暗号化されたアカウント ID]
X-IB-Exchange-Req-Signature: [暗号化されたタイムスタンプ + 本文]
X-Ib-Exchange-Req-タイムスタンプ: [生のタイムスタンプ]

例：


    {
      "user-agent": "Java-http-client/20",
      "content-length": "21",
      "content-type": "application/json",
      "x-forwarded-for": "193.105.74.4",
      "x-forwarded-host": "appendpoint.free.beeceptor.com",
      "x-forwarded-proto": "https",
      "x-ib-exchange-req-accountkey": "D8ADC25936426DE0279BC0C4EA791D9B",
      "x-ib-exchange-req-signature": "e5adabc728a6f1a561f13b043e11c1acb0a5cff61948aec691c86d2bd8ff3fcd",
      "x-ib-exchange-req-timestamp": "1689697378017",
      "accept-encoding": "gzip"
    }

体：

request body: [生データ]
要求サンプル: {"email":"test@test.com"}
リクエストサンプル: {"order_id": "1212721005877-01"}

例：


    {
      "order_id": 152512
      "email": "test@test.com"
    }

署名メッセージを検証する

アプリの署名シークレットを取得します (App Shell で使用可能)。
X-Ib-Exchange-Req-Timestamp ヘッダーからタイムスタンプを抽出します。
タイムスタンプと使用している要求本文を、スペースや区切り文字を入れずに連結して、base_stringとして使用します。たとえば、タイムスタンプ: 1667951050990 と要求本文: {"email":"test@test.com"} の場合は 1667951050990{"email":"test@test.com"} です。
HmacSHA256アルゴリズムでお気に入りのMAC(メッセージ認証コード)実装を使用して、署名シークレットを秘密鍵として使用して上記のbase_stringを小文字の16進数文字列に署名/ハッシュします。
この 16 進数のテキストを取得したら、リクエストで送信した X-Ib-Exchange-Req-Signature ヘッダーと比較できます。

フローエレメント作成

フローエレメントは、Moments のフローエディターで使用できます。

フローデザイナーは、顧客体験に機能を追加し、サイドパネルに表示される入力フィールドと出力フィールドを選択できます。各関数は、[統合] の [エレメントの選択] リストに表示されます。

フローエレメントが顧客体験で使用される場合、ユーザーはマニフェストで定義されているフィールドを選択できます。

フローエレメント作成時に使用されるコンポーネント

アプリシェル
積荷目録
API エンドポイント

フローエレメント実行

トリガーイベントが顧客体験フローを開始すると、要求された属性が入力されます。フローがフローエレメントを検出すると、属性を使用して入力フィールドに入力し、エンドポイントまたはミドルウェアへの直接のAPI呼び出しを構築します。ミドルウェアは、フローからの呼び出しを、アプリ設定データベースからアカウントの詳細またはアプリ設定を追加する API エンドポイントの正しい形式に変換できます。

フローエレメント実行中に使用されるコンポーネント

アプリシェル
積荷目録
API エンドポイント
API ミドルウェア (使用する場合)

People データ同期の実行

アプリのニーズに応じて、サードパーティのプラットフォームから People CDP にデータをプッシュしたり、People CDP からサードパーティのプラットフォームにデータをプッシュしたり、またはその両方を行ったりすることができます。アプリミドルウェアは、2 つのプラットフォーム間のデータのフローを調整します。プラットフォーム資格情報とデータマッピングの設定は、[アプリのセットアップ](./ユーザージャーニーフロー#アプリのセットアップアプリのインストールとセットアップ) フェーズで定義する必要があります。

サードパーティのプラットフォームからデータをプッシュするには、サードパーティで使用可能なツールを使用して最近の変更を特定し、 People API (opens in a new tab) を使用してプロファイル情報を作成または更新します。
People API プラットフォームからサードパーティプラットフォームにデータをプッシュするには、新しい個人プロファイルまたは変更された個人プロファイルを定期的にチェック (opens in a new tab) します。modifiedAt と createdAt を使用して最近の変更を特定し、サードパーティプラットフォームのツールを使用してデータをプッシュします。

People データ同期の実行中に使用されるコンポーネント

アプリシェル (省略可能、マーケットプレースの登録情報にのみ使用)
API ミドルウェア
API エンドポイント
アプリ設定データベース (使用する場合)

API 認証トラブルシューティング