ユーザーIDの理解と管理

顧客を効果的に管理するために、Intercomは2種類のIDを使用します：Intercom IDとuser_id。これらがどのように連携するかを理解することは、データの整合性を保ち、正確な顧客識別を確実にするために不可欠です。

Intercom ID

Intercom IDは、当社のシステムが各顧客レコードに自動的に生成する識別子です。このIDは一定で変更できません。APIでは、しばしばcontact_idと呼ばれます。

カスタムuser_id（外部ID）

user_idは、独自のデータベースの主キーや一意のIDに合わせて設定できるカスタマイズ可能な識別子です。Intercomを外部システムと統合する柔軟な方法を提供し、API経由で更新可能です。

ユーザーID管理のベストプラクティス

これらのベストプラクティスに従うことで、重複レコードや会話の統合などの一般的なデータ問題を回避できます。

一意で一貫した識別子を割り当てる

各顧客に対して常に一意のuser_idを割り当てるべきで、通常は独自のデータベースレコードの主キーです。特定の顧客の将来のすべてのやり取りやプロフィール更新に同じuser_idを使用することが重要です。

同じメールアドレスに対して異なるuser_idを渡すことは避けてください。これにより重複した顧客レコードが作成されます。

重要：

一貫性のないまたは重複するuser_idを使用すると、アカウント間のログインや異なる顧客間の会話の統合など、深刻なデータ整合性の問題が発生します。
値-1はIntercomのシステムで内部目的のために予約されており、user_idとして使用してはいけません。この値を使用すると、会話が誤って別のユーザープロフィールに関連付けられるなどの予期しない動作が発生する可能性があります。user_idとして-1を使用する場合、それはしばしばデフォルトまたはプレースホルダー値として使われます。つまり、ユーザーがこれを持っている場合、それはもはや一意ではなく問題を引き起こす可能性があります。

マルチテナント環境でグローバルに一意なuser_idを使用する

Intercomに送信されるuser_idの値は、ワークスペース全体でグローバルに一意でなければなりません。複数のテナントや組織が同じIntercomワークスペースを共有するマルチテナント環境では、単一テナント内でのみ一意なuser_idはテナント間で衝突し、別々の顧客が同じIntercom連絡先レコードに統合される可能性があります。

これを防ぐために、user_idの値にテナント識別子を接頭辞として付けてからIntercomに送信してください。例えば、「user_123」を送信する代わりに「tenant_abc:user_123」を送信します。

注意： JWT認証を有効にすることも、ユーザーレコードの衝突を防ぎ、安全な識別を確保するために必要です。これがないと、悪意のある者が他のユーザーのuser_idを使ってなりすまし、不正アクセスや会話履歴、ワークスペースデータへのアクセスを引き起こす可能性があります。グローバルに一意なuser_idは偶発的なレコード統合を防ぎ、JWT認証は意図的ななりすましを防ぎます。