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

Salesforce用Fin管理パッケージ

この記事は、SalesforceケースまたはFin MessengerでFin AI Agentを設定するSalesforceシステム管理者向けです。Salesforce統合を含むプランで利用可能です。プランが不明な場合はIntercomプランを確認してください。

Salesforce用Fin管理パッケージは、FinにSalesforceの権限とカスタムケースフィールドを付与し、お客様に代わってSalesforceケースの作成、読み取り、更新を可能にします。管理パッケージはSalesforceのメタデータ(フィールド、権限セット、関連設定)を含むコンテナで、インストール時に自動的にSalesforce組織に追加されます。管理パッケージは以下のコンポーネントをインストールします。

Salesforce用FinパッケージはSalesforceにどのようなカスタムフィールドを追加しますか?

管理パッケージはSalesforceのケースオブジェクトに4つのカスタムフィールドを追加します。これらのフィールドは、Finが各ケースでの関与状況、解決状態、スパム検出、会話IDを追跡するためのものです。パッケージをインストールせず手動でこれらのフィールドを作成する場合、API名は正確に一致させる必要があります。

フィールド名

メタデータ

FinInvolved__c

このケースにFinが関与したかどうかを保存します。

  • タイプ:チェックボックス

  • ラベル:FinInvolved

  • デフォルト値:false

FinResolutionState__c

Finの解決状態を保存します。

  • タイプ:ピックリスト

  • ラベル:FinResolutionState

  • 値:

    • ソフト解決
      (API名: soft_resolution)

    • ハード解決
      (API名: hard_resolution)

    • チームにルーティング
      (API名: routed_to_team)

    • 放棄
      (API名: abandoned_negative_feedback)

FinMarkedAsSpam__c
Finによって会話がスパムとしてマークされたかどうかを保存します。

  • タイプ:チェックボックス

  • ラベル:FinMarkedAsSpam

  • デフォルト値:false

FinConversationId__c
Finプラットフォームへのリンク用の会話識別子を保存します。

  • ラベル:FinConversationId

  • 長さ:255文字

注意:FinConversationId__cはテキストフィールド(タイプ:テキスト、最大長:255文字)です。手動でフィールドを作成する場合は正しく設定してください。


Salesforce用Finパッケージに必要な権限は何ですか?

Salesforce用Fin管理パッケージはFin for Salesforce permissions(API名:Fin_for_Salesforce_permissions)というPermissionSetを作成します。このPermissionSetはFinをSalesforce組織に接続するSalesforceユーザーに割り当てる必要があります。Finがケースを管理するために必要な最小限の権限を付与し、以下を含みます。

オブジェクト権限

  • ケース:作成、読み取り、編集(削除不可、すべてのレコードの変更/閲覧不可)

  • 連絡先:読み取り、編集(作成/削除不可、すべてのレコードの変更/閲覧不可)

  • アカウント:読み取り、編集(作成/削除不可、すべてのレコードの変更/閲覧不可)

フィールド権限(読み取りおよび編集アクセス)

  • ケースフィールド:ContactId, Description, FinInvolved__c, FinMarkedAsSpam__c, FinConversationId__c, FinResolutionState__c, Origin, SourceId, Subject, SuppliedEmail, SuppliedName

  • 連絡先フィールド:Email

  • タスクフィールド:ActivityDate, Description, Type, WhatId, WhoId

システム権限

  • API Enabled

  • フィードシステムフィールドの挿入が可能

  • タスク編集

  • すべてのUsersを表示

  • 役割を表示

  • セットアップを表示

変更履歴

v1.0 - バージョン1

  • 4つのカスタムケースフィールドFinInvolved__cFinResolutionState__cFinMarkedAsSpam__cFinConversationId__cを作成します。

  • Fin for Salesforce permissionsという名前のPermissionSetを1つ作成します。


よくある質問

Salesforce用Finパッケージはどうやってインストールしますか?

管理パッケージはFinワークスペースのConnectページからインストールします。Connectに移動し、接続したい組織タイプの横にあるConnectボタンをクリックし、次にInstall Packageをクリックします。Install for all usersを選択し、インストールが完了するまで待ちます。

パッケージをインストールしたくない場合はどうすればいいですか?

アンロックパッケージをインストールしたくない場合は、同じSalesforceコンポーネントを手動で作成できます。パッケージをインストールせずにSalesforce用Finを設定するには、以下の手順に従ってください。

  1. この記事の「Salesforce用FinパッケージはSalesforceにどのようなカスタムフィールドを追加しますか?」セクションで定義された4つのカスタムケースフィールドFinInvolved__c、FinResolutionState__c、FinMarkedAsSpam__c、FinConversationId__cを作成します。API名は正確に一致させてください。

  2. この記事の「Salesforce用Finパッケージに必要な権限は何ですか?」セクションに記載されているオブジェクト権限、フィールド権限、システム権限を持つPermissionSetを作成します。PermissionSetのAPI名は正確にFin_for_Salesforce_permissionsでなければなりません。これにより、ConnectフローのSalesforceで権限を割り当てるステップが解除されます。

  3. FinをSalesforceに接続したSalesforceユーザーにPermissionSetを割り当てます。

  4. パッケージの今後の更新は変更履歴に記録されます。

アンマネージドパッケージからの移行方法は?

推奨される方法:

  1. Finを一時停止します。

  2. SalesforceユーザーからIntercom Fin AI permission PermissionSetの割り当てを解除します。これによりアンマネージドパッケージをアンインストールできます。

  3. アンマネージドパッケージをアンインストールします。アンインストール中にSalesforceはデータの保存を促します。このオプションを選択してください。選択しないとFinInvolved__cとFinResolutionState__cに保存された値が永久に失われます。以下のスクリーンショットは、データ保持オプションを選択するSalesforceのアンインストール画面を示しています。

    Salesforceのアンインストール画面。アンマネージドパッケージをアンインストールする前にフィールドデータを保持・保存するオプションが表示されています。このオプションを選択してFinInvolved__cとFinResolutionState__cの値の損失を防いでください。

  4. アンインストールが完了すると、Salesforceからデータエクスポートの準備ができた旨のメールが届きます。Salesforceのデータエクスポート画面でDataをクリックし、保存されたフィールドデータを.csvファイルとしてダウンロードしてください。

    アンインストール後のSalesforceデータエクスポート画面。保存されたFinInvolved__cとFinResolutionState__cの値を.csvファイルとしてダウンロードするためのDataボタンが表示されています。

  5. FinワークスペースのConnect > Salesforceで権限を割り当てるに移動します。

  6. FinをSalesforceに接続する方法の記事の手順に従い、管理パッケージをインストールして接続を完了します。

インストール後、DataLoaderを利用してステップ4のcsvファイルをインポートし、FinInvolved__cFinResolutionState__cでケースを更新できます。

オプションの方法:

この記事に記載された管理パッケージのコンポーネントを手動で追加または更新します。管理パッケージの更新は変更履歴に記録されます。

注意:アンマネージドパッケージはアップグレードをサポートしていません。これは、FinMarkedAsSpam__cやFinConversationId__cなど将来のリリースで追加される新しいフィールドやコンポーネントが、アンマネージドパッケージを使用している組織には自動的に利用できないことを意味します。既存の機能は引き続き動作しますが、追加のフィールドや権限を必要とする新機能は利用できません。最新の状態を保つには管理パッケージへの移行が推奨されます。今後の追加は上記の変更履歴に記録されます。

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