CRM レコードのメタデータを迅速に分析できるように、CCAI Platform のウェブ SDK、モバイル SDK、Apps API(チャット)は、CRM のカスタム フィールドにデータをプッシュできます。
カスタム フィールド マッピングを使用すると、CCAI Platform のカスタムデータキー(ポータル UI: カスタムデータ フィールド ラベル)を CRM フィールドまたはプロパティにマッピングして、マッピングされた値が適切な CRM レコードに自動的に書き込まれるようにできます。
カスタムデータキーは、次の方法で提供できます。
CCAI プラットフォームのウェブ SDK とモバイル SDK
Apps API(チャット): チャットでカスタムデータを送信するエンドポイントを使用します。
Mobile SDK API の例
以降のセクションでは、モバイル SDK に固有の例について説明します。
SDK からサーバーへのデータ
{
custom_data: { # same format with previous custom data from SDK
data_name: {
value: value,
type: string,
label: "Data Name",
},
device: { # example
value: "iOS",
type: "string",
label: "Device Type"}
}
}
サーバーから CRM アダプタへのデータ
{
key: {
crm_field: "crm custom field name",
type: "text", # text / checkbox ...,
value: "value"
},
device: { # example
crm_field: "device",
type: "text",
value: "iOS"
}
}
API エンドポイント
CRM のカスタム フィールド マッピングには、API を使用してアクセスできます。次のエンドポイントを使用できます。
すべてのフィールドを取得する: HTTP POST または GET:
/crm_custom_fields特定のフィールドを更新または削除する: HTTP PUT または DELETE
/crm_custom_fields/:id
Apps API(チャット)の例(SDK なし)
Apps API を直接使用しているお客様(CCAI Platform のウェブ SDK またはモバイル SDK を使用していないお客様)は、既存のチャット セッションのカスタムデータを送信することで、チャット インタラクションにカスタム フィールド マッピングを引き続き使用できます。
- エンドポイント:
POST /apps/api/v1/chats/:id/custom_data
リクエスト本文(保護なし / 署名なし)
{
"signed": false,
"data": {
"orderId": {
"label": "Order ID",
"value": "12345"
},
"customerTier": {
"label": "Customer Tier",
"value": "gold"
}
}
}
リクエスト本文(保護 / 署名付き JWT)
{
"signed": true,
"signed_data": "<JWT>"
}
JWT ペイロードの形状(例)
{
"custom_data": {
"orderId": { "label": "Order ID", "value": "12345" },
"customerTier": { "label": "Customer Tier", "value": "gold" }
},
"exp": 1734567890,
"iat": 1734560000
}
Apps API ペイロードにカスタム フィールド マッピングを適用する
CCAI Platform ポータルで、[Custom Data Field Label](カスタムデータキー)を Apps API ペイロード data オブジェクトの最上位キー(orderId や customerTier など)に設定し、選択した CRM フィールドまたはプロパティにマッピングします。
次に 2 つの例を示します。
- キーによるマップ:
orderId、customerTier - ネストされたラベルでマッピングしない:
"label": "Order ID"は表示テキストであり、マッピングには使用されません。
予約済みキー(顧客フラグ)
次のような予約済みのキーが表示されることがあります。
reserved_verified_customerreserved_bad_actorreserved_repeat_customer
これらのキーは主に、お客様のフラグの動作に使用されます。混乱を避けるため、特定のレポート作成ニーズがない限り、reserved_* キーを CRM カスタム フィールドとしてマッピングしないでください。CRM カスタム フィールドのマッピングには、ビジネス固有のキー(orderId、customerTier など)をマッピングすることをおすすめします。
カスタム CRM フィールド マッピングを構成する手順
CRM でカスタム フィールドと値を作成します。
CRM の連絡先に新しい値を割り当てます。
CCAI Platform ポータルで設定を構成します。
テストします。
Zendesk の構成
以降のセクションでは、Zendesk CRM のフィールド マッピングを構成するプロセスについて説明します。
ユーザー(連絡先)のカスタム フィールドを作成する
管理者として Zendesk にログインします。
をクリックして、管理オプションにアクセスします。
[ユーザー フィールド] を選択します。
作成するフィールド タイプを選択します。

エージェントのビューにフィールドのタイトルと名前を追加します。
[フィールドキー] は自動的に入力されます。
[Create field] をクリックします。
この新しいフィールドが [Active fields] リストに表示され、ユーザーを表示すると左側の列に表示されます。

チケットのカスタム フィールドを作成する
管理者として Zendesk にログインします。
アイコンをクリックして、管理オプションにアクセスします。
[Ticket Fields] を選択します。
[カスタム フィールドを追加] ボタンをクリックします。
[選択] をクリックして、作成するフィールド タイプを選択します。
[Field Title] を追加します。[Field Title] はエージェントのビューに表示されます。
API の crm_field と同じ値を使用することをおすすめします。

[フィールドを追加] ボタンをクリックします。
この新しいフィールドは [Active fields] リストに表示され、チケットを表示すると左側の列に表示されます。
Salesforce の構成
[設定] に移動します。
[オブジェクト マネージャー] を選択します。
カスタム フィールドを追加するオブジェクト(ケースまたは CCAI Platform セッション)を選択します。
[Fields & Relationships] をクリックします。
[New] をクリックします。
データ型として [テキスト] を選択します。
[Field Label] に、フィールドの名前を入力します。
[長さ] に「255」と入力します。
[フィールド ラベル] を入力すると、[フィールド名] が自動的に入力されます。

残りの変数はデフォルト値のままにしておきます。
[次へ] をクリックします。
オブジェクト(ケースまたは CCAI Platform セッション)にアクセスするプロファイルの [Visible] チェックボックスをオンにします。
[次へ] をクリックします。
[保存] をクリックします。
[Fields & Relationships] ビューに戻ります。作成したフィールドを見つけて、[フィールド名] をメモします。

[Field Name] は、CCAI Platform のカスタム フィールド マッピング ページの [CRM Field Label] に入力するものです。
次の例は、ケース オブジェクトで正しく設定して使用した場合の新しいフィールドを示しています。

Kustomer の構成
カスタム フィールドの設定に関する詳細と情報については、Kustomer ヘルプセンターをご覧ください。
CCAI プラットフォームの構成
以降のセクションでは、Kustomer CRM フィールド マッピングを構成するために CCAI Platform ポータルで必要な変更について説明します。
CCAI Platform ポータルで、[Settings] > [Operation Management] に移動します。
[CRM Custom Field Mapping] セクションに移動し、[View All] をクリックします。
[+ Add CRM Field Mapping] リンクをクリックします。
フィールド マッピングのタイトル: CCAI Platform ポータルで使用されるこのカスタム フィールド マッピングの CCAI Platform 名。
CRM フィールド ラベル: マッピング先の CRM フィールドの CRM 内のラベル。
カスタムデータ フィールド ラベル: マッピング元のカスタムデータ フィールド ラベル。
SDK の例:
data_name、device(custom_data objectから)Apps API(Chat)の例:
orderId、customerTier(Apps API リクエスト データ オブジェクトから)。
[保存] をクリックします。