FinがSalesforceとの接続で問題を検出すると、詳細はエラーログに表示されます。このガイドは各エラーの意味と修正方法を素早く理解するのに役立ちます。

各エラー項目には以下が含まれます：

エラーコード – エラーの一意識別子。
システムエラー – Salesforceから返されたメッセージ。
リクエストパス – エラーを引き起こした特定のSalesforce APIエンドポイント。
リクエストメソッド – 使用されたHTTPメソッド（例：GET、POST、PATCH）。
ステータスコード – Salesforceから返されたHTTPレスポンスコード（例：400や403）。
製品機能 – 問題が発生した場所（例：Historical Conversations Import）。
APIタイプ と オブジェクトタイプ – 影響を受けたSalesforceのデータオブジェクトやエンドポイントを特定するための技術的詳細。

エラーログへのアクセス方法

設定 > エラーログに移動します。
Salesforce関連のエラーを選択してエラー詳細パネルを開きます。

ヒント：エラーログから直接、関連するSalesforce接続や権限設定を開くにはセットアップを確認をクリックできます。

一般的な統合エラーの修正方法

ナレッジインポートのエラー

オブジェクト： Knowledge__kav
エラーコード： INVALID_QUERY_FILTER_OPERATOR
メッセージ： ナレッジ記事クエリのフィルターが無効で、データ型の不一致が原因の可能性が高いです。
このエラーの修正方法：

トレイン > コンテンツ > Salesforceナレッジ記事の同期に移動します。
フィルターを見直し、記事の同期を再試行してください。

以前は同期できていた場合、Salesforceナレッジ記事のフィールド変更が原因かもしれません。フィルターで使用しているフィールドがSalesforceで更新されていないか確認してください。

オブジェクト： Knowledge__kav
エラーコード： MALFORMED_QUERY
メッセージ： ナレッジ記事クエリのフィルター値が無効です。
このエラーの修正方法：

トレイン > コンテンツ > Salesforceナレッジ記事の同期に移動します。
フィルターを見直し、記事の同期を再試行してください。

オブジェクト： Knowledge__kav
エラーコード： NOT_FOUND
メッセージ： 要求されたナレッジ記事が見つかりませんでした。
このエラーの修正方法： ナレッジインポートを開始すると、同期が必要な記事のスナップショットを取得し同期を開始します。取得と同期の間に記事が削除され、クエリできなくなった可能性があります。削除された記事を復元する以外に対応は不要です。

オブジェクト： Knowledge__kav
エラーコード： INVALID_FIELD
メッセージ： ナレッジ記事クエリの構築に問題がありました。
このエラーの修正方法：

トレイン > コンテンツ > Salesforceナレッジ記事の同期に移動します。
フィルターを確認・更新し、記事の同期を再試行してください。

以前は同期できていた場合、Salesforceナレッジ記事のフィールドの権限や表示設定の変更が原因かもしれません。フィルターで使用しているフィールドの権限や表示設定が更新されていないか確認してください。

オブジェクト： Knowledge__kav
エラーコード： UNKNOWN
メッセージ： ナレッジ記事としてインポートできるのは現在Knowledge__kavオブジェクトのみです。異なるオブジェクトを使用している場合はサポートチームにお問い合わせください。
このエラーの修正方法：

Salesforceケースのエラー

オブジェクト： Case
エラーコード： INVALID_FIELD_FOR_INSERT_UPDATE
メッセージ： 統合ユーザーにオブジェクトの監査フィールドを更新する権限がありません。
このエラーの修正方法：

エラーがFinがCreatedByIdまたはLastModifiedByIdを設定できないことに関する場合：

Salesforceのセットアップ → ユーザーインターフェースに移動します。
「レコード作成時に監査フィールドを設定」と「非アクティブ所有者でレコードを更新」の権限を有効にします。
(参照 Salesforceで「監査フィールドの作成」権限を有効にする)

エラーが他のフィールドに関する場合：

エラー詳細をSalesforce管理者に共有するか、サポートチームに連絡してください。

オブジェクト： Case
エラーコード： FIELD_CUSTOM_VALIDATION_EXCEPTION
このエラーの修正方法：

デプロイ > Salesforceケース > ワークフローに移動します。
次のいずれかを行います：
1. カスタム検証エラーを引き起こしているフィールドがワークフローで正しく設定されているか確認します。
2. ワークフローでこのフィールドを設定したくない場合は、Salesforceフローを設定してフィールドを正しい値に設定またはデフォルトにしてください。

