Rapls AI Chatbot

説明

Rapls AI Chatbot は OpenAI、Claude、Gemini、OpenRouter を使った AI チャットボットをサイトに追加します。サイト学習、ナレッジベース、ウェブ検索を搭載しています。

主な機能

• 複数 AI プロバイダー — OpenAI、Anthropic Claude、Google Gemini、OpenRouter (単一 API キーで100以上のモデル)
• ウェブ検索 — ナレッジベースに十分な回答がない場合、各プロバイダーの組み込み機能 (OpenAI web_search_preview、Claude web_search、Gemini google_search) を使用して AI が自動的にウェブ検索
• サイト学習 — ウェブサイトコンテンツ (投稿、固定ページ、カスタム投稿タイプ、WooCommerce 商品) をクロール・インデックス化してコンテキストを考慮した応答を実現
• ベクトル埋め込み RAG — キーワードマッチング (40%) とベクトル類似度 (60%) を組み合わせたハイブリッド検索で精度の高い検索を実現
• カスタムナレッジベース — Q&A ペア、自由形式コンテンツ、PDF/DOCX アップロードに優先度レベルと下書き/公開ワークフロー付き
• MCP サーバー — JSON-RPC 2.0 による7つの組み込みツールで AI エージェント連携 (Claude Desktop、Cursor、VS Code)
• WordPress Abilities API — MCP ツールを WordPress Abilities として自動登録し、MCP アダプターによる検出を可能に
• Gutenberg ブロック — ブロックエディターで AI Chatbot ブロックを挿入、高さ・テーマ・bot-id 設定が可能、SSR 対応
• 応答言語の自動検出 — ブラウザー言語を自動検出してウェルカムメッセージと AI 応答に適用
• クロスサイト埋め込み — iframe またはスクリプトローダーで外部サイトにチャットボットを埋め込み
• 会話履歴 — 保持期間を設定してすべてのチャット会話を保存・確認
• 利用統計 — ビジュアルチャートとプロバイダー別内訳でトークン使用量と推定 API 費用を追跡
• フィードバックと再生成 — ユーザーが応答を評価 (高評価/低評価) して再生成をリクエスト可能
• 6種類の組み込みテーマ — Default、Simple、Classic、Light、Minimal、Flat
• セキュリティ — reCAPTCHA v3、レート制限、同意モード、Cloudflare 対応、セキュリティ診断
• 設定のインポート/エクスポート — すべての設定を JSON でバックアップ・復元
• 多言語対応 — 日本語翻訳同梱、ウェルカムメッセージは13言語で設定可能

対応 AI モデル

OpenAI:
* GPT-5.2、GPT-5.1、GPT-5 シリーズ (最新世代)
* GPT-4.1 シリーズ (ロングコンテキスト、100万トークン)
* GPT-4o、GPT-4o-mini (マルチモーダル)
* o1、o3、o4-mini (推論モデル)

Anthropic Claude:
* Claude Opus 4.6 (最高性能)
* Claude Sonnet 4.5 (推奨 — 高速かつ高性能)
* Claude Haiku 4.5 (推奨 — 最速)
* Claude Opus 4.5、Opus 4.1、Sonnet 4、3.7 Sonnet

Google Gemini:
* Gemini 3 Pro/Flash (プレビュー、最新)
* Gemini 2.5 Pro/Flash (推奨)
* Gemini 2.0 Flash (安定版)
* Gemini 1.5 Pro/Flash (レガシー)

OpenRouter:
* 単一の API キーで複数プロバイダーの100以上のモデルにアクセス

ダッシュボード

ダッシュボードではチャットボットのアクティビティを一目で確認できます:

• 統計カード: 会話総数、本日のメッセージ数、インデックス済みページ数、ナレッジエントリ数、使用制限付き月間 AI 応答数
• ステータスインジケーター: AI プロバイダー、サイト学習、会話履歴
• API 利用統計 (過去30日間): 総トークン数、入力/出力トークン数、推定費用、日別使用量チャート、プロバイダー別内訳

設定 (5タブ)

AI 設定 — AI プロバイダー、モデル、API キーを設定。埋め込みプロバイダーによるベクトル検索 (RAG) を有効化。API キー生成と Claude Desktop 設定例による MCP サーバーのセットアップ。

