Custom Objects は、Intercomの標準のPeopleおよびConversationオブジェクトを拡張し、ビジネスをより柔軟に表現するデータを保存できます。参照は、それらのオブジェクトがどのように関連しているかを定義し、関連データを適切な人に表示できるようにします。

参照タイプ

複数オブジェクトの参照

これはより一般的な参照タイプです。例えば、複数の注文が同じ人に属することがありますが、注文は一人の人にしか属しません。したがって、「Order」というCustom Objectを作成し、People referenceとOrder referenceの両方の属性を作成して相互に関連付けることができます。

「Order」というCustom Object内で：

People属性内で：

単一オブジェクトの参照

もう一つの参照タイプは「一対一」の参照です。例えば、システム内に多くの人がいて、フライト予約のためにパスポート情報を提供する必要がある場合です。

一人が同時に一つのパスポートしか持てず、パスポートも一人にしか属さないと仮定すると、「Passport」というCustom Objectを作成し、「passport_number」と「expiry_date」の属性を持たせ、'Allow referencing to multiple people'のトグルをオフにして人とリンクする参照を作成します。

People属性側でも、トグルをオフにして「Passport」オブジェクトへの参照を作成します。

「Passport」というCustom Object内で：

People属性内で：

参照タイプの編集

参照は保存後も名前を除いて編集可能です。トグルを編集すると既存の関連付けがすべて削除される可能性があるため注意してください。これにより、この属性を使用するボットやData connectorsが失敗することがあります。

ワークフローボタンでのCustom Objectsの使用

ワークフローボタンでCustom Objectsを使用する場合、Custom Objectタイプを参照する会話属性が2つ必要です：1つはオプション表示用、もう1つはユーザーの選択を保存するためです。

開始前に

Custom Objectタイプを参照する会話属性を2つ作成します：

表示属性 — データコネクタから返されるすべてのオプションを保存できるように「reference many」に設定します。これは顧客に表示されるボタンを生成するために使用されます。
選択属性 — 顧客の単一の選択を保存するために「reference one」に設定します。

データコネクタの設定

データコネクタ作成時の設定手順は次の通りです：

名前と説明 — コネクタにわかりやすい名前（例：「Get order options」）を付け、チームメイトがいつ使用すべきかを説明します。これは設定の最初に行います。
オブジェクトマッピング — APIのレスポンスフィールドを関連するCustom Object属性にマッピングします。重複を避けるためにIDをexternal_idフィールドにマッピングしてください。
PeopleまたはConversationsからの参照の更新 — これはオブジェクトマッピングセクションの最後のステップです。ここで表示属性（「reference many」）を選択すると、データコネクタがワークフローのボタンオプションを自動的に入力します。