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

属性がFin Procedures、Workflows、およびデータコネクタを強化する方法

対応者:Ivan Branimir Skoric

属性とは何ですか?

属性は、users、companies、conversationsにより多くのデータを付加したり、複雑なWorkflowsを構築するために一時的なデータを保存したりするのに最適な方法です。

Intercomには5種類の属性があります:

  • People属性

  • Company属性

  • Conversation属性

  • Ticket属性

  • Temporary属性 [NEW]

注意:Fin Tasksはレガシー機能です。2026年3月12日以降、新しいTasksは作成できず、すべての新規ビルドはFin Proceduresとして作成されます。既存のTasksは引き続き完全にサポートされ、属性の読み取りと更新は同様に行われます。


どのような種類の属性がありますか?

Peopleデータ属性

これらはIntercomのusersおよびleadsに関するデータを保存するために使用されます。デフォルトで、Intercomには名前、電話番号、メールアドレスなどの基本的な属性が含まれています。ビジネスのニーズに応じてカスタムデータ属性を追加することもできます。例としては:

  • ユーザーが利用しているTierまたはプラン

  • 最終請求額

  • 最後に購入した商品

Companyデータ属性

Peopleデータ属性と同様に、company属性はIntercomを通じてビジネスが取引するcompaniesに関するより多くのデータを提供するために使用されます。デフォルトの属性には会社名、業界、会社のウェブサイト、IDなどがあります。さらにカスタム属性を作成することも可能です。例としては:

  • 会社の税/VAT ID

  • 従業員数

  • 会社が子会社かどうか

Conversation/ticketデータ属性

これらは、サポートチームが対応しているticketやconversationに関するデータを保存するのに最適です。顧客の問題に関するより多くのコンテキストを提供したり、分類やレポート作成の目的で使用されます。

このデータは主に3つの方法で入力されます:

  • Inbox内でチームメンバーが手動で入力。

  • Workflowsの「Collect data」ステップを使用。

  • Fin AI AgentがFin Attributesを使って自動的に入力。

Conversation/ticketデータ属性の例には以下があります:

  • 顧客問い合わせのカテゴリまたは理由

  • 顧客が問い合わせている製品

  • フォローアップが必要か(true / false)

Conversation IDはconversation属性として利用可能で、以下でアクセスできます:

  • Workflows(「Conversation ID」で検索)

  • Tasks(「Conversation ID」で検索)

  • Procedures(Read attribute → Conversation ID経由)

これにより、Conversation IDを以下に使用できます:

  • Workflowの追跡と会話の参照。

  • 外部システムとのデータ統合。

  • レポートおよび分析機能の強化。

  • 会話参照によるより良い顧客サポート。

Fin Attributesで会話を自動分類

Fin Attributesは、問題の種類、緊急度、感情などの属性を検出してすべての会話を自動的に分類します。会話は即座に分類され、Workflowsのトリガー、適切なチームへのルーティング、正確なレポートの生成が手動作業なしで可能になります。

ヒント:この記事はconversation属性の基本を説明していますが、AIによる分類の設定と使用方法を学ぶために、完全な Fin Attributes記事を読むことを強くお勧めします。

Temporary属性 [NEW]

Fin ProceduresとWorkflowsは、「temporary attribute」と呼ばれる新しいタイプの属性を使用できます。

Temporary属性は、現在のProcedureまたはWorkflowの実行時のみデータが必要で、報告などの目的でIntercomに永続的に保存したくない場合に便利です。特定の実行に関連する情報を保持するためにこれらの属性を作成できます。

例えば、次のようなtemporary属性を作成できます:

  • 顧客が選択した予約IDをキャプチャする

  • 顧客の希望配達日

  • Finにユーザーの問い合わせを分類させたり、データを収集させたりする


属性はどこで使えますか?

Fin Procedures

