Asyntai AIチャットボットを任意のウェブサイトに追加する方法

HTML、カスタムサイト、静的ジェネレーター向けの汎用ガイド

プラットフォーム:

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

First, go to your Asyntai Dashboard and scroll down to the "Embed Code" section. Copy your unique embed code which will look like this:

<script>(function(){var l=function(){var s=document.createElement("script");s.src="https://widget.asyntai.com/static/js/chat-widget.js";s.async=true;s.setAttribute("data-asyntai-id","YOUR_WIDGET_ID");document.head.appendChild(s)};if(document.readyState==="complete"){l()}else{window.addEventListener("load",l)}})();</script>

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

ステップ2：HTMLファイルへの追加

チャットボットを追加する最も簡単な方法は、HTMLファイルに埋め込みコードを直接貼り付けることです：

テキストエディターでHTMLファイルを開きます
</body>閉じタグを見つけます
</body>タグの直前にAsyntaiの埋め込みコードを貼り付けます
ファイルを保存します

<!DOCTYPE html>
<html>
<head>
  <title>My Website</title>
</head>
<body>
  <!-- Your website content -->

  <!-- Asyntai Chatbot - Add before closing body tag -->
  <script>(function(){var l=function(){var s=document.createElement("script");s.src="https://widget.asyntai.com/static/js/chat-widget.js";s.async=true;s.setAttribute("data-asyntai-id","YOUR_WIDGET_ID");document.head.appendChild(s)};if(document.readyState==="complete"){l()}else{window.addEventListener("load",l)}})();</script>
</body>
</html>

ヒント: 閉じ</body>タグの前にスクリプトを追加することで、ページコンテンツの後に読み込まれるようになります。これはパフォーマンスに最適で、ページの速度を低下させません。

複数ページのウェブサイトの場合

ウェブサイトに複数のHTMLページがある場合、いくつかの選択肢があります：

オプションA：各ページに追加

チャットボットを表示したい各HTMLファイルに埋め込みコードを追加します。

オプションB：共通フッターインクルードの使用

サーバーサイドインクルード（SSI）、PHPインクルード、または類似の技術を使用している場合：

footer.html（またはfooter.php）ファイルを作成します
このファイルにAsyntaiの埋め込みコードを追加します
このフッターファイルをすべてのページにインクルードします：
 <?php include 'footer.php'; ?>

オプションC：JavaScriptによる動的読み込み

すべてのページでチャットボットを読み込む単一のJavaScriptファイルを作成します：

asyntai-loader.jsというファイルを作成します：
(function() { var script = document.createElement('script'); script.async = true; script.src = 'https://asyntai.com/static/js/chat-widget.js'; script.setAttribute('data-asyntai-id', 'YOUR_WIDGET_ID'); document.body.appendChild(script); })();
YOUR_WIDGET_IDを実際のウィジェットIDに置き換えてください
このスクリプトをすべてのページにインクルードします：
<script src="/js/asyntai-loader.js"></script>

静的サイトジェネレーターの場合

静的サイトジェネレーターを使用している場合、ベースレイアウトまたはテンプレートに埋め込みコードを追加します：

Jekyll

_includes/footer.htmlまたは_layouts/default.htmlに追加します

Hugo

layouts/partials/footer.htmlまたはlayouts/_default/baseof.htmlに追加します

Gatsby

gatsby-browser.jsに追加するか、gatsby-ssr.jsを使用します

Next.js

pages/_document.jsに追加するか、next/scriptコンポーネントを使用します

Nuxt.js

nuxt.config.jsのhead.scriptに追加します

Eleventy (11ty)

_includes/のベースレイアウトに追加します

Astro

src/layouts/Layout.astroの</body>の前に追加します

VuePress

.vuepress/config.jsのheadに追加します

React / Vue / Angularアプリの場合

シングルページアプリケーション（SPA）の場合、index.htmlにスクリプトを追加するか、動的に読み込むことができます：

React（index.html方式）

<!-- In public/index.html, before </body> -->
<script>(function(){var l=function(){var s=document.createElement("script");s.src="https://widget.asyntai.com/static/js/chat-widget.js";s.async=true;s.setAttribute("data-asyntai-id","YOUR_WIDGET_ID");document.head.appendChild(s)};if(document.readyState==="complete"){l()}else{window.addEventListener("load",l)}})();</script>

React（useEffect方式）

// In your App.js or a component
useEffect(() => {
  const script = document.createElement('script');
  script.src = 'https://asyntai.com/static/js/chat-widget.js';
  script.async = true;
  script.setAttribute('data-asyntai-id', 'YOUR_WIDGET_ID');
  document.body.appendChild(script);
  return () => document.body.removeChild(script);
}, []);

Vue（main.jsまたはApp.vue内）

// In mounted() or onMounted()
const script = document.createElement('script');
script.src = 'https://asyntai.com/static/js/chat-widget.js';
script.async = true;
script.setAttribute('data-asyntai-id', 'YOUR_WIDGET_ID');
document.body.appendChild(script);

Angular（index.html内）

<!-- In src/index.html, before </body> -->
<script>(function(){var l=function(){var s=document.createElement("script");s.src="https://widget.asyntai.com/static/js/chat-widget.js";s.async=true;s.setAttribute("data-asyntai-id","YOUR_WIDGET_ID");document.head.appendChild(s)};if(document.readyState==="complete"){l()}else{window.addEventListener("load",l)}})();</script>

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

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

ウィジェットが表示されませんか？ スクリプトが</body>タグの前に正しく配置されていることを確認してください。ブラウザのコンソール（F12キーを押して開発者ツールを開く）にJavaScriptエラーがないことを確認してください。ブラウザのキャッシュをクリアするか、シークレットウィンドウで表示してみてください。

重要: チャットボットはウェブサイトがHTTPまたはHTTPS経由で配信されている必要があります（ファイルとして直接開くことはできません）。ローカルでテストする場合は、ローカル開発サーバーを使用してください。

ドキュメント