HubSpot のルックアップ

HubSpot 統合は、プライマリ ルックアップとセカンダリ ルックアップで構成できます。これにより、連絡先レコードまたは会社プロファイルに基づいて発信者を識別できます。プライマリ ルックアップで結果が返されなかった場合、システムはセカンダリ ルックアップを試みます。 また、一致したプライマリ オブジェクトまたはセカンダリ オブジェクトのどの CRM アカウント表示フィールドをエージェント アダプタに表示するかを構成できます。最後に、プライマリ オブジェクトまたはセカンダリ オブジェクトが一致したかどうかに関係なく、エージェント アダプタに表示される CRM レコード表示フィールドを構成できます。 レコード表示フィールドは、開いている CRM レコード(チケットや商談など)に適用されます。

CRM アカウント表示フィールドは、プライマリ ルックアップ オブジェクトとセカンダリ ルックアップ オブジェクトを構成するときに構成します。CRM レコード表示 フィールドを構成するには、エージェント アダプタでCRM レコード表示フィールドを構成するをご覧ください。

始める前に

始める前に、HubSpot を Contact Center AI Platform(CCAI Platform)インスタンスと統合します。 詳細については、HubSpotをご覧ください。

プライマリ ルックアップ オブジェクトを構成する

プライマリ ルックアップ オブジェクトを構成できます。これは、セッションの開始時にシステムが最初に検索するオブジェクトです。エージェント アダプタに表示する CRM アカウント表示フィールドを構成することもできます。次の手順では、両方の方法について説明します。

プライマリ ルックアップ オブジェクトと CRM アカウント表示フィールドを構成する手順は次のとおりです。

  1. CCAI Platform ポータルで、[設定] > [デベロッパー設定] をクリックします。 [**設定**] メニューが表示されない場合は、 [**メニュー**] をクリックします。

  2. [CRM] ペインで、[アカウント ルックアップ] セクションに移動します。

  3. プライマリ ルックアップ オブジェクトを構成する手順は次のとおりです。

    1. [プライマリ ルックアップ オブジェクト] セクションを開きます。

    2. [オブジェクト タイプ] リストで、ルックアップするオブジェクトのタイプを選択します。

    3. [電話番号ルックアップ フィールド] リストで、エンドユーザーの電話番号との照合に使用するフィールドを選択します。

    4. [電話番号のプライマリ フィールド] リストで、システムが新しい CRM アカウントを作成するときに顧客の電話番号が保存されるフィールドを選択します。

    5. [**電話番号の形式**] で、リクエストの電話番号の形式を選択します。

    6. 省略可: SDK セッションのカスタム フィールドでエンドユーザーを検索するには、次の操作を行います。

      1. [モバイル / ウェブ SDK: SDK セッションのカスタム フィールドでユーザーを検索する] チェックボックスをオンにします。

      2. [CRM のカスタム ルックアップ フィールド] リストで、カスタム ルックアップ フィールドを選択します。

  4. エージェント アダプタで CRM アカウント表示フィールドを構成する手順は次のとおりです。

    1. [CRM アカウント表示フィールド] セクションの [一致したアカウント表示フィールド] リストで、アカウントのメイン識別子を選択します。

    2. 省略可: 2 つ目のフィールドを表示するには、次の操作を行います。

      1. [2 つ目のフィールドを表示する] チェックボックスをオンにします。

      2. [2 つ目の表示フィールド] リストで、表示する 2 つ目のフィールド タイプを選択します。

      3. [**2 つ目のフィールドの表示位置**] で、エージェント アダプタにフィールドを表示する順序を選択します。

  5. [保存] をクリックします。

セカンダリ ルックアップ オブジェクトを構成する

セカンダリ ルックアップ オブジェクトを構成できます。これは、プライマリ ルックアップで結果が返されなかった場合のフォールバックとして機能します。エージェント アダプタに表示する CRM アカウント表示フィールドを構成することもできます。次の手順では、両方の方法について説明します。