オブジェクト： Case
エラーコード： CANNOT_EXECUTE_FLOW_TRIGGER
このエラーの修正方法： Salesforce組織内のフローまたはプロセスが、FinがCaseを更新または作成する際にエラーを発生させています。

システムエラーの詳細をSalesforce管理者に共有し、Salesforceフローやプロセスの問題を解決してもらいます。

オブジェクト： Case
エラーコード： INVALID_OR_NULL_FOR_RESTRICTED_PICKLIST
このエラーの修正方法：

デプロイ > Salesforceケース > ワークフローに移動します。
次のいずれかを行います：
1. 制限付きピックリストエラーを引き起こしているピックリストフィールドがワークフローで正しく設定されているか更新します。
2. ワークフローでこのフィールドを設定したくない場合は、Salesforceフローを設定してピックリストフィールドを正しい値に設定またはデフォルトにしてください。

オブジェクト: Case
エラーコード: UNABLE_TO_LOCK_ROW
このエラーの修正方法: Finは、別のプロセスが同時に更新していたため、Salesforce Caseを更新できませんでした。Caseへの一部の更新が保存されていない可能性があります。

FinがまだCaseに割り当てられている場合、次の更新は自動的に再試行されます。

Finがもはや割り当てられていない場合は、Finの会話からSalesforce Caseに手動で更新内容をコピーする必要があるかもしれません。

オブジェクト: EmailMessage
エラーコード: INSUFFICIENT_ACCESS_ON_CROSS_REFERENCE_ENTITY
このエラーの修正方法: SalesforceのEmailMessageオブジェクトは、ParentId経由でCaseを参照し、CreatedByIdとLastModifiedById経由でUserを参照します。Finを接続したSalesforce UserがCaseとUserの両方のオブジェクトにアクセスする権限を持っていることを確認してください。

Salesforce OrganizationでEnhanced Emailを使用している場合、SalesforceはEmailMessageレコードからTasksも作成します。この場合、最初のステップで問題が解決しない場合は、同じユーザーがTasksにアクセスする権限を持っていることを確認してください。

オブジェクト: EmailMessage
エラーコード: UNABLE_TO_LOCK_ROW
このエラーの修正方法: Finは、別のプロセスが同時にCaseを更新していたため、Salesforce Case用のEmailMessageを作成できませんでした。

FinがまだCaseに割り当てられている場合、次の更新で自動的にEmailMessageが作成され、メールが再送信されます。

オブジェクト: EmailMessage
エラーコード: INVALID_FIELD_FOR_INSERT_UPDATE
このエラーの修正方法: エラーがFinがCreatedByIdまたはLastModifiedByIdを設定できないことに関する場合:

Salesforceのセットアップ → ユーザーインターフェースに移動してください。
「レコード作成時に監査フィールドを設定」と「非アクティブ所有者のレコードを更新」の権限を有効にしてください。
(参照 Salesforceで「監査フィールドの作成」権限を有効にする)

エラーが他のフィールドに関する場合:

エラーの詳細をSalesforce管理者と共有するか、サポートチームに連絡して支援を受けてください。

オブジェクト: FeedItem
エラーコード: UNKNOWN_EXCEPTION
メッセージ: コンテキストユーザーにフィードでリッチテキストを作成する権限がありません
このエラーの修正方法: Finはリッチテキスト付きのケースフィードアイテムを作成する権限が必要です。

Salesforceのセットアップ → Chatter設定に移動してください。
編集をクリックしてください。
リッチテキスト投稿の下で「ユーザーがリッチテキスト投稿を作成できるようにする」を有効にしてください。
保存を押してください。

エラーが他のフィールドに関する場合:

エラーの詳細をSalesforce管理者と共有するか、サポートチームに連絡して支援を受けてください。

Fin Messengerのエラー

オブジェクト: Case
エラーコード: INVALID_OR_NULL_FOR_RESTRICTED_PICKLIST
メッセージ: 制限付きピックリストフィールドに不正な値が選択されました。
このエラーの修正方法:

Deploy > Fin Messenger > Workflowに移動してください。
次のいずれかを行ってください:
1. 制限付きピックリストエラーを引き起こしているピックリストフィールドが正しく設定されていることをワークフローで更新してください。
2. ワークフローでこのフィールドを設定したくない場合は、Salesforce Flowを設定してピックリストフィールドを正しい値に設定またはデフォルトにしてください。

オブジェクト: Case
エラーコード: CANNOT_INSERT_UPDATE_ACTIVATE_ENTITY
このエラーの修正方法: FinはFin messengerワークフローのCreate Salesforce CaseステップでCaseを作成できません。FinをSalesforceに接続したSalesforceユーザーがCaseオブジェクトにアクセスする権限を持っていることを確認してください。

