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で更新されていないか確認してください。
オブジェクト： Knowledge__kav
エラーコード： MALFORMED_QUERY
メッセージ： ナレッジ記事クエリのフィルター値が無効です。
このエラーの修正方法：
フィルターを確認し、記事の同期を再試行してください。
以前は同期が正常に動作していた場合、Salesforceのナレッジ記事フィールドの変更が原因かもしれません。フィルターで使用しているフィールドがSalesforceで更新されていないか確認してください。
オブジェクト： Knowledge__kav
エラーコード： NOT_FOUND
メッセージ： リクエストされたナレッジ記事が見つかりませんでした。
このエラーの修正方法： ナレッジインポートを開始すると、同期が必要な記事のスナップショットを取得して同期を開始します。取得と同期の間に記事が削除され、クエリできなくなった可能性があります。削除された記事を復元する以外に対応は不要です。
オブジェクト： Knowledge__kav
エラーコード： INVALID_FIELD
メッセージ： ナレッジ記事クエリの構築に問題がありました。
このエラーの修正方法：
フィルターを確認・更新し、記事の同期を再試行してください。
以前は同期が正常に動作していた場合、Salesforceのナレッジ記事フィールドの権限や表示設定の変更が原因かもしれません。フィルターで使用しているフィールドの権限や表示設定が更新されていないか確認してください。
オブジェクト： Knowledge__kav
エラーコード： UNKNOWN
メッセージ： ナレッジ記事クエリの構築に問題がありました。
このエラーの修正方法： 現在、Salesforce記事としてKnowledge__kavオブジェクトのみのインポートをサポートしています。異なるオブジェクトを使用している場合は、サポートチームにお問い合わせください。
Salesforceケースのエラー
オブジェクト： Case
エラーコード： INVALID_FIELD_FOR_INSERT_UPDATE
メッセージ： 統合ユーザーにオブジェクトの監査フィールドを更新する権限がありません。
このエラーの修正方法：
エラーがFinがCreatedByIdまたはLastModifiedByIdを設定できないことに関する場合:
Salesforceのセットアップ → ユーザーインターフェースに移動します。
「レコード作成時に監査フィールドを設定」と「非アクティブ所有者のレコードを更新」の権限を有効にします。
(参照 Salesforceで「監査フィールドの作成」権限を有効にする)
エラーが他のフィールドに関する場合:
エラー詳細をSalesforce管理者に共有するか、サポートチームにお問い合わせください。
オブジェクト： Case
エラーコード： FIELD_CUSTOM_VALIDATION_EXCEPTION
このエラーの修正方法：
次のいずれかを行います:
カスタム検証エラーを引き起こしているフィールドがワークフローで正しく設定されているか確認してください。
ワークフローでこのフィールドを設定したくない場合は、Salesforce Flowを設定してフィールドを正しい値に設定またはデフォルトにしてください。
オブジェクト： Case
エラーコード： CANNOT_EXECUTE_FLOW_TRIGGER
このエラーの修正方法： FinがCaseを更新または作成するときに、Salesforce組織内のフローやプロセスがエラーを発生させています。
システムエラーの詳細をSalesforce管理者に共有し、Salesforceのフローやプロセスで問題を解決してもらってください。
オブジェクト： Case
エラーコード： INVALID_OR_NULL_FOR_RESTRICTED_PICKLIST
このエラーの修正方法：
次のいずれかを行います:
制限付きピックリストエラーを引き起こしているピックリストフィールドがワークフローで正しく設定されているか更新してください。
ワークフローでこのフィールドを設定したくない場合は、Salesforce Flowを設定してピックリストフィールドを正しい値に設定またはデフォルトにしてください。
オブジェクト: Case
エラーコード: UNABLE_TO_LOCK_ROW
このエラーの修正方法: Finは別のプロセスが同時に更新していたため、Salesforce Caseを更新できませんでした。Caseへの一部の更新が保存されていない可能性があります。
FinがまだCaseに割り当てられている場合、次の更新は自動的に再試行されます。
Finがもはや割り当てられていない場合は、Finの会話からSalesforce Caseに手動で更新内容をコピーする必要があるかもしれません。
オブジェクト: Case
症状: 既存のケースへの顧客の返信が、元のケースにスレッドされずにFinワークスペースで新しい会話を作成しています。
このエラーの修正方法: これはSalesforceでLightning threadingが有効になっていない場合に発生します。有効でないと、SalesforceはFinが受信返信を元のケースに紐付けるために依存するメールスレッドヘッダーを保持しません。
Salesforce設定 → Email → Email-to-Caseに移動します。
Lightning Threadingを有効にして変更を保存します。
注意: Lightning threadingはSalesforce組織全体に適用され、Finが扱うケースやメールだけでなくすべてに影響します。チームが他のworkflowsのためにスレッドをオフにしている場合は、有効化前にSalesforce設定全体への影響を確認してください。
オブジェクト: EmailMessage
エラーコード: INSUFFICIENT_ACCESS_ON_CROSS_REFERENCE_ENTITY
このエラーの修正方法: SalesforceのEmailMessageオブジェクトはParentIdでCaseを、CreatedByIdとLastModifiedByIdでUserを参照します。Finを接続したSalesforceユーザーがCaseとUserオブジェクトの両方にアクセス権を持っていることを確認してください。
Salesforce組織で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
メッセージ: 制限付きピックリストフィールドに不正な値が選択されました。
このエラーの修正方法:
次のいずれかを行います：
制限付きピックリストエラーを引き起こしているピックリストフィールドが正しく設定されていることを確認するためにworkflowを更新します。
workflowでこのフィールドを設定したくない場合は、Salesforce Flowを設定してピックリストフィールドを正しい値に設定またはデフォルトにしてください。
オブジェクト: Case
エラーコード: CANNOT_INSERT_UPDATE_ACTIVATE_ENTITY
このエラーの修正方法: Fin messenger workflowのCreate Salesforce CaseステップでCaseを作成できません。FinをSalesforceに接続したSalesforceユーザーがCaseオブジェクトにアクセス権を持っていることを確認してください。
オブジェクト: Case
エラーコード: FIELD_CUSTOM_VALIDATION_EXCEPTION
メッセージ: 制限付きピックリストフィールドに不正な値が選択されました。
このエラーの修正方法:
次のいずれかを行います：
検証エラーを引き起こしているフィールドが正しく設定されていることを確認するためにworkflowを更新します。
workflowでこのフィールドを設定したくない場合は、Salesforce Flowを設定してフィールドを正しい値に設定またはデフォルトにしてください。
オブジェクト: Case
エラーコード: REQUIRED_FIELD_MISSING
このエラーの修正方法:
次のいずれかを行います：
検証エラーを引き起こしているフィールドが正しく設定されていることを確認するためにworkflowを更新します。
workflowでこのフィールドを設定したくない場合は、Salesforce Flowを設定してフィールドを正しい値に設定またはデフォルトにしてください。
注意: フィールドがSet dataステップに表示されない場合は、Deploy > Fin Messenger > Dataに移動し、Pull data from 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組織内のフローまたはプロセスが、FinがCaseを更新または作成する際にエラーを発生させています。システムエラーの詳細をSalesforce管理者に共有し、問題を解決してもらってください。
オブジェクト: FeedItem
エラーコード: UNKNOWN_EXCEPTION
メッセージ: コンテキストユーザーにフィードでリッチテキストを作成する権限がありません
このエラーの修正方法: Finはリッチテキスト付きのケースフィードアイテムを作成する権限が必要です。
Salesforce設定 → Chatter設定に移動します。
編集をクリックします。
リッチテキスト投稿の下で 「ユーザーがリッチテキスト投稿を作成できるようにする」を有効にします。
保存をクリックしてください。
エラーが他のフィールドに関する場合：
エラーの詳細をSalesforce管理者と共有するか、サポートチームにお問い合わせください。
同期ケース履歴のエラー
オブジェクト： Emails
エラーコード： INVALID_TYPE
メッセージ： 統合ユーザーはケースに添付されたメールメッセージにアクセスできません。
このエラーの修正方法： FinはSalesforce CaseオブジェクトのEmailsリレーションシップにアクセスできません。これはおそらくSalesforce組織でEnhanced Emailが有効になっていないためです。
これを解決するには、次のいずれかを実行してください：
Salesforceのセットアップ → Enhanced Emailに移動し、Enhanced Emailを有効にします。
会話履歴の同期を無効にします。Fin Workspace → 設定 → Salesforce統合に移動し、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管理者と共有するか、サポートチームにお問い合わせください。
よくある質問
エラーがSalesforce関連かどうかはどう判断しますか？
Salesforce関連のエラーはエラー詳細にAPI type: Salesforce REST APIと表示されます。
Salesforceのエラーログをエクスポートできますか？
まだできませんが、任意のエラーパネルですべての詳細をコピーをクリックすると、報告や共有のために完全なログをコピーできます。
解決済みのエラーはどこで確認できますか？
解決済みの問題は、Finが正常に再接続または失敗したリクエストを再試行すると、エラーログビューから自動的にクリアされます。