Fin ProcedureのInstructionステップに、テキスト指示の中で「@」を入力して属性を追加します。既存のデータを使用するにはRead attributeを選択し、新しい値を保存するにはUpdate attributeを選択します。people、company、conversation、またはtemporary属性を使用できます。詳細はBuilding Fin Proceduresを参照してください。

Temporary属性は、現在のProcedure実行時のみデータが必要で、報告などの目的でIntercomに永続的に保存したくない場合に便利です。作成方法は次のとおりです:

  1. Instructionステップで「@」を入力し、Update attributeを選択します。

    Fin ProcedureのInstructionsエディタで@メニューが開き、Data operationsの下にUpdate attributeがハイライトされている状態。
  2. Create attributeをクリックします。

    Fin Procedureの属性ピッカーでpeople属性とcompany属性が一覧表示され、下部にCreate attributeボタンがある状態。

  3. Formatを選択し、NameとDescriptionを入力してから、Create and insertをクリックします。

    Formatのドロップダウン、Nameフィールド、Descriptionフィールド、Create and insertボタンがあるCreate temporary attributeダイアログ。

例えば、Finに顧客の質問を分類させ、その結果をtemporary属性に保存するよう指示することができます。

Temporary属性はInstructionステップの外でも使用でき、Conditionステップで分岐したり、@Add noteでメモを追加したりできます。

ProcedureまたはWorkflowでのデータ収集

人、会社、会話、または一時的にFin Procedureにデータを収集して保存するには、Instructionステップに書き込みます。例:「顧客に注文番号を尋ね、@Update attributeで保存する。」保存した値で分岐するためにConditionステップを追加できます。Workflowでは、代わりにCollect dataステップを使用します。これは、収集したデータを後で条件分岐のロジックに使用したい場合に便利です。以下の2つのスクリーンショットはWorkflowのCollect dataステップを示しています。

Collect dataステップが追加されたWorkflow。

ここで、収集したいデータ属性の種類を指定できます。

収集するデータ属性の種類を選択するCollect dataステップの設定。

データコネクタ

Data connectorsは、データ属性を使用して外部システムのデータを取得または更新できます。例えば、データベースからuserレコードを更新または取得できます。

属性はData connectorのリクエストURLとRequest Bodyの両方で使用でき、属性挿入子{..}を使って挿入します。

リクエストURLとRequest Bodyに属性挿入子{..}を使って属性を追加したData connector。

Procedure内で

InstructionステップにData connectorを追加するには、「@」を入力してCall data connectorを選択します。入力や出力のマッピングは不要です。Finは設定から必要な入力を判断し、後続のステップで@Read attribute(例:Get orders > status)で応答を読み取れます。

Connectorの応答はProcedure内でのみ利用可能で、Inboxのconversation属性には表示されません。応答をconversation属性に保存するには、Handoff to workflowを使い、Workflowで属性を設定します。その後、Procedureは再開されません。一般的な問題についてはFin ProceduresとData connectorsのトラブルシューティングを参照してください。

Workflow内で

Workflowの出力や収集したtemporaryデータを外部APIに送信して処理したい場合、まずマッピングを作成する必要があります。

Data connectorでは、Workflow設定に存在するのと同じ属性(この例ではcontact reason)を作成する必要があります:

Workflowの属性に合わせてcontact reason属性が作成されたData connector。

次に、Workflowのアクション入力をマッピングします。

アクション入力がマッピングされたWorkflowのData connectorアクション。

ここで、各属性に対して、Finがタスクを実行して出力したり、Workflowでユーザーから収集したtemporaryデータ属性を挿入できます。

Workflowでユーザーから収集したtemporaryデータ属性にマッピングされたData connectorアクション入力。

Workflowの分岐がcompany属性(例:設立日)をチェックすると、Intercomは連絡先が属するすべてのcompanyに対して条件を評価します。条件を満たすcompanyがあれば、その分岐が一致し、適切に進行します。

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