セカンダリ ルックアップ オブジェクトと CRM アカウント表示フィールドを構成する手順は次のとおりです。

  1. CCAI Platform ポータルで、[設定] > [デベロッパー設定] をクリックします。 [**設定**] メニューが表示されない場合は、 [**メニュー**] をクリックします。

  2. [CRM] ペインで、[アカウント ルックアップ] セクションに移動します。

  3. セカンダリ ルックアップ オブジェクトを構成する手順は次のとおりです。

    1. [セカンダリ ルックアップ オブジェクト] チェックボックスをオンにします。

    2. [電話番号ルックアップ フィールド] リストで、エンドユーザーの電話番号との照合に使用するフィールドを選択します。

    3. [電話番号のプライマリ フィールド] リストで、CCAI Platform が新しい CRM アカウントを作成するときに顧客の電話番号が保存されるフィールドを選択します。

    4. [**電話番号の形式**] で、リクエストの電話番号の形式を選択します。

    5. 省略可: SDK セッションのカスタム フィールドでエンドユーザーを検索するには、次の操作を行います。

      1. [モバイル / ウェブ SDK: SDK セッションのカスタム フィールドでユーザーを検索する] チェックボックスをオンにします。

      2. [CRM のカスタム ルックアップ フィールド] リストで、カスタム ルックアップ フィールドを選択します。

  4. エージェント アダプタで CRM アカウント表示フィールドを構成する手順は次のとおりです。

    1. [CRM アカウント表示フィールド] セクションの [一致したアカウント表示フィールド] リストで、アカウントのメイン識別子を選択します。

    2. 省略可: 2 つ目のフィールドを表示するには、次の操作を行います。

      1. [2 つ目のフィールドを表示する] チェックボックスをオンにします。

      2. [2 つ目の表示フィールド] リストで、表示する 2 つ目のフィールド タイプを選択します。

      3. [**2 つ目のフィールドの表示位置**] で、エージェント アダプタにフィールドを表示する順序を選択します。

  5. [保存] をクリックします。

エージェント アダプタで CRM レコード表示フィールドを構成する

プライマリ オブジェクトまたはセカンダリ オブジェクトが一致したかどうかに関係なく、エージェント アダプタに表示される CRM レコード表示フィールドを構成できます。エージェント アダプタに表示される CRM エージェント表示フィールドを構成するには、プライマリ ルックアップ オブジェクトを構成するとセカンダリ ルックアップ オブジェクトを構成するをご覧ください。

エージェント アダプタで CRM レコード表示フィールドを構成する手順は次のとおりです。

  1. CCAI Platform ポータルで、[設定] > [デベロッパー設定] をクリックします。 [**設定**] メニューが表示されない場合は、 [**メニュー**] をクリックします。

  2. [CRM] ペインで、[CRM レコード表示フィールド] セクションに移動します。

  3. [一致したレコード表示フィールド] リストで、レコードのメイン識別子を選択します。

  4. 省略可: 2 つ目のフィールドを表示するには、次の操作を行います。

    1. [2 つ目のフィールドを表示する] チェックボックスをオンにします。

    2. [2 つ目の表示フィールド] リストで、表示する 2 つ目のフィールド タイプを選択します。

  5. 省略可: 3 つ目のフィールドを表示するには、次の操作を行います。

    1. [3 つ目のフィールドを表示する] チェックボックスをオンにします。

    2. [3 つ目の表示フィールド] リストで、表示する 3 つ目のフィールド タイプを選択します。

  6. [保存] をクリックします。

ルックアップ カスケード ロジック

CCAI Platform がオブジェクト ルックアップに使用するカスケード ロジックについて説明します。

  • contact_id が指定されている場合、CCAI Platform は最初に直接 GET 呼び出しを行います。それ以外の場合、CCAI Platform は OR ロジックを使用して、電話、メール、SDK、SIP の識別子を検索します。

  • 一致するレコードが複数見つかった場合、CCAI Platform は最後に変更されたレコードを選択します。変更日は次のように決定されます。

    • 連絡先 は lastmodifieddate を使用します。

    • 会社 は hs_lastmodifieddate を使用します。