เริ่มอย่างรวดเร็ว: ข้อความแรกบน WhatsApp

เตรียม API key ให้พร้อม

ขณะนี้ UnifyPort เปิดให้บริการเฉพาะลูกค้าที่ได้รับคัดเลือก — ติดต่อทีมงานเพื่อขอสิทธิ์เข้าถึงพื้นที่ทำงาน ทุกคำขอด้านล่างยืนยันตัวตนด้วยส่วนหัว X-Api-Key

curl https://api.unifyport.ai/v1/workspace \
  -H "X-Api-Key: <YOUR_API_KEY>"

ลงทะเบียนจุดเชื่อมต่อ webhook

ทำขั้นนี้ก่อน: ความคืบหน้าการให้สิทธิ์และข้อความขาเข้าทุกฉบับมาถึงในรูปอีเวนต์ webhook เท่านั้น และอีเวนต์ที่พลาดไปจะไม่ถูกส่งซ้ำ การ subscribe ด้วย ["*"] จะได้รับแคตตาล็อก event มาตรฐานครบชุด

curl -X POST https://api.unifyport.ai/v1/webhook-endpoints \
  -H "X-Api-Key: <YOUR_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
  "url": "https://example.com/webhook",
  "subscribed_events": ["*"],
  "signing_secret": "<WEBHOOK_SIGNING_SECRET>"
}'

ตรวจสอบภูมิภาคที่ใช้งานได้

บัญชีถูกผูกกับภูมิภาคหนึ่ง และไม่ใช่ผู้ให้บริการทุกรายจะให้บริการในทุกภูมิภาค ให้เรียกดูรายการภูมิภาคของผู้ให้บริการก่อน แล้วเลือกภูมิภาคที่ allocatable: true — การสร้างบัญชีในภูมิภาคที่จัดสรรไม่ได้จะล้มเหลวด้วย 409 no_allocatable_server

curl https://api.unifyport.ai/v1/providers/whatsapp/regions \
  -H "X-Api-Key: <YOUR_API_KEY>"

สร้างบัญชี WhatsApp

หนึ่งบัญชีคืออุปกรณ์เสมือนหนึ่งเครื่อง ใช้ภูมิภาคที่ allocatable ตามขั้นก่อนหน้า สำหรับการจับคู่ WhatsApp ด้วยหมายเลขโทรศัพท์ ให้ใช้ auth_mode=code และตั้ง provider_data.phone เป็นหมายเลข E.164 ตัวเลขล้วน — ระบบจะบันทึกไว้ในบัญชีและใช้ซ้ำในขั้นถัดไป

curl -X POST https://api.unifyport.ai/v1/accounts \
  -H "X-Api-Key: <YOUR_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "WhatsApp Support",
  "provider": "whatsapp",
  "region": "global",
  "status": "active",
  "auth_mode": "code",
  "provider_data": { "phone": "8613800138000" }
}'

จับคู่โทรศัพท์

เริ่มโฟลว์ด้วย body ว่าง — ระบบจะใช้หมายเลขที่บันทึกไว้ และการตอบกลับจะมี verify_code 8 ตัวอักษรอยู่ใน auth_payload บนโทรศัพท์ให้เปิด WhatsApp → อุปกรณ์ที่เชื่อมต่อ → เชื่อมต่อด้วยหมายเลขโทรศัพท์ แล้วกรอกรหัสภายในประมาณ 3 นาที เมื่อสำเร็จ webhook ของคุณจะได้รับ account.auth.succeeded ตามด้วย account.started รันไทม์เริ่มอัตโนมัติ ไม่ต้องเรียก /runtime/start

curl -X POST https://api.unifyport.ai/v1/accounts/<ACCOUNT_ID>/auth/start \
  -H "X-Api-Key: <YOUR_API_KEY>"

ส่งข้อความแรกของคุณ

ส่ง JSON ที่ปรับเป็นมาตรฐาน — UnifyPort จะแปลให้เข้ากับผู้ให้บริการเอง สำหรับ WhatsApp id ของผู้รับคือ <E.164>@s.whatsapp.net

curl -X POST https://api.unifyport.ai/v1/messages \
  -H "X-Api-Key: <YOUR_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
  "account_id": "<ACCOUNT_ID>",
  "to": { "id": "8613912345678@s.whatsapp.net", "type": "user" },
  "message": { "type": "text", "text": "Hello from UnifyPort" }
}'

รับอีเวนต์แรกของคุณ

ตอบกลับจากโทรศัพท์อีกเครื่อง: อีเวนต์ message.received จะมาถึงจุดเชื่อมต่อ webhook ของคุณภายในไม่กี่วินาที จากจุดนี้ค่อยตรวจสอบลายเซ็นของการส่งและจัดการแคตตาล็อก event มาตรฐานต่อ