โปรแกรมพาร์ตเนอร์
บริหารหลายธุรกิจ กระเป๋าเครดิตรวม และแพ็กเกจกลาง
ดูรายละเอียดนักพัฒนา
REST API, Webhook และ MCP สำหรับต่อกับระบบของคุณ
Wisebird API ของนักพัฒนาคือ REST API และ Webhook สำหรับดึงแชท ค้นหา ส่งข้อความ จัดการแท็กและสมาชิกของธุรกิจ ด้วย API key ต่อธุรกิจและ Bearer auth รองรับ Idempotency-Key, Webhook ที่มีลายเซ็นพร้อม test event, sandbox แบบ Try it, MCP และ partner API สำหรับดูแลหลายธุรกิจ
ตัวอย่าง · ดึงรายการแชท
curl https://wisebird.cloud/external/v1/conversations?status=open&limit=20 \ -H "Authorization: Bearer wb_live_xxxxxxxxxxxxxxxx"
ทุก endpoint อยู่ใต้ 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 เพิ่ม event และฟิลด์ใน payload ส่วน v1 ยังใช้ได้ endpoint ใหม่แนะนำ v2
ตัวอย่าง · payload และ header ลายเซ็นที่ endpoint ของคุณจะได้รับ
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 ห่างจากเวลาปัจจุบันเกินช่วงที่คุณกำหนด เพื่อกัน replay
ตัวอย่าง · partner API ระบุธุรกิจที่ต้องการจัดการ
curl https://wisebird.cloud/external/v1/conversations?status=open \ -H "Authorization: Bearer wb_partner_xxxxxxxxxxxxxxxx" \ -H "X-Wisebird-Business: biz_42"
บริหารหลายธุรกิจ กระเป๋าเครดิตรวม และแพ็กเกจกลาง
ดูรายละเอียดข้อมูลอยู่ในไทย บทบาทสิทธิ์ และ activity log
ดูรายละเอียดกฎแจ้งเตือนไป LINE group, Telegram, Discord หรือ webhook ของคุณ
ดูการแจ้งเตือนสร้างในหน้าตั้งค่าของธุรกิจในแอป key แสดงเต็มครั้งเดียวตอนสร้าง ให้คัดลอกเก็บทันที ทำหายให้ยกเลิกแล้วสร้างใหม่
ไม่ได้ ส่ง key ใน header Authorization แบบ Bearer ผ่าน HTTPS เท่านั้น key ใน query string จะถูกปฏิเสธ เพราะ URL มักถูกบันทึกใน log
ใส่ header Idempotency-Key เป็นค่าเฉพาะต่อข้อความ ส่งซ้ำด้วย key เดิมจะได้ผลลัพธ์เดิมและไม่ส่งซ้ำถึงลูกค้า เหมาะกับการ retry
ทุก event มีลายเซ็นใน header คำนวณจาก secret ของ endpoint ให้คำนวณจาก body ดิบแล้วเทียบก่อนประมวลผล กดส่ง test event เพื่อทดสอบได้
มี โหมด Try it ในหน้านักพัฒนาของแอปยิงคำขอไปธุรกิจทดสอบ ไม่ส่งถึงลูกค้าจริง และส่ง Webhook test event ด้วยลายเซ็นจริงได้
ให้เครื่องมือ AI ภายนอกเรียกความสามารถของ Wisebird เป็น tool เช่น ค้นแชท ดึงการ์ดลูกค้า ส่งข้อความ ภายใต้สิทธิ์ของ API key เดียวกัน
สมัคร เชื่อมช่องทาง แล้วลองยิงคำขอแรกใน sandbox