FinがSalesforceとの接続で問題を検出すると、詳細はエラーログに表示されます。このガイドは各エラーの意味と修正方法を素早く理解するのに役立ちます。
各エラー項目には以下が含まれます:
エラーコード – エラーの一意識別子。
システムエラー – Salesforceから返されたメッセージ。
リクエストパス – エラーを引き起こした特定のSalesforce APIエンドポイント。
リクエストメソッド – 使用されたHTTPメソッド(例:GET、POST、PATCH)。
ステータスコード – Salesforceから返されたHTTPレスポンスコード(例:400や403)。
製品機能 – 問題が発生した場所(例:Historical Conversations Import)。
APIタイプ と オブジェクトタイプ – 影響を受けたSalesforceのデータオブジェクトやエンドポイントを特定するための技術的詳細。
エラーログへのアクセス方法
設定 > エラーログに移動します。
Salesforce関連のエラーを選択してエラー詳細パネルを開きます。
ヒント:エラーログから直接関連するSalesforce接続や権限設定を開くには、セットアップを確認をクリックできます。
一般的な統合エラーの修正方法
Salesforceへの接続時のエラー
エラーコード: OAUTH_EC_APP_NOT_FOUND
発生時:FinをSalesforceに接続するとき。
修正方法:接続している組織にFin for Salesforceパッケージがインストールされていないか、最新バージョンでない可能性があります。
該当のSalesforce組織にFin for Salesforceパッケージをインストールまたはアップグレードしてください。
FinをSalesforceに再接続します。
パッケージの再インストールは他のFinワークスペースに影響しません。
ナレッジインポートのエラー
オブジェクト: Knowledge__kav
エラーコード: INVALID_QUERY_FILTER_OPERATOR
メッセージ:ナレッジ記事クエリのフィルターが無効で、データ型の不一致が原因の可能性があります。
修正方法:
フィルターを確認し、記事の同期を再試行してください。
以前は同期できていた場合、Salesforceナレッジ記事のフィールド変更が原因かもしれません。フィルターで使用しているフィールドがSalesforceで更新されていないか確認してください。
オブジェクト: Knowledge__kav
エラーコード: MALFORMED_QUERY
メッセージ:ナレッジ記事クエリのフィルター値が無効です。
修正方法:
フィルターを確認し、記事の同期を再試行してください。
以前は同期できていた場合、Salesforceナレッジ記事のフィールド変更が原因かもしれません。フィルターで使用しているフィールドの権限や表示設定が更新されていないか確認してください。
オブジェクト: Knowledge__kav
エラーコード: NOT_FOUND
メッセージ:要求されたナレッジ記事が見つかりません。
修正方法:ナレッジインポートを開始すると、同期が必要な記事のスナップショットを取得し同期を開始します。取得と同期の間に記事が削除され、クエリできなくなった可能性があります。削除された記事を復元する以外に対応は不要です。
オブジェクト: Knowledge__kav
エラーコード: INVALID_FIELD
メッセージ:ナレッジ記事クエリの構築に問題がありました。
修正方法:
フィルターを確認・更新し、記事の同期を再試行してください。
以前は同期できていた場合、フィルターで使用しているフィールドの権限や表示設定の変更が原因かもしれません。
オブジェクト: 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
このエラーの修正方法:
Deploy > Salesforce Cases > Workflow に移動してください。
次のいずれかを実行してください:
restricted picklist エラーを引き起こしているピックリストフィールドが正しく設定されていることを確認するために、workflow を更新してください。
workflow にこのフィールドを設定させたくない場合は、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-to-Case に移動してください。
Lightning Threading を有効にして変更を保存してください。
注意: Lightning threading は Salesforce 組織全体に適用されます。Fin が扱うケースやメールだけでなくすべてに影響します。チームが他の workflows のために threading をオフにしている場合は、有効化前に Salesforce 設定全体への影響を確認してください。
オブジェクト: EmailMessage
エラーコード: INSUFFICIENT_ACCESS_ON_CROSS_REFERENCE_ENTITY
このエラーの修正方法: Salesforce の EmailMessage オブジェクトは ParentId 経由で Case を、CreatedById と LastModifiedById 経由で User を参照します。Fin を接続した Salesforce ユーザーが Case と User オブジェクトの両方にアクセス権を持っていることを確認してください。
Salesforce 組織で Enhanced Email を使用している場合、Salesforce は EmailMessage レコードからタスクも作成します。この場合、最初のステップで問題が解決しない場合は、同じユーザーがタスクにアクセスできる権限を持っていることを確認してください。
オブジェクト: 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
メッセージ: restricted picklist フィールドに不正な値が選択されました。
このエラーの修正方法:
Deploy > Fin Messenger > Workflow に移動してください。
次のいずれかを実行してください:
restricted picklist エラーを引き起こしているピックリストフィールドが正しく設定されていることを確認するために、workflow を更新してください。
workflow にこのフィールドを設定させたくない場合は、Salesforce Flow を設定してピックリストフィールドを正しい値に設定またはデフォルト設定してください。
オブジェクト: Case
エラーコード: CANNOT_INSERT_UPDATE_ACTIVATE_ENTITY
このエラーの修正方法: Fin は Fin messenger workflow の Create Salesforce Case ステップで Case を作成できません。Fin を Salesforce に接続したユーザーが Case オブジェクトにアクセス権を持っていることを確認してください。
オブジェクト: Case
エラーコード: FIELD_CUSTOM_VALIDATION_EXCEPTION
メッセージ: restricted picklist フィールドに不正な値が選択されました。
このエラーの修正方法:
Deploy > Fin Messenger > Workflow に移動してください。
次のいずれかを実行してください:
検証エラーを引き起こしているフィールドが正しく設定されていることを確認するために、workflow を更新してください。
workflow にこのフィールドを設定させたくない場合は、Salesforce Flow を設定してフィールドを正しい値に設定またはデフォルト設定してください。
オブジェクト: Case
エラーコード: REQUIRED_FIELD_MISSING
このエラーの修正方法:
Deploy > Fin Messenger > Workflow に移動してください。
次のいずれかを実行してください:
検証エラーを引き起こしているフィールドが正しく設定されていることを確認するために、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管理者と共有するか、サポートチームにお問い合わせください。
エラー: Fin MessengerとSalesforce Messagingの認証モード不一致
このエラーの修正方法: ログイン済みの訪問者は常に認証トークンを送信するため、Salesforceのメッセージングチャネルはそれを受け入れる必要があります。
Salesforceで、セットアップ → メッセージング設定に移動し、チャネルを選択してください。
メッセージングチャネルのユーザー認証をオンにしてください。
Fin Messengerのために本人確認を設定してください。
ケース履歴の同期エラー
オブジェクト: Emails
エラーコード: INVALID_TYPE
メッセージ: 統合ユーザーがケースに添付されたメールメッセージにアクセスできません。
このエラーの修正方法: FinはSalesforceのCaseオブジェクトのEmailsリレーションにアクセスできません。これはおそらくSalesforce組織でEnhanced Emailが有効になっていないためです。
これを解決するには、次のいずれかを行ってください:
Salesforceのセットアップ → Enhanced Emailに移動し、Enhanced Emailを有効にしてください。
会話履歴の同期を無効にします。Fin Workspace → 設定 → Salesforce統合に移動し、「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管理者と共有するか、サポートチームにお問い合わせください。
よくある質問
エラーがSalesforce関連かどうかはどう判断しますか?
Salesforce関連のエラーはエラー詳細にAPI type: Salesforce REST APIと表示されます。
Salesforceのエラーログをエクスポートできますか?
Salesforceのエラーログをファイルとしてエクスポートすることはまだできませんが、error logs webhookを使って発生時に自分のシステムに送信できます。FinはError logsの新しいエラーごとに署名付きPOSTリクエストを送信し、incident.ioやPagerDutyなどのアラートツールに中継できます。また、任意のエラーパネルでCopy all detailsをクリックして、報告や共有用に完全なログをコピーできます。
解決済みのエラーはどこで見られますか?
解決済みの問題は、Finが正常に再接続または失敗したリクエストを再試行すると、自動的にError logsビューからクリアされます。




