APIの基本
現時点で使えるものを、正直にご説明します — まだ小さなAPIであり、フル機能のプラットフォームAPIではありません。
チャット
POST /api/chat は、ボットの公開キー、訪問者ID、メッセージ、これまでの会話を受け取り、回答をserver-sent eventsでストリーミング返却します。各イベントはテキストの差分を運び、最後のイベントに出典・確信度スコア・メッセージIDが含まれます。ウィジェットが使っているのと同じエンドポイントで、シークレットは不要です — 公開キーは自分のボットにしか届かないため、ブラウザに置いても安全です。
リード獲得
POST /api/leads は、訪問者のメールアドレスを進行中の会話に記録し、あなたに通知します。会話はこちら側で訪問者IDから解決されます。渡すべき会話IDが存在しないのは意図的で、他人の会話にリードを紐付けることを誰にもさせないためです。
レート制限
訪問者1人あたり5分間に20メッセージ、およびボットごとの1日トークン予算があります。どちらも、訪問者が対処できないエラーではなく、平易なメッセージを返します。プランに含まれる会話数を超えてもサービスは止まりません — 超過分は課金されるだけで、遮断はされません。
まだ提供していないもの
ダッシュボードの外からボットを作成したり、会話を読み取ったり、回答を編集したりする認証付き管理APIはまだなく、アウトバウンドイベントのWebhookもありません。どちらも計画中です。実装されるまで、どのプランにもAPIアクセスは記載しません — 存在しないものを料金表の一行で示唆するより、ここで正直に書くことを選びました。