AI機能 — v2.0
LeadHub v2.0では、CRMを受動的なリードストアからアクティブなリードエンジンへと変える3つの主力AI機能が導入されています：
| 機能 | 説明 |
|---|---|
| LeadBot | ウェブサイトに埋め込めるAIチャットボット — 訪問者を評価し、リードを獲得し、24時間365日ミーティングを予約 |
| AI SDR | メール、SMS、WhatsAppでスマートなケイデンスに従ってリードをフォローアップする自律型エージェント |
| ビジュアルフロービルダー | オートメーションを視覚的に構築するドラッグ&ドロップキャンバス — 同じエンジン、美しいインターフェース |
これら3つの機能はすべて共有ホスティングで動作します（Redis不要、Supervisor不要、ビルドステップ不要）。OpenAIキーが設定されていない場合もグレースフルに機能低下します。
AIのセットアップ
OpenAI APIキーの追加
- 設定 → AI & 連携 に移動します。
- OpenAI APIキー（
sk-で始まる）を入力します。 - 保存して確認 をクリック — システムがテストリクエストを送信してキーが有効であることを確認します。
各テナントは自分のキーを管理します。スーパーアドミンのキーはテナントと共有されることはありません。
キーが設定されていない場合、LeadBotは訪問者に「現在利用できません」というメッセージを表示し、AI SDRはシンプルなテンプレートシーケンスにフォールバックします。機能が壊れることはなく、単にAIなしで動作します。
AI支出上限
API費用の暴走を防ぐために、テナントごとに支出制限を設定できます：
- 設定 → AI & 連携 → 支出制限 に移動します。
- 日次上限 および/または 月次上限（USD単位）を設定します。
- 上限に達すると、AI機能はその期間の残りの間一時停止し、カウンターがリセットされると自動的に再開します。
使用状況台帳
設定 → AI & 連携 → 使用状況 には、すべてのAIリクエストの完全なログが表示されます：
| 列 | 説明 |
|---|---|
| 日付 | リクエストが行われた日時 |
| 機能 | LeadBot、AI SDR、またはその他 |
| モデル | 使用されたOpenAIモデル |
| トークン入力/出力 | プロンプトとコンプリーションのトークン数 |
| コスト（USD） | そのリクエストの計算コスト |
| 累計合計 | 今月の累積支出 |
これにより、OpenAIの請求書が届く前にAIコストを完全に把握できます。
要件
- OpenAI APIキー（AIレスポンスに必要；なくてもグレースフルにフォールバック）
- PHP 8.4+（LeadHubで既に必須）
- Cronジョブ — キューに使用される15分ごとのcronがAI SDRのティックも駆動します
- Redis、Supervisor、npm/Node.jsは不要
スーパーアドミン：テナントごとのAIコントロール
スーパーアドミンは任意のテナントのAI設定を表示・上書きできます：
- スーパーアドミン → テナント → [テナント] → 編集。
- AI設定 タブには、テナントの現在の支出、上限、キーステータスが表示されます。
- ここからテナントレベルで月次上限を設定できます — 下位プランでのリソース使用量の制限に便利です。