คู่มือทั้งหมด

บัญชีและการเชื่อมต่อ

เชื่อมต่อระบบภายนอกหรือผู้ช่วย

สร้างคีย์ Pro หรือ Agency ที่จำกัดขอบเขต เผยแพร่เนื้อหาใหม่ หรือเชื่อมต่อผู้ช่วย

ก่อนเริ่มต้น

Webhook รับการแจ้งข้อความขาเข้าจากบริการ WhatsApp การตั้งค่าบนเซิร์ฟเวอร์เป็นหน้าที่ผู้ดูแลการเชื่อมต่อ ผู้ใช้แผงควบคุมไม่ต้องเปลี่ยนค่าเซิร์ฟเวอร์ MCP ให้ผู้ช่วยเรียกใช้เครื่องมือของบัญชี

ขั้นตอนที่ต้องทำ

  1. สำหรับข้อความขาเข้า เปิด การตั้งค่า แล้วค้นหา Webhook URL
  2. เลือก คัดลอก เพื่อรับที่อยู่ที่ตรงกับระบบติดตั้งของบัญชีคุณ
  3. ขอให้ผู้ดูแลตั้งค่าเหตุการณ์ขาเข้าสำหรับอุปกรณ์ที่ต้องการด้วยที่อยู่นั้น
  4. นัดส่งข้อความทดสอบขาเข้าจากหมายเลขของคุณเมื่อผู้ดูแลยืนยันว่าพร้อม
  5. ตรวจผลที่คาดไว้ เช่น คำตอบอัตโนมัติที่ตรง หรือข้อความกลุ่มที่เพิ่งบันทึกเมื่อเปิด บันทึก
  6. สำหรับการเชื่อมต่อผู้ช่วย เข้าสู่ระบบผ่านหน้าอนุญาตที่แอป MCP เปิด
  7. ตรวจชื่อแอปและบัญชีก่อนอนุมัติการเข้าถึง
  8. สำหรับการเชื่อมต่อเพื่อส่งออก ให้เปิดการตั้งค่า → การเชื่อมต่อภายนอก สร้างคีย์พร้อมชื่อสำหรับบัญชีที่เชื่อมต่อหนึ่งบัญชีและกลุ่มที่เลือกอย่างชัดเจน บันทึกคีย์ทันทีเพราะระบบจะแสดงเพียงครั้งเดียว แล้วคัดลอก URL ฐานของ API
  9. ตัวอย่าง: ตั้งค่า Abacus.AI ให้สร้างเนื้อหาใหม่ในแต่ละเวลาเผยแพร่ทั้งแปดครั้งต่อวันตามเขตเวลา America/Sao_Paulo ส่งคำขอเผยแพร่แต่ละครั้งไปยังสามกลุ่มที่อนุญาตด้วย Idempotency-Key ใหม่ ใช้คีย์เดิมซ้ำเฉพาะเมื่อลองคำขอเดิมที่เหมือนกันทุกประการอีกครั้ง
  10. ไม่ต้องระบุ scheduled_at หากต้องการเข้าคิวทันที หรือใช้เวลาประทับแบบสัมบูรณ์ที่มี -03:00 หรือ Z (UTC) ล่วงหน้าได้สูงสุด 30 วัน ตัวประมวลผลตรวจสอบทุกนาที โดย scheduled_at คือเวลาแรกสุดที่เริ่มประมวลผลได้ ไม่รับประกันว่าจะส่งถึงตรงวินาทีที่กำหนด
  11. ตรวจสอบสถานะงานและผลลัพธ์รายกลุ่มก่อนลองอีกครั้ง ยกเลิกได้เฉพาะการส่งที่ยังไม่ได้ส่งออก เพิกถอนคีย์ที่รั่วไหลในหน้าการตั้งค่า แล้วสร้างและบันทึกคีย์ใหม่ งานเดิมจะไม่กลับมาทำงานต่อด้วยคีย์ใหม่

ตัวอย่างการใช้งาน

