ツールチップを作成すると、Intercomはツールチップビルダーで配置とデザインを行うためにあなたのウェブサイトを開きます。ビルダーがサイトで読み込まれない、Messengerが読み込まれていないと言われる、またはツールチップが保存できない場合に役立つ記事です。

ツールチップビルダーはサイト上のMessengerを通じてIntercomに接続します。接続できない場合、Messengerが読み込まれていないというメッセージが表示されるか、ビルダーが表示されません。以下を確認してください。

Messengerはツールチップを作成しているページにインストールされている必要があり、ログイン中に起動している必要があります。例えば、Messengerをログアウトした訪問者向けにのみインストールしている場合、ビルダーは製品内で読み込まれません。サイトの設定で管理者向けにMessengerが起動しない場合は、ツールチップ作成時にログインしているあなたのために起動していることを確認してください。

複数のIntercomワークスペースがある場合、ツールチップを作成しているワークスペースがページにインストールされているものか確認してください。IntercomのURLのワークスペースIDと、そのページのブラウザコンソールでwindow.intercomSettings.app_idを実行した結果を比較します。このチェックは標準のJavaScriptインストールで機能します。

ビルダーはツールチップ用に選択したURLを開き、同じdomainのページにのみ接続します。そのURLが現在別のdomainにリダイレクトされている場合（例：サイトをexample.comからexample.ioに移動した後）、ビルダーは接続できません。ツールチップには保存されたURLを変更する設定がないため、ページの現在のdomainでツールチップを再作成してください。

サイトや製品がサードパーティのiframe内（例：ShopifyアプリやFigmaプラグイン）で読み込まれている場合、Messengerはそれを含むページにアクセスできず、ツールチップビルダーは動作しません。

ツールチップビルダーはwindow.openerを使ってIntercomと通信します。サイトがデフォルトのunsafe-none以外の値でCross-Origin-Opener-Policyヘッダーを送信しているか、サイトのJavaScriptがwindow.openerを上書きしている場合、ビルダーは読み込まれません。ツールチップ作成中はヘッダーをunsafe-noneに設定するか削除してください。作成後に元に戻しても、ライブツールチップの表示には影響しません。

ビルダーはIntercomと通信するためにサイトのセッションストレージにいくつかの値（intercom.intercom-snippet__intersection-で始まるキー）を保存します。ビルダーが開いている間にサイトがセッションストレージをクリアすると（例えば、ログアウト時だけでなくページ読み込み時にsessionStorage.clear()を呼び出す場合）、ビルダーは接続を失います。確認するには、ビルダーが開いている間にブラウザコンソールでObject.keys(sessionStorage)を実行してください。intercom.intercom-snippet__intersection-キーが表示されなければ、開発者にログアウト時のみセッションストレージをクリアするよう依頼してください。

ビルダーが詳細なしの一般的な保存エラーを表示する場合、ツールチップの位置オフセットを確認してください。トップオフセットまたはレフトオフセットが-1000から1000ピクセルの範囲外だとツールチップは保存できません。ツールチップビルダーのレイアウト設定を開き、両方のオフセットを-1000から1000の範囲内に設定して再度保存してください。