メインコンテンツにスキップ

カスタムオブジェクトの設定

カスタムオブジェクトで外部データを特定のユースケースに合わせてモデル化・保存する方法。

対応者:Beth-Ann Sher

Custom Objectsは、エンジニアリングリソースやカスタム統合を構築することなく、ビジネスに適した方法で外部データをインポート・モデル化する柔軟な手段を提供し、Intercomをよりカスタマイズ可能にします。

設定が完了すると、より正確で単一の顧客ビューが得られ、Intercomのすべての機能がよりコンテキストに即したものとなり、より良い顧客体験とチームメンバーの強力な機能を実現します。Custom Objectsを使えば、複雑な問い合わせを解決するボットを構築し、高度なサポート workflows を作成し、Inboxでのサポート担当者の時間を節約できます。

例えば、eコマースの購入者は次のことができます:

  • 注文状況や配達予定日を確認する。

  • アカウントに関連付けられた複数の注文を表示し、その中から選択する。

  • 注文をキャンセルする。

カスタムオブジェクトの作成

開始するには、設定 > データ > Custom Objectsに移動してください。

「新しいオブジェクトを作成」をクリックして最初のCustom Objectを作成します。オブジェクトに名前(例:Order)を付け、「保存」をクリックします。

注意:オブジェクト名は後でworkflows内で識別するためのものです。一意の名前でなければならず、保存後は名前を変更できません。

これにより、いくつかの推奨されるデフォルト属性を持つ新しい親オブジェクトが作成されます:

  • ‘external_id’

  • ‘external_created_at’

  • ‘external_updated_at’

独自の属性を作成する

「+ 属性を作成」をクリックして独自の属性を追加できます。

この属性の形式を選択します。次の中から選べます:

  • テキスト - 注文が「キャンセル」または「オープン」などの簡単な情報を表示するため。

  • 数値 - 注文IDなどの数値を表示するため。

  • 小数点数 - 注文価格などの小数を含む数値を表示するため。

  • リスト - 複数の値を表示するため。

  • ブール値 - 真または偽の値を表示するため。

  • 日付 - 日付を表示するため。

  • 参照 - このオブジェクトを他の標準オブジェクトまたはCustom Objectとリンクするため。

属性に一意の名前を付け、その機能を説明します。この例では、注文が発送されたかどうかを示すためにブール形式を使用します:

注意:属性名は一意の識別子であり、保存後は名前を変更できません。

異なるタイプの属性を作成・保存し続けることができ、これらはCustom Objectの下に表示されます。

Custom Objectを他のオブジェクトに関連付ける

Custom Objectをbotフローで使用し、顧客に選択可能なオブジェクトデータを自動的に提示するには、Custom Objectと他のデータオブジェクト(PeopleおよびConversation)との間に参照を作成する必要があります。Custom Objectsの参照設定方法はこちら。

「+ 属性を作成」を再度クリックしてオブジェクト間の参照を作成します。

ドロップダウンで「参照」形式タイプを選択します:

リストから関連付けるオブジェクトを選択します。注:これには標準オブジェクトの‘People’と‘Conversation’および他のCustom Objectsが含まれます。

  • 新しい参照属性を作成します:

    • 参照に名前を付けます。

    • オプション: 複数のPeopleを参照可能 = オフ

    • オプション: 複数のPeopleを参照可能 = オン

    • 注:デフォルトでは「複数あり」がオンになっています。

重要:参照の方向は重要な場合があります。参照属性は、上記の手順と同様にPeopleおよびConversationオブジェクトにも追加できます。これを行うには、設定のこれらのデータオブジェクトに移動して属性を作成してください。

  • People

  • Conversation

  • Custom Object

Custom Objectにデータ値を入力する

次に、Custom Objectにデータを入力する必要があります。これは現在、GETリクエストを介して外部システムからデータを取得するData connectorを使用してのみ可能です。
Messenger JSスニペットによる入力は現在利用できません。

Data connectorの使用

Data connectorはエンドポイントからオブジェクトの配列を返し、その応答データをCustom Objectにマッピングできます。Data connectorの設定方法はこちら

API取得の制限事項

注意: workflowsやData connectorで設定された属性はUIに表示される場合がありますが、Data connectorが正しいconversation参照属性にデータを保存するようにマッピングされていない限り、APIレスポンスでは利用できません。

  1. Data connectorのマッピングを確認してください。

  2. 参照属性の設定(単一か複数か)を確認してください。

  3. APIの権限とトークンスコープを確認してください。

次は?

このCustom ObjectをWorkflowsで使用して、顧客にコンテキストに応じたサポートを提供しましょう。顧客は保存されたオブジェクトデータに基づいてボットフローの返信ボタンから選択できます。

こちらの回答で解決しましたか?