ダッシュボードに戻る

ドキュメント

Asyntaiの使い方を学ぶ

October CMSにAsyntai AIチャットボットを追加する方法

October CMSウェブサイトのステップバイステップガイド

埋め込みコードの取得

ステップ1:埋め込みコードを取得する

まず、Asyntaiダッシュボードに移動し、「埋め込みコード」セクションまでスクロールしてください。次のような固有の埋め込みコードをコピーしてください:

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

注記: 上記のコードは一例です。個人のウィジェットIDが含まれているため、ダッシュボードから固有の埋め込みコードをコピーしてください。

ステップ2:レイアウトテンプレートに追加(推奨)

チャットボットを追加する推奨方法は、October CMSバックエンドでデフォルトレイアウトを編集することです:

  1. October CMSバックエンドにログインしてください
  2. メインメニューでCMS > Layoutsに移動してください
  3. デフォルトレイアウト(通常はdefault.htm)を開いてください
  4. 閉じタグを見つけてください </body> タグと {% scripts %} プレースホルダー
  5. Asyntaiの埋め込みコードを直前に追加してください {% scripts %}</body>
    <script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script> {% scripts %} </body>
  6. 「保存」をクリックして変更を適用してください

ヒント: Placing the script before {% scripts %} and </body> ensures it loads after the page content, which is recommended for chat widgets and won't slow down your page loading.

Alternative Method 1: Using {% put scripts %} Block

October CMSのスクリプトプレースホルダーを使用して、ページまたはパーシャルからチャットボットを挿入できます:

  1. CMSエディタで任意のページまたはパーシャルを開いてください
  2. 以下のコードを使用して追加してください {% put scripts %} ブロック:
    {% put scripts %} <script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script> {% endput %}
  3. YOUR_WIDGET_IDをダッシュボードから取得した実際のウィジェットIDに置き換えてください
  4. 「保存」をクリックしてください

注記: For this method to work, your layout must include the {% scripts %} placeholder in its markup. This is where October CMS renders all injected scripts. Most default layouts already include this tag.

代替方法2:コンポーネントPHPを使用

プログラム的なアプローチを好む場合は、カスタムコンポーネントを介してチャットボットスクリプトを追加できます:

  1. October CMSプラグインでコンポーネントを作成または変更してください
  2. コンポーネントのonRun()メソッドで、addJs()メソッドを使用してください:
    public function onRun() { $this->addJs('https://asyntai.com/static/js/chat-widget.js', [ 'async' => true, 'data-asyntai-id' => 'YOUR_WIDGET_ID' ]); }
  3. YOUR_WIDGET_IDを実際のウィジェットIDに置き換えてください
  4. チャットボットを表示したいページにコンポーネントを登録してください

ヒント: コンポーネントを使用すると、チャットボットの読み込みタイミングと場所をプログラム的に制御できます。onRun()内に条件ロジックを追加して、ユーザーロール、ページタイプ、その他の基準に基づいて読み込みを制御できます。

代替方法3:パーシャルを使用

チャットボットウィジェット用の再利用可能なパーシャルを作成できます:

  1. October CMSバックエンドのCMS > Partialsに移動してください
  2. 「+ Add」をクリックして新しいパーシャルを作成してください
  3. asyntai-widget.htmと名前を付けてください
  4. パーシャルにAsyntai埋め込みコードを追加してください:
    <script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>
  5. 「保存」をクリックしてください
  6. レイアウトテンプレートを開き、</body>の前にパーシャルをインクルードしてください:
    {% partial 'asyntai-widget' %}
  7. レイアウトを保存してください

ヒント: パーシャルを使用すると、レイアウトからパーシャルのインクルードを追加または削除するだけで、サイト全体でチャットボットを簡単に有効化・無効化できます。

ステップ3:インストールの確認

変更を保存した後、新しいブラウザタブまたはシークレットウィンドウでOctober CMSウェブサイトにアクセスしてください。右下にチャットウィジェットボタンが表示されるはずです。クリックして正しく開き、正常に動作することを確認してください。

ウィジェットが表示されませんか? CMSバックエンドですべての変更を保存したことを確認してください。ブラウザのキャッシュをクリアするか、シークレットウィンドウで表示してください。サイトがキャッシュを使用している場合は、コマンドラインからphp artisan cache:clearを実行するか、バックエンドのSettings > System > Clear Cacheオプションを使用してOctober CMSキャッシュをクリアしてください。

レイアウトの選択: チャットボットを表示したいページが正しいレイアウトを使用していることを確認してください。CMS > Pagesでページを開き、ページ設定のLayoutドロップダウンを確認することで、ページが使用しているレイアウトを確認できます。