ดึงลิงก์เชิญกลุ่ม WhatsApp ผ่าน API: การอ่านไม่ใช่การรีเซ็ต

หากต้องการดึงลิงก์เชิญกลุ่ม WhatsApp ผ่าน UnifyPort ให้เรียก GET /v1/accounts/{account_id}/groups/invite-code พร้อม query parameter group_id ผลลัพธ์มี data.invite_url และ data.invite_code การอ่านลิงก์ไม่ใช่การรีเซ็ตลิงก์ WhatsApp มีคำสั่งในแอปให้ผู้ดูแลปิดใช้งานลิงก์เดิมและสร้างลิงก์ใหม่ แต่เอกสารสาธารณะของ UnifyPort ระบุเฉพาะการดึงลิงก์ ไม่ใช่การรีเซ็ต

ประเด็นสำคัญ

• เลือกบัญชีรับส่งข้อความและกลุ่มเป้าหมายคู่กัน รหัสเชิญไม่ใช่ ID กลุ่ม
• เรียก API จากแบ็กเอนด์ และแสดงลิงก์เฉพาะผู้ปฏิบัติงานที่มีสิทธิ์
• แยกการดึง การแชร์ การอนุมัติเข้ากลุ่ม และการรีเซ็ตเป็นคนละการทำงาน
• หลังรีเซ็ตใน WhatsApp ให้ดึงลิงก์อีกครั้งและเปลี่ยนสำเนาที่แอปของคุณควบคุมได้

Endpoint นี้ทำอะไรจริง ๆ

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

เอกสารดึงลิงก์เชิญของ UnifyPort กำหนดข้อมูลดังนี้:

ข้อมูลเข้า/ออก	ความหมาย
account_id ใน path	บัญชีรับส่งข้อความที่เชื่อมต่อและใช้ดำเนินการ
group_id ใน query	ตัวระบุกลุ่มของแพลตฟอร์ม
data.invite_url	URL เชิญที่ส่งกลับ
data.invite_code	รหัสเชิญที่ส่งกลับ ไม่ใช่ ID การสนทนา

ตารางรองรับการทำงาน ปัจจุบันระบุความสามารถนี้สำหรับ whatsapp ไม่รวม LINE, Telegram, Zalo หรือผู้ให้บริการแยกอย่าง whatsapp-protocol หากหน้าจอทีมงานรวม LINE และ WhatsApp ไว้ด้วยกัน อย่าเปิดปุ่มดึงลิงก์นี้ให้ทุกช่องทางโดยอัตโนมัติ

เอกสาร endpoint เตือนว่าผู้ให้บริการส่วนใหญ่ต้องใช้สิทธิ์ผู้ดูแลกลุ่ม สำหรับขั้นตอนนี้ ให้ใช้บัญชี WhatsApp ของผู้ดูแลที่ได้รับอนุญาต และตรวจสอบสิทธิ์ปัจจุบัน การมีสิทธิ์ API ในเวิร์กสเปซไม่ได้ให้สิทธิ์ดูแลกลุ่มโดยอัตโนมัติ นี่คือ อินเทอร์เฟซที่ไม่เป็นทางการ สำหรับบัญชีที่เชื่อมต่อ ไม่ใช่ endpoint ของ WhatsApp Cloud API

ดึงลิงก์โดยไม่เปิดเผย API Key

เริ่มจากรายการกลุ่ม ภายใต้บัญชีที่ถูกต้อง รายการนี้รวมกลุ่มที่บัญชีเข้าร่วมแต่ยังไม่เคยใช้ส่งข้อความ อ่านข้อมูลตามการแบ่งหน้าและเก็บ id ของกลุ่มที่เลือก สำหรับกลุ่ม conversation_id เท่ากับ id อย่าเลือกเป้าหมายจากชื่อที่แสดงเพียงอย่างเดียว เพราะชื่ออาจซ้ำกันได้

