パートナープログラム
複数企業の管理、共有クレジットウォレット、一括プラン
詳細を見るサンプル · チャット一覧を取得
curl https://wisebird.cloud/external/v1/conversations?status=open&limit=20 \ -H "Authorization: Bearer wb_live_xxxxxxxxxxxxxxxx"
すべてのendpointは1つのhostの下にあり、JSONを返します。schema付きの完全なドキュメントはアプリ内にあります
| グループ | Methodとpath | 用途 |
|---|---|---|
| Conversations | GET /external/v1/conversations | チャット一覧。ステータス、チャネル、タグ、担当者で絞り込み |
| GET /external/v1/conversations/{id} | メッセージと顧客カード付きの個別チャット詳細 | |
| GET /external/v1/conversations/search | メッセージ、顧客名、電話番号からチャットを検索 | |
| POST /external/v1/conversations/{id}/messages | お客様にメッセージを送信。text、image、video、audio、fileに対応 | |
| Tags | GET, POST /external/v1/tags | タグの読み取りと作成、チャットへのタグの付与と解除 |
| Members | GET /external/v1/members | メンバーとロールの一覧。チャットの割り当てに使用 |
| Webhooks | GET, POST /external/v1/webhooks | endpointを登録し、eventを選んでtest eventを送信 |
サンプル · Idempotency-Key付きでメッセージを送信
curl -X POST https://wisebird.cloud/external/v1/conversations/cnv_123/messages \
-H "Authorization: Bearer wb_live_xxxxxxxxxxxxxxxx" \
-H "Idempotency-Key: 7f3c2a1e-order-4512-confirm" \
-H "Content-Type: application/json" \
-d '{"type":"text","text":"ご注文 #4512 を承りました。2営業日以内に発送します。"}'
# 添付ファイルの送信: type を image | video | audio | file に変更し、ファイルの url を渡します
# -d '{"type":"image","url":"https://example.com/receipt.png","caption":"領収書です"}'
endpointを登録し、eventを選んでtest eventを送るだけ。実際のチャットを待たずにすぐテストできます
| Event | v1 | v2 | 発生タイミング |
|---|---|---|---|
| message.received | あり | あり | お客様がどのチャネルからメッセージを送っても |
| message.sent | あり | あり | AIまたはチームがメッセージを送信すると、payloadで送信者を示します |
| conversation.handoff | あり | あり | AIが理由と要約を添えてチャットをチームに引き継ぎ |
| conversation.assigned | なし | あり | チャットがメンバーに割り当てられた |
| conversation.tagged | なし | あり | チャットにタグが追加または解除された |
| lead.created | なし | あり | リードフォームまたはAIが新しいリードをパイプラインに作成 |
| order.created | なし | あり | チャットからの売上や注文を記録 |
v2ではpayloadにeventとフィールドが追加されています。v1も引き続き使えますが、新しいエンドポイントにはv2を推奨します
サンプル · あなたのendpointが受け取るpayloadと署名header
POST /your-endpoint HTTP/1.1
Content-Type: application/json
X-Wisebird-Event: conversation.handoff
X-Wisebird-Signature: t=1760600000,v1=5f1c…e2a9
X-Wisebird-Delivery: evt_01HZX…
{"id":"evt_01HZX…","version":"v2","type":"conversation.handoff",
"business_id":"biz_42","created_at":"2026-10-16T09:30:00+07:00",
"data":{"conversation_id":"cnv_123","channel":"line","reason":"customer_requested_human",
"summary":"施術前に炎症性ニキビについて質問あり。医師の診察を希望"}}
# 署名の検証: HMAC-SHA256(secret, t + "." + raw_body) その後 v1 と constant-time で比較します
# t が現在時刻から許容範囲以上ずれていれば拒否し、リプレイを防ぎます
サンプル · partner APIで管理対象の企業を指定
curl https://wisebird.cloud/external/v1/conversations?status=open \ -H "Authorization: Bearer wb_partner_xxxxxxxxxxxxxxxx" \ -H "X-Wisebird-Business: biz_42"
アプリのビジネス設定ページで作成します。キーは作成時に一度だけ全体が表示されるので、すぐコピーして保管してください。紛失した場合は無効化して再作成します
できません。keyはHTTPS経由でAuthorization headerにBearerとして送るのみです。query stringのkeyは、URLがlogに記録されやすいため拒否されます
メッセージごとに固有のIdempotency-Key headerを付けます。同じkeyで再送しても同じ結果が返り、お客様に重複送信されません。retryに適しています
すべてのeventにはendpointのsecretから計算した署名がheaderに含まれます。生のbodyから計算して処理前に比較してください。test eventを送ってテストできます
あります。アプリの開発者ページのTry itモードはテスト用ビジネスにリクエストを送り、実際のお客様には届きません。本物の署名付きでWebhook test eventも送れます
外部のAIツールが、チャット検索、顧客カード取得、メッセージ送信などWisebirdの機能を同じAPIキーの権限下でtoolとして呼び出せる
登録してチャネルを接続し、sandboxで最初のリクエストを送ってみましょう