HubSpot カスタム フィールドのマッピング

HubSpot カスタム フィールド マッピングは、CCAI Platform セッション データの既存のカスタム フィールド マッピング機能(以前は Salesforce、Zendesk、Kustomer で利用可能)を HubSpot に拡張します。

この機能を使用してできること:

  • CCAI Platform SDK(モバイルまたはウェブ)または Apps API(チャット) Send custom data in a chat エンドポイントから HubSpot のカスタム プロパティに送信される顧客データをマッピングします。

  • CCAI Platform セッション データ(顧客 ID、キュー名、SDK または Apps API を使用して渡すその他のカスタム パラメータなど)を HubSpot のチケット フィールドまたはディール フィールドに自動的に入力します。

  • 他の CRM で使用している可能性がある同じカスタム フィールド マッピング ワークフローを使用して、プラットフォーム間で CRM の同等性を維持します。

このガイドでは、次の方法について説明します。

  • HubSpot の [カスタム フィールド マッピング] ページにアクセスします。

  • カスタム フィールド マッピングを作成、編集、削除する。

  • 実行時のマッピングの動作と、マッピングが機能していることを確認する方法について説明します。

始める前に

開始する前に、以下の要件を満たしていることを確認してください。

アカウントとライセンス

  • CRM エージェント プラットフォームとして CCAI Platform に接続された HubSpot アカウントが必要です。

  • HubSpot のチケット オブジェクトまたはディール オブジェクトには、HubSpot で作成済みの必要なカスタム プロパティが必要です(この機能では、HubSpot でプロパティは作成されません)。

システムとユーザーの設定

カスタム フィールド マッピングを構成するには、次のシステムとユーザーの設定が必要です。

  • 管理者権限。管理者権限を持つアカウントで CCAI Platform にログインする必要があります。
  1. アクセス: [設定] > [オペレーション管理]。

  2. CRM 構成を管理する。

  • HubSpot が CRM として設定されている。
  1. CCAI Platform 管理ポータルで、CRM エージェント プラットフォームとして HubSpot を選択する必要があります。

  2. HubSpot の統合が完全に承認され、接続されている必要があります。

  • データソースを設定する。

  • ウェブまたはモバイル SDK の実装、または Apps API(Chat)の統合により、HubSpot にマッピングするカスタム データ フィールドを送信する必要があります。

  • マッピングする各フィールドのカスタムデータキー(ペイロードの最上位キー名)を把握しておく必要があります(例: customer_id、plan_type)。

コンテンツとアセット(省略可)

CCAI Platform のデータを入力する HubSpot のカスタム プロパティ(チケットまたはディール)のリストが必要です。

HubSpot のカスタム フィールド マッピングを作成する

HubSpot のカスタム フィールド マッピングを作成する手順は次のとおりです。

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

  2. [カスタム フィールド マッピング] ペインに移動し、[すべて表示] をクリックします。[カスタム フィールド マッピング] ページが表示されます。

  3. [Add CRM Field Mapping] をクリックします。[CRM カスタム フィールドを追加] ダイアログが表示されます。

  4. [フィールド マッピングのタイトル] フィールドに、カスタム フィールドのわかりやすい名前を入力します。次の例をご覧ください。

    • お客様 ID の場合: HubSpot ticket customer ID

    • キュー名の場合: HubSpot deal queue name

  5. [Custom Field Name] フィールドに、SDK カスタム フィールド データを書き込む HubSpot カスタム フィールドの名前を入力します。

  6. [カスタムデータ フィールド ラベル] フィールドをクリックします。SDK カスタムデータ フィールドのラベルのリストが表示されます。

  7. HubSpot カスタム フィールドにマッピングする SDK カスタムデータ フィールドの名前を選択します。実行時に、SDK がこのカスタムデータを送信すると、システムはマッピングされた HubSpot カスタム フィールドに書き込みます。

  8. [保存] をクリックします。新しいマッピングが [カスタム フィールド マッピング] ページに表示されます。

HubSpot のカスタム フィールド マッピングを編集する

HubSpot のカスタム フィールド マッピングを編集する手順は次のとおりです。

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

  2. [カスタム フィールド マッピング] ペインに移動し、[すべて表示] をクリックします。

  3. 編集するマッピングの [編集] をクリックします。[CRM カスタム フィールドの編集] ダイアログが表示されます。

  4. マッピングを編集して、[保存] をクリックします。

HubSpot のカスタム フィールド マッピングを削除する

HubSpot のカスタム フィールド マッピングを削除する手順は次のとおりです。

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

  2. [カスタム フィールド マッピング] ペインに移動し、[すべて表示] をクリックします。

  3. 削除するマッピングの [削除] をクリックします。

  4. 削除を確認します。