เอกสารสำหรับนักพัฒนา

One Port, Every Channel.

เชื่อมต่อทุกเส้นทางข้อความผ่าน API เดียว พร้อมรับ inbound event ผ่าน Webhook มาตรฐาน

เริ่มต้นใช้งาน

บทนำ

UnifyPort คือ REST API หนึ่งเดียวบวกสตรีมอีเวนต์ webhook มาตรฐานหนึ่งชุด สำหรับ Telegram, WhatsApp, LINE, X (Twitter), Zalo และ TikTok ส่งด้วย POST /v1/messages แล้วรับทุกอย่างเป็นอีเวนต์ที่ปรับเป็นมาตรฐาน — ไม่ต้องใช้ SDK เฉพาะของแต่ละ provider และเลือกใช้ SDK ทางการของ UnifyPort สำหรับ Node.js หรือ PHP ได้

ภาพรวม

พื้นที่ทำงาน

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

บัญชี

การล็อกอินหนึ่งช่องทาง = อุปกรณ์เสมือนหนึ่งเครื่อง สร้างผ่าน API ให้สิทธิ์ด้วยโฟลว์ที่ผู้ให้บริการรองรับ (QR, รหัสยืนยัน หรือนำเข้า session) จากนั้นใช้ส่งและรับข้อความผ่านบัญชีนั้น

รันไทม์

กระบวนการเชื่อมต่อจริงที่อยู่เบื้องหลังแต่ละบัญชี จะเริ่มอัตโนมัติหลังการให้สิทธิ์สำเร็จ สถานะของมันแสดงผ่าน runtime_status ดูสเตตแมชชีนฉบับเต็มได้ที่ วงจรชีวิตของบัญชี

Webhook

บันทึกเดียวของทราฟฟิกขาเข้า UnifyPort ไม่เก็บประวัติข้อความ และอีเวนต์ที่พลาดไปจะไม่ถูกส่งซ้ำ — ลงทะเบียนจุดเชื่อมต่อ webhook ก่อน แล้วบันทึกสิ่งที่ต้องใช้ทันทีที่อีเวนต์มาถึง

ตรวจสอบ API key ของคุณ

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

หมายเหตุ

  • Base URL: https://api.unifyport.ai ทุกจุดเชื่อมต่อ /v1 ยืนยันตัวตนด้วยส่วนหัว X-Api-Key
  • ขณะนี้ UnifyPort เปิดให้บริการเฉพาะลูกค้าที่ได้รับคัดเลือก ติดต่อทีมงานเพื่อขอสิทธิ์เข้าถึงพื้นที่ทำงานและรับ API key ชุดแรกของคุณ
  • Every response (success and error) carries a top-level request_id, also returned as the X-Request-Id response header — quote it when reporting issues. Send your own X-Request-Id request header and it is echoed back as client_request_id for client-side reconciliation.

ขั้นถัดไป

เริ่มอย่างรวดเร็ว

จากพื้นที่ทำงานว่างเปล่าไปสู่ข้อความ WhatsApp แรกและอีเวนต์ขาเข้าครั้งแรกของคุณ

ความสามารถของผู้ให้บริการ

แต่ละช่องทางรองรับชนิดข้อความ แอ็กชัน และอีเวนต์ใดบ้างจริง ๆ ในปัจจุบัน

การรับอีเวนต์

ส่วนหัวของการส่ง การตรวจสอบลายเซ็น HMAC การ retry และการรับประกันลำดับ

อ้างอิงรหัสข้อผิดพลาด

ซองข้อความข้อผิดพลาดและรหัสข้อผิดพลาดแบบ machine-readable ทั้งหมด จัดกลุ่มตามสถานะ HTTP