ตัวอย่างต่อไปนี้เป็นคำขอประกอบคำอธิบาย ไม่ใช่ผลการทดสอบจริง กำหนดตัวแปรสภาพแวดล้อมให้เป็น API Key ที่เก็บในแบ็กเอนด์, ID บัญชีที่เลือก และ ID กลุ่มจากรายการ:

curl --get \
  "https://api.unifyport.ai/v1/accounts/${UNIFYPORT_ACCOUNT_ID}/groups/invite-code" \
  -H "X-Api-Key: ${UNIFYPORT_API_KEY}" \
  --data-urlencode "group_id=${WHATSAPP_GROUP_ID}"

ตัวระบุอาจมีอักขระอย่าง @ จึงต้องเข้ารหัส query ให้ถูกต้อง เก็บคีย์ไว้บนเซิร์ฟเวอร์ อย่านำคำขอที่มีคีย์ไปไว้ใน JavaScript ของเบราว์เซอร์

เมื่อสำเร็จ ให้อ่าน data.invite_url และ data.invite_code อย่าสร้าง URL เชิญโดยเดาจาก ID กลุ่ม หากคำขอล้มเหลวหรือไม่มีลิงก์ตามที่คาด ให้หน้าจอแสดงข้อผิดพลาดหรือสถานะไม่พร้อมใช้งาน แทนการสร้างค่าขึ้นเอง

สำหรับการวิเคราะห์ปัญหา ให้บันทึก HTTP status, error code และ request_id ของเซิร์ฟเวอร์ คู่มือการติดตามคำขอ อธิบายวิธีเก็บหลักฐานโดยไม่บันทึก response body ทั้งหมด ซึ่งในกรณีนี้มีลิงก์เชิญที่ไม่ควรอยู่ในข้อมูลวิเคราะห์หรือบันทึกทั่วไปของแอป

แยกปุ่มตามเจตนาของผู้ใช้

ปุ่ม	การทำงานที่ต้องการ	ไม่ได้หมายความว่า
แสดงลิงก์ปัจจุบัน	อ่านและแสดงผล API	สร้างลิงก์ใหม่แล้ว
คัดลอกลิงก์	คัดลอก URL เพื่อแชร์อย่างได้รับอนุญาต	ผู้รับเข้ากลุ่มแล้ว
ตรวจคำขอเข้ากลุ่ม	เปิดขั้นตอนอนุมัติ	รีเซ็ตลิงก์แล้ว
รีเซ็ตลิงก์	ให้ผู้ดูแลใช้คำสั่งใน WhatsApp	มีคำขอรีเซ็ตของ UnifyPort ที่ระบุในเอกสาร

ตรวจสิทธิ์ของแอปก่อนเปิดเผยหรือคัดลอกลิงก์ หลีกเลี่ยงการใส่ลิงก์ในแดชบอร์ดสาธารณะ ภาพหน้าจอฝ่ายสนับสนุน หรือคุณสมบัติของ analytics event หากแคชผลลัพธ์ ให้ระบุว่าเป็นค่าที่ดึงไว้ก่อนหน้า ไม่ใช่รับรองว่ายังใช้ได้อยู่

การอนุมัติเป็นอีกขั้นตอนหนึ่ง หากต้องควบคุมสมาชิก ให้ใช้คิวอนุมัติคำขอเข้ากลุ่ม WhatsApp ซึ่งตรวจสอบรายการที่รอก่อนตัดสินใจ การดึงลิงก์ไม่ได้เปิดโหมดอนุมัติและไม่ได้อนุมัติผู้สมัครคนใด

อัปเดตสำเนาหลังรีเซ็ตใน WhatsApp

พิจารณา สถานการณ์สมมติ: ผู้ดูแลเห็นว่าลิงก์ถูกแชร์กว้างเกินไป จึงรีเซ็ตใน WhatsApp แต่แอปยังเก็บ URL เก่าอยู่