チャット設定 — ボット名、アバター (絵文字または画像)、ウェルカムメッセージ (13言語: 英語、日本語、中国語、韓国語、スペイン語、フランス語、ドイツ語、ポルトガル語、イタリア語、ロシア語、アラビア語、タイ語、ベトナム語)、システムプロンプト、応答言語、メッセージ履歴数、フィードバックボタン、API クォータエラーメッセージをカスタマイズ。詳細設定: ナレッジマッチング、Q&A 形式、サイト学習のコンテキストプロンプト、再生成指示、良い例/悪い例の学習、会話要約の機能プロンプト。

表示設定 — 6つの無料テーマ (Default、Simple、Classic、Light、Minimal、Flat) から選択。バッジ位置 (4隅グリッド)、マージン、プライマリ/セカンダリカラー、モバイル表示、Markdown レンダリング、タイピングインジケーター、最大入力長、ページ除外、フッターテキスト、クロスサイト埋め込みオプション (スクリプトまたは iframe) を設定。

セキュリティ設定 — サイトキー、シークレットキー、スコアしきい値で reCAPTCHA v3 を有効化。アクセス制御の設定: 同意厳格モード、レート制限、Cloudflare 連携、リバースプロキシ信頼、reCAPTCHA 失敗モード。セキュリティ診断の表示 (読み取り専用): 許可オリジン、信頼プロキシ、IP 検出、API キー状態、WP Consent API、レート制限、reCAPTCHA、SSL/TLS、CSRF。

データ管理 — 保持期間を設定して会話履歴の有効/無効を切り替え。設定のインポート/エクスポート (オプションでナレッジベースを含む)。すべての設定をデフォルトにリセット。

ナレッジベース

• テキストとしてエントリを追加: タイトル、コンテンツ、カテゴリー、優先度レベル
• ファイルインポート: .txt、.csv、.md、.pdf、.docx (サーバーサイド解析)
• 統計: エントリ総数、有効、無効、カテゴリー
• ステータスでフィルター: すべて、公開済み、下書き
• ソート可能なテーブル: ID、タイトル、カテゴリー、タイプ、優先度、更新日
• 無制限のエントリ

サイト学習

プラグインは公開コンテンツをクロールしてインデックス化し、コンテキストを考慮した AI 応答を提供します:

• 投稿と固定ページ
• カスタム投稿タイプ
• WooCommerce 商品
• すべての公開コンテンツ

ベクトル埋め込みを有効にすると、ハイブリッド検索がキーワードマッチング (40%) とベクトル類似度 (60%) を組み合わせ、より精度の高い検索を実現します。

Free と Pro の比較

無料版は人為的な制限なしで完全に機能します。支払うのは AI API の利用料金のみです。ビジネス向け機能にはオプションの Pro アドオンが利用可能です。

• Free — フル AI チャット、無制限の応答、無制限のナレッジベース、6種類のテーマ、MCP サーバー、Gutenberg ブロック
• Pro — 分析、リード獲得、シナリオ、オペレーターモード、WooCommerce、LINE などを追加

Free に含まれる機能:

• 4つの AI プロバイダーすべて (OpenAI、Claude、Gemini、OpenRouter)
• 無制限の AI 応答とナレッジベースエントリ
• ウェブ検索、ベクトル RAG 付きサイト学習
• MCP サーバー、Gutenberg ブロック、クロスサイト埋め込み
• 6種類のテーマ、フィードバック、再生成、reCAPTCHA、セキュリティ診断

Pro で追加される機能:

• 満足度スコア、FAQ ランキング、PDF エクスポート付き分析ダッシュボード
• リード獲得フォーム、CSV/JSON エクスポート、Webhook、Google Sheets
• 会話シナリオ、営業時間、有人対応への引き継ぎ、オペレーターモード
• WooCommerce 商品カード、LINE Messaging API、Slack 通知
• 10種類の追加テーマ、ダークモード、音声入力/TTS、マルチモーダル
• 応答キャッシュ、暗号化、監査ログなど

詳細は raplsworks.com をご覧ください

外部サービス

