Intercom Messengerをインストールしたのに正しく表示されない場合、よくある解決方法をいくつかご紹介します。
この記事はウェブ統合について説明しています。ウェブ統合は、ウェブページにJavaScriptコードスニペットを追加する方法か、WordPressやShopifyのアプリのようにクリックと認証だけで自動的に行う方法があります。
一般的な目安として、ウェブコンソールにIntercomのpingが表示されていれば、コードは正しくインストールされています。
1. Messengerを含むサブスクリプションをお持ちですか？
IntercomのトライアルまたはサブスクリプションがないとMessengerは使用できません。
2. ユーザートラフィックをオンにしましたか？
設定 > チャンネル > Messenger > インストールでMessengerのユーザートラフィックが有効になっていることを確認してください。
3. IntercomのJavaScriptスニペットを正しくインストールしましたか？
Intercom MessengerをJavaScriptでインストールする方法は2つあります。
訪問者やleads向けにIntercomをインストールし、ログアウトした訪問者とチャットできるようにします。
users向けにIntercomをインストールし、ログインしたusersとチャットできるようにします。
適切なJavaScriptコードスニペットを正しい場所で使用していることを確認してください。
上記のスニペットインストールガイドに従ったのにMessengerが表示されない場合は、次の手順を試してください。
JavaScriptコードスニペット内で、プレースホルダーの「
app_id」をworkspace IDに置き換えていることを確認してください。スニペットはウェブサイトやアプリの
</body>閉じタグの直前に追加する必要があります。
注意：Single Page Application（SPA）を使用している場合は、SPA統合ガイドを参照し、SPA環境でのMessenger統合手順を確認してください。
4. Google Tag ManagerでMessengerをインストールしている場合、正しいリージョンを指定していますか？
GTMの適切な設定のために、GTMスクリプトがHTMLの<head>セクションに配置され、タグが正しく設定・公開されていることを確認してください。詳細はGTMインストールガイドを参照してください。
このアプリはコード不要の方法でIntercom Messengerをインストールします。地域別workspaceをGTMで使用する場合は、「usersに関するトラッキングカスタムデータ」セクションで「api_base」をカスタムデータ属性として渡す必要があります。地域別の値はこちら：
詳細はこの記事をご覧ください。
5. どのAPP_IDを使用していますか？複数のアプリがありますか？
間違って入力していませんか？または複数のアプリがありますか？pingリクエストのapp_idを確認してください（Chromeの場合：ページを右クリック > 検証 > ネットワーク）。pingが見えなければページをリロードしてください。
intercomSettingsをコンソールで確認することもできますが、これは非シングルページアプリにのみ適用されます。シングルページアプリではintercomSettingsが定義されていない場合があります。
6. ページにpingはありますか？
コンソールを開き、Intercom('show');でMessengerを素早く読み込む方法を試してください。
それがうまくいかない場合は、pingリクエストを探してください（表示するにはページをリロードする必要があります）。pingリクエストが見えなければ、Intercomスニペットがインストールされていないか、正しくインストールされていない可能性があります。
7. 正しいMessenger設定が有効になっていますか？
Messengerをカスタマイズし、追加のセキュリティ層を加える方法はいくつかありますが、設定を誤るとMessengerの読み込みが妨げられることがあります。
Messengerをインストールする際、公開前にオーディエンスから非表示にすることが可能です。
Messengerランチャーを適切な人に表示していますか？
Messenger設定で「受信会話のボリュームを制御」し、Messengerランチャーを訪問者やusers、または特定のデータに一致する人に表示するよう設定できます。
Messengerを訪問者や特定のデータに一致するusersに表示する場合、お客様（およびあなた）はそのデータに一致する必要があります。例えば、「VIP」ステータスのusersにのみMessengerを表示したい場合、そのデータを持つusersだけがMessengerを見られます。
Messengerのセキュリティ設定を適用しましたが、正しく設定されていませんか？
MessengerはJWT認証 / Identity Verificationが正しく設定されていないと読み込まれません。さらに、Switchインターフェースが正しく機能するには、アプリの設定でMessenger APIが有効になっている必要があります。Messenger APIが無効の場合、Switchは読み込まれず、空白ページが表示されることがあります。
JWTでは、usersのリクエストごとに一意のトークンを生成し、ユーザー起動時にそれを提供する必要があります。この一意のトークンはMessenger APIシークレットキーと、最低限usersの一意の外部ユーザーIDを使って生成されます。
Identity Verificationでは、Intercomのセキュリティ設定からシークレットキーを使い、ログインしたusersごとに一意のユーザーハッシュを生成し、それをMessengerに他のユーザーデータと一緒に送信します。
Messengerのセキュリティ設定を適用しているのに、各usersに対してトークンやハッシュを正しく送信していない場合、Messengerは読み込まれません。同様に、Identity Verificationで無効なトークンやハッシュを送信すると、Messengerは読み込みに失敗します。
問題の原因かどうかを確認する最も簡単な方法は、ブラウザのコンソールを開き、特定のエラーメッセージを探すことです。
信頼できるdomainにいますか？
Messengerを安全に保つで、Intercomをインストールした信頼できるdomainをリストできます。
これらのdomainが誤って追加されているか、現在のdomainがリストにない場合、Messengerは読み込まれず、ブラウザのコンソールに403エラーが表示されます。
コンソールで信頼できるdomainエラーを見つける手順：
コンソールを開き、ネットワークをクリックしてページを更新します。
「ping」と入力してネットワークリクエストをフィルターします。
レスポンスタブをクリックします。
8. 公共サフィックスdomainを使用していますか？
Intercomをウェブサイトにインストールするには、Messengerがdomain用のファーストパーティクッキーを作成できる必要があります。例えば*.customer-domain.com.。これは、firebaseapp.comやherokuapp.comのような公共サフィックスとして登録されたdomainでは（最新のブラウザで）失敗します。公共サフィックスdomainの完全リストはこちら。
9. コンソールに409エラーが表示されていますか？
コンソールに409エラーが表示されている場合、これは競合を示します。通常、この競合は同じメールアドレスを持つ複数の既存usersがいて、Intercomがどのusersでログインしようとしているか分からないことが原因です。
これを解決するには、次のいずれかを行ってください：
ログイン時に一意の識別子として
user_idを使用してください。
その他の確認事項
広告ブロック拡張機能やプライベートブラウジングモードを使用していますか？
一部の広告ブロック拡張機能は、Messengerのようなトラッキング機能を含むJavaScriptもブロックします。なぜこのようなことが起きるのか、対処法はこちら。
IntercomのJavaScriptスニペットを変更したり、messengerにカスタムスタイルを適用したことはありますか？
インストールコードを変更したり、Intercom要素に独自のCSSを適用すると予期しない結果になることがあるため、推奨しません。特定のケースがある場合はMessengerでサポートチームに相談してください。適切な方向を案内します。😄 また、intercomSettingsオブジェクトのhide_default_launcherパラメータが意図せずtrueに設定されていないか確認してください。表示ルールと矛盾する場合は調整または削除してください。
WordPressプラグインを使用していますか？
ログアウトした訪問者とチャットするためにIntercomのWordPressプラグインを使用している場合、Messengerを表示するにはWordPress管理ダッシュボードからログアウトしてサイトにアクセスする必要があります。
Messengerをプラグインで正しく読み込むには、WordPress 4.2.0以上とPHP 5.6以上が必要です。
一部のWordPressテーマには、プラグインがJavaScriptスニペットを挿入するフッター要素が含まれていません。フッターのないテーマを使用している場合は、WordPressページに直接JavaScriptスニペットをインストールする必要があります。
その他のエラー確認方法
Messengerが正しく読み込まれない場合は、ブラウザのコンソールで他のエラーを確認できます。各ウェブブラウザでの確認方法は以下の通りです。
Chromeの場合、キーボードショートカットctrl + shift + J（Windows）またはcommand + option + J（Mac）で開発者コンソールを開きます。
Firefoxの場合、キーボードショートカットctrl + shift + K（Windows）またはcommand + option + K（Mac）を使います。ツールボックスがブラウザウィンドウの下部に表示され、Webコンソールが有効になります。
Edgeの場合、F12キーでF12開発者ツールにアクセスします。F12開発者ツール内でコンソールタブに移動します。
Safariの場合、開発メニューを有効にする必要があります。MacのメニューバーのSafariメニューを開き、「環境設定」を選択します。次に「詳細」タブに移動し、「メニューバーに開発メニューを表示」にチェックを入れます。これでキーボードショートカットcommand + option + Cで開発者コンソールを開けます。
Messengerの読み込みにまだ問題がある場合は、Messengerでチャットしてサポートにお問い合わせください！
Messengerが自分のinboxに表示されず、サポートに連絡できない場合は？
Inbox内の一部状況でMessengerがサイドバーやCopilotと重ならないように非表示にされる決定がありました。回避策としては、アプリの別ページに移動し、そこからMessengerランチャーを開くことです。
注意：Messenger設定にアクセスできない場合は、「Messenger設定にアクセス可能」権限が有効になっていることを確認してください。