แนวทางที่แนะนำสำหรับแอป:

1. หยุดแจกจ่ายลิงก์ในแคชระหว่างที่ผู้ดูแลดำเนินการ
2. ดึงลิงก์อีกครั้งสำหรับบัญชีและกลุ่มเดิม
3. แสดงผลที่เพิ่งอ่านให้ผู้ปฏิบัติงานที่มีสิทธิ์ตรวจสอบ
4. เปลี่ยนลิงก์ที่แอปจัดการ รวมถึงภาพ QR ที่สร้างจาก URL เก่า
5. แจ้งผู้ดูแลช่องทางแจกจ่ายอื่นให้ตรวจสำเนาของตน

นี่เป็นคำแนะนำด้านการดำเนินงาน ไม่ใช่คุณสมบัติหมุนเวียนลิงก์แบบอะตอมมิก เอกสารสาธารณะไม่ได้กำหนดพารามิเตอร์รีเซ็ต, endpoint รีเซ็ต, ฟิลด์เวลาหมดอายุของลิงก์ หรือ webhook ยืนยันการรีเซ็ตโดยเฉพาะ อย่าเดาฟิลด์หรือถือว่าการไม่มี event แปลว่าสถานะไม่เปลี่ยน หากอ่านใหม่ไม่สำเร็จ ให้หยุดแจกจ่ายต่อหรือแสดงว่ายังยืนยันไม่ได้ อย่ากลับไปใช้แคชเก่าอย่างเงียบ ๆ

คำถามที่พบบ่อย

การเรียก invite-code สร้างลิงก์ใหม่ทุกครั้งหรือไม่?

เอกสารระบุการดึงลิงก์และรหัส ไม่ได้รับประกันว่าจะสร้างหรือเปลี่ยนลิงก์ทุกครั้งที่อ่าน

ใช้ invite_code แทน group_id ได้หรือไม่?

ไม่ได้ ใช้ ID กลุ่มของแพลตฟอร์มที่เลือกภายใต้บัญชีที่เชื่อมต่อ รหัสเชิญเป็นผลลัพธ์อีกค่าแยกกัน

รีเซ็ตผ่าน API นี้ได้หรือไม่?

เอกสารสาธารณะปัจจุบันไม่ได้ระบุการรีเซ็ต ให้ใช้คำสั่งของผู้ดูแลใน WhatsApp แล้วอ่านลิงก์ปัจจุบันอีกครั้ง

อ่านไม่สำเร็จหมายถึงกลุ่มถูกลบหรือไม่?

ไม่ใช่ ให้ตรวจ HTTP status และรายละเอียดข้อผิดพลาด get_group_invite_code_failed หมายถึงการดึงล้มเหลวที่เซิร์ฟเวอร์หรือระบบต้นทาง ไม่ใช่หลักฐานว่ากลุ่มถูกลบ

ขั้นตอนถัดไปและแหล่งข้อมูล

เริ่มทำขั้นตอนอ่านจากดึงลิงก์เชิญกลุ่ม ก่อนเปิดใช้งาน ให้ตรวจการเลือกกลุ่ม สิทธิ์ไม่เพียงพอ การเข้ารหัส query การปกปิดข้อมูลใน log และการอัปเดตสำเนาหลังผู้ดูแลรีเซ็ตอย่างได้รับอนุญาต รายการนี้เป็นข้อเสนอสำหรับตรวจรับ ไม่ใช่ผลทดสอบที่ดำเนินการแล้ว

ตรวจสอบแหล่งข้อมูลเมื่อ 2026-10-15:

• WhatsApp: สร้างและเชิญเข้ากลุ่ม
• UnifyPort: ดึงลิงก์เชิญกลุ่ม
• UnifyPort: การรองรับแต่ละแพลตฟอร์ม
• UnifyPort: ข้อมูลอ้างอิงข้อผิดพลาด