ダッシュボードに戻る

ドキュメント

Asyntaiの使い方を学ぶ

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

Drupalウェブサイトのためのステップバイステップガイド

埋め込みコードの取得

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

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

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

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

ステップ2:Header and Footer Scriptsモジュールを使用(推奨)

チャットボットを追加する最も簡単な方法は、「Header and Footer Scripts」モジュールを使用することです:

  1. Drupal管理パネルにログインします
  2. 拡張に移動し、「新しいモジュールをインストール」をクリックしてください
  3. 「Header and Footer Scripts」を検索するか、Drupal.orgからダウンロードしてください
  4. モジュールをインストールして有効にします
  5. 設定 → 開発 → Header and Footer Scriptsに移動します
  6. 「フッター」タブをクリックしてください
  7. Paste your Asyntai embed code in the footer scripts text area
  8. 「設定を保存」をクリックしてください

ヒント: フッターセクションにコードを追加すると、ページコンテンツの後に読み込まれるため、チャットウィジェットに推奨されます。

代替方法:テーマテンプレートを編集

テーマのテンプレートファイルにコードを直接追加できます:

  1. テーマフォルダに移動します:themes/your_theme/
  2. html.html.twigファイルを開きます(存在しない場合は作成します)
  3. </body>閉じタグを見つけます
  4. </body>タグの直前にAsyntaiの埋め込みコードを貼り付けます
  5. ファイルを保存します
  6. Drupalのキャッシュをクリアします:設定 → パフォーマンス → すべてのキャッシュをクリア

重要: テーマファイルへの変更は、テーマの更新時に上書きされる場合があります。より永続的なソリューションとして、子テーマまたはHeader and Footer Scriptsモジュールの使用を検討してください。

代替方法:ライブラリを使用(開発者向け)

Drupalのアセットライブラリシステムを使用する開発者向け:

  1. テーマの*.libraries.ymlファイルを作成または編集します
  2. 新しいライブラリエントリを追加します:
    asyntai-chatbot:
    js:
    https://asyntai.com/static/js/chat-widget.js: { type: external, attributes: { async: true, data-asyntai-id: YOUR_WIDGET_ID } }
  3. Attach the library in your theme's *.info.yml file:
    libraries:
    - your_theme/asyntai-chatbot
  4. Drupalのキャッシュをクリアします

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

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

ウィジェットが表示されませんか? 設定 → パフォーマンス → すべてのキャッシュをクリアに移動してDrupalのキャッシュをクリアしてください。ブラウザのキャッシュをクリアするか、シークレットウィンドウで表示してみてください。