開発者向け
APIドキュメント
Chat Sakuの機能をあなたのシステムに統合するためのAPIリファレンスと導入ガイドです。
導入方法
スクリプトタグ埋め込み
HTMLに1行追加するだけでチャットボットを設置。もっとも簡単な方法です。
<script src="https://widget.chat-saku.app/widget.js" data-api-key="YOUR_API_KEY" data-merchant-id="YOUR_MERCHANT_ID" async> </script>
REST API
外部システムからチャット機能を利用できます。LINE連携やカスタムフロントエンドに最適。
curl -X POST https://api.chat-saku.app/api/v1/chat \
-H "X-API-Key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"message": "営業時間を教えてください",
"conversation_id": "optional-id"
}'WordPress プラグイン
WordPressの管理画面からインストール・設定が可能。コードの編集は不要です。
// WordPress管理画面から // 1. プラグイン → 新規追加 // 2. "Chat Saku" を検索 // 3. インストール → 有効化 // 4. 設定画面でAPIキーを入力
認証方式
API Key 認証
ウィジェットやサーバーサイドからのチャットAPI呼び出しに使用します。ダッシュボードの設定画面でAPIキーを取得できます。
X-API-Key: sk_live_xxxxxxxxxxxx
Firebase Auth
ダッシュボードやマーチャント管理APIへのアクセスに使用します。Firebase Authトークンを Authorization ヘッダーに設定します。
Authorization: Bearer eyJhbGci...
主要エンドポイント
| メソッド | エンドポイント | 説明 | 認証 |
|---|---|---|---|
| POST | /api/v1/chat | チャットメッセージを送信し、AI応答を取得します。 | API Key |
| GET | /api/v1/conversations | 会話履歴の一覧を取得します。 | Firebase Auth |
| GET | /api/v1/conversations/:id | 特定の会話の詳細とメッセージを取得します。 | Firebase Auth |
| GET | /api/v1/knowledge | ナレッジベースのアイテム一覧を取得します。 | Firebase Auth |
| POST | /api/v1/knowledge | 新しいナレッジアイテムを作成します。 | Firebase Auth |
| GET | /api/v1/analytics/overview | チャットボットの分析データを取得します。 | Firebase Auth |
レート制限
プランに応じた月間会話数上限が適用されます。API呼び出しは1秒あたり10リクエストまで。
Webhook
新しい会話やリード情報をリアルタイムで受信。エンタープライズプランで利用可能。
セキュリティ
すべての通信はTLS 1.3で暗号化。APIキーはSHA-256でハッシュ化して保管されます。