คำขอตัวอย่างมีค่าที่ต้องแทนที่ โปรดเปลี่ยน ID และเลือกวันที่ในอนาคตก่อนส่ง คำขอเหล่านี้จะเผยแพร่ข้อความจริง curl '<API_BASE_URL>/v1/groups' -H 'Authorization: Bearer <ZAPBOT_API_KEY>' curl -X POST '<API_BASE_URL>/v1/jobs' -H 'Authorization: Bearer <ZAPBOT_API_KEY>' -H 'Idempotency-Key: publication-2026-10-16-0900' -H 'Content-Type: application/json' --data '{"type":"text","group_ids":["<GROUP_JID_1>","<GROUP_JID_2>","<GROUP_JID_3>"],"text":"Updated publication","scheduled_at":"2026-10-16T09:00:00-03:00"}' curl -X POST '<API_BASE_URL>/v1/jobs' -H 'Authorization: Bearer <ZAPBOT_API_KEY>' -H 'Idempotency-Key: publication-2026-10-16-1200' -F 'payload={"type":"image","group_ids":["<GROUP_JID_1>","<GROUP_JID_2>","<GROUP_JID_3>"],"caption":"Updated caption"}' -F 'image=@publication.png;type=image/png' curl '<API_BASE_URL>/v1/jobs/<JOB_ID>' -H 'Authorization: Bearer <ZAPBOT_API_KEY>' curl -X DELETE '<API_BASE_URL>/v1/jobs/<JOB_ID>' -H 'Authorization: Bearer <ZAPBOT_API_KEY>'

วิธีตรวจสอบว่าได้ผล

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

สิ่งที่ควรทราบ

  • ผู้ช่วยอ่านรายการที่เปิดให้เข้าถึงและส่งข้อความเมื่อร้องขอได้ อ่านคู่มือเครื่องมือผู้ช่วยก่อนขอส่ง
  • ใช้แผงควบคุมสำหรับการแก้ไขที่ไม่มีผ่าน MCP
  • การเข้าถึง API รวมอยู่ในแผน Pro และ Agency แบบรายเดือนหรือรายปี ส่วน Starter ต้องอัปเกรด คีย์อนุญาตเฉพาะบัญชีและกลุ่มที่เลือกไว้ การเปลี่ยนบัญชี WhatsApp จะบล็อกการส่ง ห้ามเปิดเผยข้อมูลรับรองของเซิร์ฟเวอร์
  • ข้อความรองรับ 4,096 อักขระ และคำบรรยายรองรับ 1,024 อักขระ อัปโหลด JPEG, PNG หรือ WebP ขนาดไม่เกิน 5 MiB ผ่านฟิลด์ multipart ชื่อ payload และ image ไม่รองรับ URL รูปภาพระยะไกล
  • งานใหม่จะคืนค่า HTTP 202 การลองคำขอเดิมซ้ำด้วย Idempotency-Key เดิมจะคืนงานเดิมพร้อม HTTP 200 หากใช้คีย์เดิมแต่เนื้อหาต่างกันจะคืนค่า 409 การหมดเวลาหลังเริ่มส่งอาจมีผลลัพธ์ที่ยังไม่ยืนยัน อย่าส่งซ้ำอัตโนมัติด้วยคีย์อื่น

ปัญหาที่พบบ่อย

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

ขอความช่วยเหลือเพิ่มเติม

แจ้งฟีเจอร์และข้อผิดพลาดที่แสดงแก่ผู้ดูแล อย่าส่งข้อมูลรับรองเซิร์ฟเวอร์ในบทสนทนากับผู้ช่วย

เปิดฟีเจอร์นี้

คู่มือที่เกี่ยวข้อง

บัญชีและการเชื่อมต่อ

บันทึกค่าการส่งและรูปลักษณ์

ปรับจังหวะแคมเปญ การจำลองการพิมพ์ และรูปลักษณ์

อ่านคู่มือบัญชีและการเชื่อมต่อ

ขอผู้ช่วยตรวจสอบบัญชี

ขอผู้ช่วยที่เชื่อมต่อให้อ่านรายการหรือส่งข้อความที่ระบุ

อ่านคู่มือ