このプラグインは以下の外部サードパーティサービスに接続します。API キーを設定してプラグイン設定で機能を有効化するまで、いかなるサービスにもデータは送信されません。各サービスの利用にはサイト管理者がアカウントを作成し、API 資格情報を取得する必要があります。これらのサービスを利用することで、以下に記載されたそれぞれの利用規約とプライバシーポリシーに同意したことになります。

1. OpenAI (GPT モデル) — AI プロバイダー

OpenAI を AI プロバイダーとして選択した場合に使用されます。ユーザーメッセージとオプションでサイトコンテンツが AI 応答の生成のために送信されます。

• サービス URL: https://api.openai.com/
• 利用規約: https://openai.com/terms/
• プライバシーポリシー: https://openai.com/privacy/

2. Anthropic (Claude モデル) — AI プロバイダー

Anthropic Claude を AI プロバイダーとして選択した場合に使用されます。ユーザーメッセージとオプションでサイトコンテンツが AI 応答の生成のために送信されます。

• サービス URL: https://api.anthropic.com/
• 利用規約: https://www.anthropic.com/terms
• プライバシーポリシー: https://www.anthropic.com/privacy

3. Google (Gemini モデル) — AI プロバイダー

Google Gemini を AI プロバイダーとして選択した場合に使用されます。ユーザーメッセージとオプションでサイトコンテンツが AI 応答の生成のために送信されます。

• サービス URL: https://generativelanguage.googleapis.com/
• 利用規約: https://policies.google.com/terms
• プライバシーポリシー: https://policies.google.com/privacy

4. OpenRouter — AI プロバイダー

OpenRouter を AI プロバイダーとして選択した場合に使用されます。OpenRouter はリクエストをさまざまな AI モデルにルーティングする統合 API ゲートウェイです。

• サービス URL: https://openrouter.ai/api/
• 利用規約: https://openrouter.ai/terms
• プライバシーポリシー: https://openrouter.ai/privacy

5. Google reCAPTCHA v3 (オプション)

スパム対策のためにプラグイン設定で reCAPTCHA を有効にした場合のみ使用されます。訪問者の IP アドレスとインタラクションデータが検証のため Google に送信されます。

• サービス URL: https://www.google.com/recaptcha/
• 利用規約: https://policies.google.com/terms
• プライバシーポリシー: https://policies.google.com/privacy

6. LINE Messaging API (Pro アドオン、オプション)

Pro アドオンで LINE 連携を有効にした場合のみ使用されます。LINE Messaging API に接続してチャットボットから LINE へのメッセージングを行います。

• サービス URL: https://api.line.me/
• 利用規約: https://terms.line.me/
• プライバシーポリシー: https://line.me/en/terms/policy/

クロスサイト埋め込み

プラグインには、iframe を使用して外部サイトにチャットボットを埋め込むためのオプションの埋め込みローダースクリプト (embed-loader.js) が含まれています。このスクリプトは外部 CDN リソースやサードパーティスクリプトを読み込みません。自分の WordPress サイトを指す iframe を作成するだけです。すべてのデータ処理はサーバー上で行われます。

外部サービスに送信されるデータ

• ユーザーメッセージ: 訪問者が入力したチャットメッセージ (設定された AI プロバイダーにのみ送信)
• サイトコンテンツ (サイト学習が有効な場合): 公開済み投稿/ページの抜粋 (設定された AI プロバイダーに送信)
• ナレッジベース (設定済みの場合): 作成したカスタム Q&A エントリ (設定された AI プロバイダーに送信)
• IP アドレス (reCAPTCHA のみ): スパム検証のため Google に送信

データストレージ

• 会話履歴: WordPress データベースにローカル保存 (無効化可能)
• 訪問者 IP: レート制限のため SHA-256 ハッシュとして保存 (平文ではありません)
• 保持期間: 自動削除期間を設定可能 (デフォルト90日間)

ユーザーコントロール

以下の機能はプラグイン設定で無効化できます:
* 会話履歴の保存
* サイトコンテンツのクロール/学習
* Google reCAPTCHA 認証
* ウェブ検索

プライバシー

収集されるデータ

