一行のスクリプトタグで LangBot チャットウィジェットを任意のウェブサイトに埋め込みます。
ボットの作成
LangBot WebUI を開き、ボット > ボットを作成 に移動し、ボット名を入力し、プラットフォーム/アダプターで ページボット を選択します。
設定項目
| 項目 | 説明 |
|---|
| コンポーネントタイトル | チャットウィジェットの上部に表示されるタイトル。デフォルトは LangBot |
| バブルアイコン | フローティングチャットバブルに表示されるアイコン |
| コンポーネント言語 | チャットウィジェットの表示言語（簡体字中国語、英語など） |
| Turnstile サイトキー | Cloudflare Turnstile のサイトキー。bot 対策用。空なら無効 |
| Turnstile シークレットキー | Cloudflare Turnstile のシークレットキー。サイトキーと一緒に Cloudflare コンソールで取得。サイトキー設定時に必須 |
埋め込みコードの取得
作成・保存後、ボット設定ページの 埋め込みコード エリアに自動生成された <script> タグが表示されます。
このコードをコピーしてウェブサイトの HTML に貼り付けます（通常は </body> の前）。ページの右下にチャットバブルが表示され、ビジターがボットとチャットできるようになります。
<script data-title="LangBot" src="http://localhost:5300/api/v1/embed/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"></script>
埋め込みコードの URL はデフォルトで localhost です。LangBot をサーバーにデプロイしている場合は、localhost:5300 を実際のアドレスに置き換えてください。
bot 対策（オプション）
Cloudflare Turnstile を有効にして bot 対策を行えます：
- Cloudflare Turnstile > サイトを追加 に移動
- サイトキー と シークレットキー を取得
- LangBot ページボットの対応するフィールドに入力
- 保存して反映
使い方
埋め込みコードをウェブサイトに追加後、ページ右下のチャットバブルをクリックするとボットとチャットできます。 