オブジェクト: Case
エラーコード: FIELD_CUSTOM_VALIDATION_EXCEPTION
メッセージ: 制限付きピックリストフィールドに不正な値が選択されました。
このエラーの修正方法:

Deploy > Fin Messenger > Workflowに移動してください。
次のいずれかを行ってください:
1. 検証エラーを引き起こしているフィールドが正しく設定されていることをワークフローで更新してください。
2. ワークフローでこのフィールドを設定したくない場合は、Salesforce Flowを設定してフィールドを正しい値に設定またはデフォルトにしてください。

オブジェクト: Case
エラーコード: REQUIRED_FIELD_MISSING
このエラーの修正方法:

Deploy > Fin Messenger > Workflowに移動してください。
次のいずれかを行ってください:
1. 検証エラーを引き起こしているフィールドが正しく設定されていることをワークフローで更新してください。
2. ワークフローでこのフィールドを設定したくない場合は、Salesforce Flowを設定してフィールドを正しい値に設定またはデフォルトにしてください。

注意: フィールドがSet dataステップに表示されない場合は、Deploy > Fin Messenger > Dataに移動し、Salesforceからデータを取得するセクションでCaseフィールドを選択してください。

オブジェクト: Case
エラーコード: INVALID_FIELD_FOR_INSERT_UPDATE
このエラーの修正方法: FinはSalesforce Caseオブジェクトの特定のフィールドを設定できません。Finを接続したSalesforceユーザーがCaseオブジェクトに正しい権限を持っていることを確認してください。

問題が続く場合は、エラーの詳細をSalesforce管理者と共有するか、サポートチームに連絡して支援を受けてください。

オブジェクト: Case
エラーコード: INVALID_EMAIL_ADDRESS
このエラーの修正方法: FinはSalesforce Caseオブジェクトを作成できませんでした。Finに提供されたメールアドレスが有効であることを確認してください。

オブジェクト: Case
エラーコード: CANNOT_EXECUTE_FLOW_TRIGGER
このエラーの修正方法: Salesforce Organization内のフローまたはプロセスが、FinがCaseを更新または作成する際にエラーを発生させています。システムエラーの詳細をSalesforce管理者と共有し、問題を解決してもらってください。

Salesforceのセットアップ → Chatter設定に移動してください。
編集をクリックしてください。
リッチテキスト投稿の下で「ユーザーがリッチテキスト投稿を作成できるようにする」を有効にしてください。
保存を押してください。

エラーが他のフィールドに関する場合:

エラーの詳細をSalesforce管理者と共有するか、サポートチームに連絡して支援を受けてください。

ケース履歴の同期エラー

オブジェクト: Emails
エラーコード: INVALID_TYPE
メッセージ: 統合ユーザーはケースに添付されたメールメッセージにアクセスできません。
このエラーの修正方法: FinはSalesforce CaseオブジェクトのEmailsリレーションにアクセスできません。これはおそらくSalesforce OrganizationでEnhanced Emailが有効になっていないためです。

これを解決するには、次のいずれかを行ってください：

Salesforce Setup → Enhanced Email に移動し、Enhanced Email を有効にします。
会話履歴の同期を無効にします。Fin Workspace → Settings → Salesforce integration に移動し、Sync case history from Salesforce をオフに切り替えます。

Enhanced Email なしの Salesforce 組織をサポートするために積極的に作業しています。最新情報はサポートチームにお問い合わせください。

オブジェクト： CaseFeed
エラーコード： INVALID_FIELD
メッセージ： ワークスペースには Digital Experiences の有効化が必要です。
このエラーの修正方法： Fin は Salesforce CaseFeed オブジェクトの Visibility フィールドをクエリできません。Fin を接続した Salesforce ユーザーがこのフィールドにアクセスする権限を持っていることを確認してください。

Visibility フィールドは Salesforce で Digital Experiences が有効になっている場合にのみ利用可能です。このフィールドはコメントが内部か公開かを判断するために必要です。Salesforce で Digital Experiences を有効にするを参照してください。

有効にしても問題が解決しない場合は、エラーの詳細を Salesforce 管理者に共有するか、サポートチームにお問い合わせください。

オブジェクト： Case
エラーコード： INVALID_FIELD
このエラーの修正方法： Fin は Salesforce Case オブジェクトの特定のフィールドをクエリできません。Fin を接続した Salesforce ユーザーがこれらのフィールドにアクセスする権限を持っていることを確認してください。

問題が続く場合は、エラーの詳細を Salesforce 管理者に共有するか、サポートチームにお問い合わせください。