カスタマーポータルが適切かつ安全に機能するために必要な設定は以下の通りです：

☑️ ログインしたusers向けにIntercom Messengerがインストールされていること

☑️ Help Centerがライブであること

☑️ Help CenterのカスタムdomainとCookie Forwardingが設定されていること

☑️ Messengerのセキュリティ設定が有効になっていること

☑️ Messenger経由での更新を防止すること

必須設定

ログインしたusers向けにIntercom Messengerがインストールされていること

usersを識別するために、Intercomはサイト上でログインしたusers向けにインストールされている必要があります。

注意：カスタマーポータルはEssentialsプランでは利用できません。カスタマーポータルの設定と利用にはAdvancedまたはExpertプランが必要です。

usersがサイトにログインすると、IntercomのセッションCookieがカスタマーポータルでのusers認証に使用されます。これはHelp CenterのカスタムdomainとCookie Forwardingが設定されていることが前提です。

具体的には、以下の2つのCookieです：

intercom-session-<workspace-id>
intercom-device-id-<workspace-id>

Cloudflareを使用している場合、IntercomはCookie Forwardingが正しく設定されていることを検出できないことがあります。この場合、Intercom設定の警告バナーは無視して構いません。

Help CenterのカスタムdomainがSSLを使用し、Help Centerの設定でHTTPSセキュリティプロトコルが選択されていることも確認してください。

カスタマーポータルをusersのなりすましから守るために、JWTを使ったMessengerのセキュリティをワークスペースで強制する必要があります。

カスタマーポータルを会社のなりすましから守るために、Messenger経由でのCompanies属性の安全でない更新を防止する必要があります。有効なJWTを使えばMessenger経由でこの属性の入力や更新は可能ですが、安全でない更新は失敗します。

これは、前のステップで述べたREST APIを使った関連付けの更新方法の場合のみ可能です。

設定 > データ > usersに移動し、Companies（デフォルト属性）の横にある編集ツールを選択します。

属性の「検証済み更新を要求」設定を切り替え、保存をクリックします。

これにより、フロントエンドのJavaScriptスニペット経由でCompanyを作成または更新できなくなります。Companyの作成や更新はIntercomのREST APIを使う必要があります。

なお、Help Centerの記事の管理と公開ができる権限を持つチームメンバーのみがカスタマーポータルをライブに設定できます。