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設定で「受信会話のボリュームを制御」し、訪問者やusers、または特定のデータに合致する人にMessengerランチャーを表示するよう設定できます。
訪問者やusersのうち特定のデータに合致する人にMessengerを表示する場合、そのデータに合致するお客様（およびあなた）だけがMessengerを見られます。例えば、「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がどのユーザーでログインすべきか判断できないことが原因です。この競合はコンソールエラーが表示されない場合もあり、Messengerパネルが空白になるか読み込みに失敗することがあります。特にuser_idがメールと一緒に送信されていない場合に起こります。
これを解決するには、次のいずれかを行ってください。
ログイン時に一意の識別子として
user_idを使用する。
その他の確認事項
広告ブロック拡張機能やプライベートブラウジングモードを使用していますか？
広告ブロック拡張機能やプライベートブラウジングモードは、Intercomスクリプト（js.intercomcdn.com）の実行を妨げ、Messengerの読み込みをブロックすることがあります。なぜ起こるのか、対処法はこちらをご覧ください。
広告ブロッカーが原因か確認する方法
広告ブロック拡張機能を一時的に無効にしてページをリロードしてください。
Messengerが表示されたら、その拡張機能が原因です。
対処方法
広告ブロッカーの設定で
js.intercomcdn.comをホワイトリストに登録し、拡張機能を完全に無効にせずにMessengerを読み込めるようにしてください。ブラウザによっては、プライベートブラウジングモードでサードパーティスクリプトがデフォルトでブロックされることがあり、広告ブロッカーがなくてもMessengerが読み込まれない場合があります。
注意：お客様がMessengerを見られないと報告した場合は、広告ブロック拡張機能が有効かどうか確認し、js.intercomcdn.comを無効化またはホワイトリストに登録するよう案内してください。製品やオンボーディングフローに、広告ブロッカーがチャット表示を妨げる可能性がある旨の注意書きを追加することも検討してください。
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スニペットを挿入するフッター要素が含まれていません。フッターのないテーマを使う場合は、JavaScriptスニペットを直接WordPressページにインストールする必要があります。
その他のエラー確認方法
Messengerが正しく読み込まれない場合、ブラウザのコンソールで他のエラーを確認できます。各ブラウザでの確認方法は以下の通りです。
Chromeの場合、キーボードショートカットctrl + shift + J（Windows）またはcommand + option + J（Mac）で開発者コンソールを開きます。
Firefoxの場合、キーボードショートカットctrl + shift + K（Windows）またはcommand + option + K（Mac）を使います。ツールボックスがブラウザ下部に表示され、Webコンソールがアクティブになります。
Edgeの場合、F12キーでF12開発者ツールを開き、コンソールタブに移動します。
Safariの場合、開発メニューを有効にする必要があります。MacのメニューバーからSafariメニューを開き、「環境設定」を選択します。次に「詳細」タブに移動し、「メニューバーに開発メニューを表示」にチェックを入れます。これでキーボードショートカットcommand + option + Cで開発者コンソールを開けます。
Messengerの読み込みにまだ問題がある場合は、Messengerでチャットしてサポートにお問い合わせください。喜んでお手伝いします！
自分のInboxにMessengerが表示されず、サポートに連絡できない場合は？
Inbox内の一部状況でMessengerがサイドバーやCopilotと重ならないよう非表示にされる決定がありました。回避策として、アプリの別ページに移動し、そこからMessengerランチャーを開いてください。
注意：Messenger設定にアクセスできない場合は、「Messenger設定にアクセス可能」権限が有効になっているか確認してください。