会話履歴が有効な場合、プラグインは以下を保存します:
* チャットメッセージ (ユーザーと AI の応答)
* セッション識別子
* チャットが行われたページの URL
* ハッシュ化された IP アドレス (SHA-256、不可逆)
* タイムスタンプ

データ保持

会話データは設定された保持期間 (デフォルト: 90日間) 経過後に自動削除されます。管理者はいつでも手動で会話を削除できます。

ユーザーの権利

サイト管理者は以下のことができます:
* すべての会話履歴を表示
* 個別またはすべての会話を削除
* 設定をエクスポート (会話データは含まれません)
* 履歴の保存を完全に無効化= Developer Information =

プラグインはカスタマイズ用のフックとフィルターを提供します:

利用可能なフィルター

• raplsaich_system_prompt — AI に送信するシステムプロンプトを変更
• raplsaich_context — サイト学習からのコンテキストを変更
• raplsaich_ai_response — 表示前に AI 応答をフィルター
• raplsaich_chatbot_enabled — チャットボットの表示をプログラムで制御
• raplsaich_allowed_origins — 同一オリジンチェック用の許可オリジンホストを追加
• raplsaich_chat_response_data — クライアントに返す前にチャット応答データをフィルター
• raplsaich_gpt5_token_multiplier — GPT-5 推論トークン乗数 (デフォルト: 4、範囲: 1-8)

例: カスタムシステムプロンプト

add_filter( 'raplsaich_system_prompt', function( $prompt, $settings ) {
    return $prompt . "\n\nAlways end responses with a friendly emoji.";
}, 10, 2 );

例: 条件付きでチャットボットを非表示

add_filter( 'raplsaich_chatbot_enabled', function( $enabled ) {
    // Hide on checkout page
    if ( is_page( 'checkout' ) ) {
        return false;
    }
    return $enabled;
} );

REST API エンドポイント

プラグインは rapls-ai-chatbot/v1 名前空間で REST API エンドポイントを登録します:

セッション認証: セッション ID は X-RAPLSAICH-Session HTTP ヘッダーで渡してください (推奨)。ヘッダーが存在する場合、リクエストボディの session_id は無視されます (APM/WAF のボディログ漏洩を防止)。GET リクエストではクエリ文字列パラメーター (?session_id=...) はサーバーアクセスログでのセッション漏洩を防ぐため受け付けません。

Free:

• GET /rapls-ai-chatbot/v1/session — チャットセッションの取得または作成
• POST /rapls-ai-chatbot/v1/chat — メッセージ送信と AI 応答の受信
• GET /rapls-ai-chatbot/v1/history/{session_id} — 会話履歴の取得
• POST /rapls-ai-chatbot/v1/feedback — 応答の評価 (高評価/低評価)
• POST /rapls-ai-chatbot/v1/regenerate — AI 応答の再生成
• GET /rapls-ai-chatbot/v1/message-limit — メッセージ制限の確認
• POST /rapls-ai-chatbot/v1/lead — リードフォーム送信
• GET /rapls-ai-chatbot/v1/lead-config — リードフォーム設定

Pro アドオンは分析、シナリオ、LINE などの追加エンドポイントを登録します。詳細は Pro のドキュメントを参照してください。

設定アーキテクチャ

拡張設定は raplsaich_settings の extensions キーに保存されます。後方互換性のため、レガシーの pro_features キーはフォールバックとして読み取られますが、すべての新しい設定は extensions に書き込まれます。

データベーステーブル

プラグインは以下のデータベーステーブルを作成します:

• {prefix}_aichat_conversations — チャットセッション
• {prefix}_aichat_messages — トークン追跡付き個別メッセージ
• {prefix}_aichat_index — サイト学習コンテンツインデックス
• {prefix}_aichat_knowledge — カスタムナレッジベースエントリ
• {prefix}_aichat_leads — リード獲得データ

アンインストール

「アンインストール時にデータを削除」を有効にしてアンインストールすると、プラグインはすべてのデータベーステーブル、オプション、トランジェントを削除します。この設定がない場合、データは再インストール用に保持されます。

開発

リリース ZIP は CI でパッケージの正確性が検証されています。問題はサポートフォーラムで報告してください。

クレジット

• Chart.js (MIT License) — 利用統計チャート