ダッシュボードに戻る

ドキュメント

Asyntaiの使い方を学ぶ

埋め込みチャット

フローティングバブルではなくページ内にチャットウィジェットをインラインで表示

埋め込みコードの取得
全プラン

概要

デフォルトでは、Asyntaiチャットウィジェットはウェブサイトの角にフローティングバブルとして表示されます。埋め込みチャットを使用すると、ページ上に直接チャットを表示することもできます。例えば、ホームページの「チャットで相談」セクションなどです。

フローティングバブルは埋め込みチャットと並行して機能します。埋め込みセクションまでスクロールしない訪問者は引き続きバブルを使用できます。両方が同じ会話を共有します。

仕組み

1
scriptタグを1つ追加 HTMLでチャットを表示したい場所に配置します
2
チャットがインラインで表示されます ウィジェットはその位置に常に表示され、通常のチャットと同じサイズです
3
バブルはアクティブなまま 埋め込みチャットが見えない訪問者のために、フローティングバブルは隅に残ります
4
共有される会話 メッセージは埋め込みチャットとフローティングウィジェット間でリアルタイムに同期されます

セットアップ

チャットをページに表示したい場所にこの1行のHTMLを追加してください:

<script src="https://asyntai.com/static/js/chat-embed.js" data-asyntai-id="YOUR_WIDGET_ID"></script>

YOUR_WIDGET_IDをウィジェットIDに置き換えてください。IDが事前入力された埋め込みコードは埋め込みチャット設定ページで確認できます。

注記: メインのchat-widget.jsスクリプトもページ上に必要です。すでにAsyntaiウィジェットをサイトにインストールしている場合は、これはすでに対応済みです。

ホームページでの使用例:

<section style="max-width: 500px; margin: 0 auto;">
    <h2>Chat with us</h2>
    <p>Ask us anything — our AI assistant is here to help.</p>

    <!-- The chat will appear right here -->
    <script src="https://asyntai.com/static/js/chat-embed.js" data-asyntai-id="YOUR_WIDGET_ID"></script>
</section>

詳細

サイズ設定

埋め込みチャットはフローティングウィジェットと同じサイズで表示されます:デスクトップでは幅400px、高さ650px、モバイルでは全幅、高さ550pxです。親コンテナのスタイリングで配置を制御できます。

フローティングバブルの動作

埋め込みチャットが画面に表示されている状態で訪問者がフローティングバブルをクリックすると、埋め込みチャットまでスクロールします。埋め込みチャットが表示されていない場合、バブルは通常のフローティングチャットオーバーレイを開きます。

メッセージの同期

埋め込みチャットとフローティングチャットは同じ会話を共有します。どちらから送信されたメッセージも両方に表示されます。同じセッション、AIコンテキスト、チャット履歴が使用されます。

複数ページ

一部のページで埋め込みチャットを使用し、他のページで通常のフローティングウィジェットを使用できます。インラインチャットを表示したいページに埋め込みスクリプトを含めるだけです。会話は通常どおりページ間で引き継がれます。

ライブプレビュー

こちらがライブの埋め込みチャットです。表示を確認できます:

要件

メインのAsyntaiチャットウィジェット(chat-widget.js)がページにインストールされている必要があります
すべてのプランで利用可能 — アップグレードは不要です
Shadow DOMをサポートするすべてのブラウザに対応しています(すべてのモダンブラウザ)

ヒント: まずステージングページに埋め込みチャットを配置してテストしてください。本番環境に公開する前に、ページレイアウト内で正しく表示されることを確認してください。