ウェブサイトを接続

ページ、商品、注文をプラットフォームから直接読み取ります

Standard・Pro・Enterprise プラン

概要

ウェブサイトの接続では、AI にプラットフォームへの読み取り専用キーを渡します。外側からページをクロールする代わりに、プラットフォームに直接問い合わせます。

これにより、クローラーでは届かないコンテンツにも到達します。ログインの内側にあるページ、どこからもリンクされていない深いページ、ボット対策の内側にあるサイトも取り込めます。価格と在庫は読み直すため常に最新で、クロールした日のページの記載に頼りません。

読み取り専用です。 サイト上のものを作成、変更、削除することはありません。当社の通信はすべて読み取りです。

3 種類のデータ

共有する内容はお客様が選びます。それぞれの選択が、アシスタントが答えられる内容に対応します。

選択	取り込まれる内容	アシスタントが答えられること
ページ	サイトのコンテンツを自動で同期します。	ポリシー、サービス、コース、ガイド、その他あらゆる文章ページに関する質問。
商品	最新の価格、在庫、リンク、画像。	何を販売しているか、価格、在庫の有無、購入用のリンク。
注文	お客様向けの注文状況の照会。	お客様の注文が今どこにあるか、いつ発送されたか、何が含まれていたか。

どのプラットフォームが使えるか

すべてです。サイトが何で作られていても、アシスタントはページ、商品、注文をもとに回答できます。

API キーで直接読み取れるプラットフォームもあります。それ以外では、同じデータをクロール、商品フィード、ユーザーコンテキスト、またはお客様独自のツールから取り込みます。どれが該当するか調べる必要はありません。ダイアログを開き、プラットフォームを選び、共有したい項目にチェックを入れると、お客様の場合の手順が表示されます。

お使いのプラットフォームの手順を確認

サイトをご自分で作られましたか。 ダイアログで「カスタム / CMSなし」を選んでください。自作サイト、ヘッドレス構成、一覧にないプラットフォームも同じように動作します。

WooCommerce ストアでは認証情報が 2 つ必要です。 WooCommerce は商品と注文を読み取ります。ページはその下の WordPress から取得するため、専用のアプリケーションパスワードが必要です。2 つ目のキーが必要なときはダイアログが知らせます。

接続の手順

ダッシュボードを開き、「ナレッジベースに追加」の隣にあるウェブサイトを接続を探します。
一覧からプラットフォームを選びます。サイトをご自分で作られた場合はカスタム / CMSなしを選んでください。
共有したい項目にチェックを入れます。ページ、商品、注文、またはその組み合わせです。
続行を押します。お使いのプラットフォームと選択内容に合わせた設定手順が表示されます。
プラットフォームの管理画面で手順に従い、キーを作成します。
同じダイアログ下部の入力欄にキーを貼り付け、「接続」を押します。

「接続」を押すと何が起きるか

認証情報は保存する前に確認します。誤ったキーが保存されることはありません。

貼り付けられた認証情報で、お使いのプラットフォームへ実際に 1 回問い合わせます。
失敗した場合はボタンの下にエラーが表示され、入力欄は編集可能なままなので修正できます。
成功した場合は接続を保存し、コンテンツの読み取りを開始します。
その後ダイアログが結果を報告します。取り込んだ件数、または何が問題だったかを表示します。

最初の読み取りはバックグラウンドで実行されます。ダイアログを閉じても自動で完了します。

権限とアクセス

キーがどこまで見えるかはプラットフォームによって異なり、その違いは重要です。

Magento、Shopify、WooCommerce、BigCommerce はリソースごとに権限を付与します。商品だけにチェックを入れれば、キーが届くのは実際に商品だけです。

WordPress と Moodle はそうではありません。WordPress のアプリケーションパスワードは、作成したアカウントの権限をそのまま引き継ぎます。Moodle のトークンも、そのユーザーが見えるものを見ます。チェックする権限一覧はありません。回答させたいコンテンツ以上のアクセス権を持たないアカウントを使い、非公開の投稿やパスワード保護された投稿も取り込まれる点にご注意ください。

当社側では、コンテンツ用のルートのみを、GET でのみ読み取ります。書き込みは一切行いません。

API キーなしで接続する

どの選択にも、キーがまったく不要な方法があります。どのプラットフォームでも使え、設定ダイアログが手順と並べて案内します。

次の代わりに	使用	何をするか
ページ	クロール	サイト全体を読み取り、その内容をナレッジベースに保持します。
商品	リアルタイムデータフィード	公開されている商品フィードの URL をご指定ください。価格と在庫はそこから同期されます。
注文	ユーザーコンテキストまたはカスタムツール	ログイン中のお客様の情報をサイトから送るか、アシスタントが呼び出せる独自のエンドポイントを接続します。

接続を解除する

ダイアログからプラットフォームの設定ページを開き、「接続解除」を押します。保存された認証情報が削除され、そのキーで取り込んだ内容もナレッジベースから削除されます。他のソースの内容はそのまま残ります。

プラットフォーム側でキーを失効させることもできます。その場合、次回の同期は認証エラーで失敗し、新しい内容は読み取られません。

トラブルシューティング

表示される内容	通常の意味
認証に失敗しました	キーが誤っている、期限切れ、または失効しています。WordPress では、アプリケーションパスワードではなく通常のログインパスワードを貼り付けた場合にも起こります。
完了しましたが、読み込む対象が見つかりませんでした	認証情報は有効ですが、その背後のアカウントがコンテンツを閲覧できません。回答させたいページや商品にアクセスできるアカウントを選んでください。
接続しましたが、コンテンツを読み込めませんでした	キーは受け入れられ、その後の読み取りが失敗しました。プラットフォームから返された正確なエラーがメッセージとともに表示されます。
権限が不足しています	手順に挙げたリソースのいずれかが欠けた状態でキーが作成されています。ダイアログが示したすべての権限を付けて作り直してください。

ドキュメント