# CRM外部ID・Upsertキーの設計｜CSV・API連携で重複レコードを作らない方法

> 連携元が発行する不変キー、CRM内部IDとの対応、Upsertの再送、キー変更、失敗ログを一つの連携キー運用として整えます。

## メタ情報

- URL (HTML): https://funnel-ai.jp/media/crm-external-id-upsert-key-governance/
- 公開日: 2026-08-26
- テーマ: Funnel Ai Media -Sales & Marketing- (https://funnel-ai.jp/media/crm-sales/)
- カテゴリ: CRM・営業基盤 (https://funnel-ai.jp/media/crm-sales-ops/)
- 編集: ファネルAi編集部 (https://funnel-ai.jp/company/funnelai-editorial/)
- 監修: ファネルAi監修チーム (https://funnel-ai.jp/company/funnelai-review/)
- 出典メディア: Funnel Ai Media (https://funnel-ai.jp/media/)

## 本記事のポイント

- 外部IDは連携元が発行する不変・一意な値を使い、会社名やメールアドレスなど変更される業務値を単独キーにしません。
- Upsert前後で入力件数、作成、更新、失敗、未処理を照合し、同じ入力を再送しても同じレコードへ着地するか確認します。
- キー変更やシステム統合では旧キーを上書きせず、新旧対応表、適用日、移行状態、切り戻し条件を保持します。

## 想定質問

- CRMの外部IDはどのシステムの値を使いますか？
- External IDとCRM内部IDはどう使い分けますか？
- Upsertの再実行で重複作成を防ぐには何を確認しますか？
- 外部キーを変更・統合するときにどう移行しますか？

---

本文（HTML）は https://funnel-ai.jp/media/crm-external-id-upsert-key-governance/ を参照してください。