ウィジェットの設置
HTML1行を、各ページの閉じbodyタグの直前に一度貼り付けるだけです。所要時間はおよそ2分です。
1. スニペットを取得する
ダッシュボードの設置ページには、あなたのボットのキーが埋め込み済みの正確な1行が表示されます。形は次のとおりで、キーがボットを識別します:
<script src="https://helpbrain.net/w/YOUR_BOT_KEY.js" async></script>YOUR_BOT_KEY を自分のキーに置き換えるか、ダッシュボードの設置ページから完成済みの1行をコピーしてください。
メモ
スクリプトはgzipで3KB未満、非同期で読み込まれるため、ページの表示をブロックすることはありません。チャット本体は、訪問者が実際に開いたときにはじめて読み込まれます。
2. サイトに貼り付ける
お使いのプラットフォームを選んでください。どこに貼る場合でも、チャットを表示したいすべてのページにスニペットが行き渡る必要があります。つまりほぼ必ず、特定ページの本文ではなく、共通のフッターやレイアウトのテンプレートです。
無料のWPCodeプラグインを導入する
WordPressの管理画面で Plugins → Add New を開き、WPCode を検索してインストールし、有効化します。これがコードを書かないルートで、テーマを更新しても消えません — テーマファイルを直接編集した場合は消えます。
新しいスニペットを追加する
Code Snippets → + Add Snippet → Add Your Custom Code(New Snippet)と進みます。名前を HelpBrain などに設定し、Code Type を HTML Snippet にします。
貼り付けて配置を決める
コード欄にスニペットを貼り付けます。Insertion で Auto Insert を選び、Location を Site Wide Footer に設定します。
保存して有効化する
スニペットを Active に切り替え、Save Snippet を押します。新しいタブでサイトを開くと、チャットの丸いボタンが表示されているはずです。
テーマを直接編集したい場合
Appearance → Theme File Editor → footer.php を開き、</body> の直前に貼り付けて Update File を押します。可能であれば子テーマを使ってください。親テーマを更新すると footer.php が上書きされ、チャットが黙って消えます。
テーマのコードを開く
Shopify管理画面で Online Store → Themes を開きます。公開中のテーマの ⋯ ボタンから Edit code を選びます。
theme.liquid を開く
左のファイル一覧の Layout から theme.liquid をクリックします。
閉じbodyタグの直前に貼り付ける
ファイル末尾までスクロールして </body> を見つけ、そのすぐ上の行にスニペットを貼り付けます。
保存する
Save を押します。このレイアウトを使うストアフロントの全ページにチャットが表示されます。
コードインジェクションを開く
Settings → Advanced → Code Injection と進みます。
Footer欄に貼り付ける
Header ではなく Footer 欄にスニペットを貼り付けます。Squarespace側が </body> の直前に挿入してくれます。
保存する
Save を押し、公開サイトを開いて確認します。
注意
Code Injection はSquarespaceのBusinessプラン以上でのみ利用できます。Personalプランでは Code Injection のメニュー自体が表示されません。
カスタムコードを開く
Wixのダッシュボードで Settings → Custom Code(Advanced の下)を開き、+ Add Custom Code をクリックします。
スニペットを貼り付ける
コード欄に貼り付け、後で見つけられるよう HelpBrain などの名前を付けます。
読み込み場所を決める
Add Code to Pages を All pages に、Place Code in を Body - end に設定します。
適用する
Apply を押します。カスタムコードは公開サイトに反映されるため、エディタのプレビューではなく公開URLで確認してください。
サイトのカスタムコードを開く
Designerで Site Settings → Custom Code を開きます。
Footer Code に貼り付ける
「before </body> tag」と書かれた Footer Code 欄にスニペットを貼り付けます。
変更を保存する
パネル上部の Save Changes を押します。
公開する
サイトを公開します。ここが見落とされがちです。カスタムコードは公開時にはじめて反映され、Designerのプレビューでは決して動きません。
カスタムコードを開く
Project Settings(歯車アイコン)→ General を開き、Custom Code までスクロールします。
End of <body> tag に貼り付ける
head側ではなく、End of <body> tag の欄に貼り付けます。
公開する
サイトを公開します。Webflowと同様、カスタムコードは公開サイトでのみ動作します。
コードインジェクションを開く
Ghostの管理画面で Settings → Code injection を開きます。
Site Footer に貼り付ける
Site Footer の欄にスニペットを貼り付けます。
保存する
Save を押します。記事を含むサイトの全ページに適用されます。
カスタムHTMLタグを作成する
GTMのワークスペースで Tags → New → Tag Configuration → Custom HTML と進みます。
スニペットを貼り付ける
HTML欄に貼り付け、タグ名を HelpBrain にします。
全ページで発火させる
Triggering で All Pages(Page View)を選び、タグを保存します。
送信して公開する
Submit を押し、続けて Publish します。コンテナを公開するまで何も反映されません。
メモ
タグマネージャーはページ本体の後に読み込まれるため、直接貼り付けた場合より少し遅れてチャットボタンが現れます。同意管理でタグを制御している場合、訪問者が同意するまでチャットは読み込まれません。
Next.js(App Router)
ルートレイアウトの <body> 内で next/script を使って読み込みます。afterInteractive にすることでクリティカルパスから外れます。
app/layout.tsximport Script from "next/script"; export default function RootLayout({ children }) { return ( <html> <body> {children} <Script src="https://helpbrain.net/w/YOUR_BOT_KEY.js" strategy="afterInteractive" /> </body> </html> ); }Vite・Create React App など、あらゆるSPA
index.html の </body> 直前に、通常のスニペットを追加します。React固有の作業はありません。ウィジェットは document.body に自分で取り付くので、アプリの再レンダリングの影響を受けません。
index.html<script src="https://helpbrain.net/w/YOUR_BOT_KEY.js" async></script>
メモ
ウィジェットはReactのツリーの外側で独自に状態を保持します。そのため、クライアント側のルート遷移で開いている会話がリセットされることはありません。
ページテンプレートを開く
全ページで描画されるテンプレート(多くはフッターを含むもの)を開きます。
</body> の直前に貼り付ける
閉じ </body> タグのすぐ上の行に貼り付けます。
必要な場合だけ繰り返す
フッターを共通のインクルードで管理しているなら1か所で十分です。各ページが独立したファイルなら、それぞれに貼り付けてください。
3. 設置できたか確認する
ダッシュボードを開いているかどうかで、2つの方法があります。
自分のサイトを見る
シークレットウィンドウでサイトを開き、設定した側の隅を見てください。チャットボタンは自動で表示されます。会話本体は誰かがクリックしたときにはじめて読み込まれるため、ページは軽いままです。
設置確認を使う
ダッシュボードの設置ページには「設置を確認」ボタンがあります。こちら側からあなたのホームページを取得し、ボットのキーを探します。
メモ
ファイアウォールでこちらからのアクセスがブロックされている場合は、「スニペットがない」と主張するのではなく、ページに到達できなかったと伝えます — この2つは別の問題であり、混同しません。
コンテンツセキュリティポリシー(CSP)
サイトが Content-Security-Policy ヘッダーを送っている場合は、2つのディレクティブでこちらのオリジンを許可してください。scriptがチャットボタンを読み込み、frameが会話本体です。会話はこちらのオリジンで動くため、あなたのページに触れることはありません。
Content-Security-Policy:
script-src 'self' https://helpbrain.net;
frame-src 'self' https://helpbrain.net;connect-src の追加は不要です。チャットの通信はフレームの内側から、フレーム自身のオリジンで行われ、あなたのページからは発生しません。
表示されないとき
よくある原因は、ページキャッシュがまだ切れていない、スニペットが共通テンプレートではなく特定ページの本文に入ってしまっている、ポリシーがこちらのオリジンを遮断している、のいずれかです。これらを含めた対処はこちらにまとめてあります: