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

Cloud API เป็นการต่อยอดมาจาก API กราฟ ดังนั้นหากคุณไม่คุ้นเคยกับการจัดการการตอบกลับข้อผิดพลาดของ API กราฟ โปรดดูเอกสารประกอบเกี่ยวกับการจัดการข้อผิดพลาดของ API กราฟ

โดยทั่วไป เราขอแนะนำให้คุณสร้างตรรกะการจัดการข้อผิดพลาดตามค่า code และคุณสมบัติเพย์โหลด details ให้กับแอพของคุณ คุณสมบัติและค่าต่างๆ เหล่านี้จะระบุข้อผิดพลาดที่แฝงอยู่ได้ดีกว่า

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

การรับข้อผิดพลาด: แบบซิงโครไนซ์และแบบไม่ซิงโครไนซ์

ระบบจะส่งคืนข้อผิดพลาดของ Cloud API แบบซิงโครไนซ์ผ่านการตอบกลับจาก API กราฟ ส่งคืนแบบไม่ซิงโครไนซ์ผ่าน Webhook หรือบางครั้งก็ส่งคืนผ่านทั้งสองวิธี

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

Webhooks และรูปแบบคำสั่งการตอบกลับข้อผิดพลาด

ข้อผิดพลาดของ Cloud API อาจปรากฏขึ้นในอ็อบเจ็กต์ Webhook ต่อไปนี้

Cloud API

  • entry.changes.value.errors
  • entry.changes.value.messages.errors

API ภายในองค์กร

  • errors

รูปแบบคำสั่งของการตอบกลับข้อผิดพลาด

{
  "error": {
    "message": "<MESSAGE>",
    "type": "<TYPE>",
    "code": <CODE>,
    "error_data": {
        "messaging_product": "whatsapp",
        "details": "<DETAILS>"
    },
    "error_subcode": <ERROR_SUBCODE>
    "fbtrace_id": "<FBTRACE_ID>"
  }
}

เนื้อหาการตอบกลับข้อผิดพลาด

คุณสมบัติ ประเภทของค่า คำอธิบาย

code

จำนวนเต็ม

รหัสข้อผิดพลาด เราขอแนะนำให้คุณสร้างการจัดการข้อผิดพลาดของแอพโดยใช้รหัสข้อผิดพลาด แทนที่จะใช้รหัสย่อยหรือรหัสสถานะการตอบกลับ HTTP

details

สตริง

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

error_subcode

จำนวนเต็ม

เลิกใช้แล้ว จะไม่ส่งคืนในการตอบกลับของเวอร์ชั่น 16.0 ขึ้นไป


รหัสย่อยของ API กราฟ มีการตอบกลับเพียงบางรายการที่จะมีรหัสย่อยรวมอยู่ด้วย เราจึงขอแนะนำให้คุณสร้างตรรกะการจัดการข้อผิดพลาดโดยใช้คุณสมบัติ code และ details แทน

fbtrace_id

สตริง

ID การติดตามที่คุณสามารถรวมไว้ได้เมื่อติดต่อขอความช่วยเหลือโดยตรง ID ดังกล่าวอาจช่วยเราแก้ไขจุดบกพร่องสำหรับข้อผิดพลาดนั้นๆ ได้

message

สตริง

ชุดรหัสข้อผิดพลาดและชื่อรหัส ตัวอย่างเช่น: (#130429) Rate limit hit

messaging_product

สตริง

ผลิตภัณฑ์ส่งข้อความ รายการนี้จะเป็นสตริง whatsapp สำหรับการตอบกลับของ Cloud API เสมอ

type

สตริง

ประเภทข้อผิดพลาด

ตัวอย่างการตอบกลับ

{
  "error": {
    "message": "(#130429) Rate limit hit",
    "type": "OAuthException",
    "code": 130429,
    "error_data": {
        "messaging_product": "whatsapp", 
        "details": "Message failed to send because there were too many messages sent from this phone number in a short period of time"
    },
    "error_subcode": 2494055,
    "fbtrace_id": "Az8or2yhqkZfEZ-_4Qn_Bam"
  }
}

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

ข้อผิดพลาดในการอนุญาต

รหัส คำอธิบาย วิธีแก้ไขที่ใช้ได้ รหัสสถานะ HTTP

0

AuthException

เราไม่สามารถยืนยันตัวตนผู้ใช้แอพได้

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

401

Unauthorized

3

API Method

ปัญหาด้านความสามารถหรือสิทธิ์การอนุญาต

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

500

Internal Server Error

10

Permission Denied

ไม่ได้รับสิทธิ์การอนุญาตหรือมีการถอนสิทธิ์การอนุญาตแล้ว

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

ตรวจสอบให้แน่ใจว่าหมายเลขโทรศัพท์ที่ใช้ตั้งค่าคีย์สาธารณะของธุรกิจอยู่ในรายการที่อนุญาต

403

Forbidden

190

Access token has expired

โทเค็นการเข้าถึงของคุณหมดอายุแล้ว

ขอรับโทเค็นการเข้าถึงใหม่

401

Unauthorized

200-299

API Permission

ไม่ได้รับสิทธิ์การอนุญาตหรือมีการถอนสิทธิ์การอนุญาตแล้ว

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

403

Forbidden

ข้อผิดพลาดในการจำกัดผลลัพธ์

รหัส คำอธิบาย วิธีแก้ไขที่ใช้ได้ รหัสสถานะ HTTP

4

API Too Many Calls

แอพมีการใช้งานถึงขีดจำกัดอัตราการเรียกใช้ API แล้ว

โหลดแอพในแดชบอร์ดของแอพ และดูส่วนขีดจำกัดอัตราของแอพพลิเคชั่นเพื่อตรวจสอบยืนยันว่าแอพมีการใช้งานถึงขีดจำกัดอัตราแล้วหรือไม่ หากถึงขีดจำกัดอัตราแล้ว ให้ลองอีกครั้งในภายหลัง หรือลดความถี่หรือจำนวนการสืบค้น API ของแอพ

400

คำขอไม่ถูกต้อง

80007

Rate limit issues

บัญชี WhatsApp Business มีการใช้งานถึงขีดจำกัดอัตราแล้ว

ดูขีดจำกัดอัตราของบัญชี WhatsApp Business ให้ลองอีกครั้งในภายหลัง หรือลดความถี่หรือจำนวนการสืบค้น API ของแอพ

400

คำขอไม่ถูกต้อง

130429

ถึงขีดจำกัดอัตราแล้ว

ถึงขีดจำกัดสำหรับปริมาณข้อความของ Cloud API แล้ว

แอพมีการใช้งานถึงขีดจำกัดปริมาณข้อความของ API แล้ว โปรดดูที่ปริมาณข้อความ ให้ลองอีกครั้งในภายหลังหรือลดความถี่ที่แอพส่งข้อความ

400

คำขอไม่ถูกต้อง

131048

Spam rate limit hit

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

ตรวจสอบสถานะคุณภาพของคุณในตัวจัดการ WhatsApp และดูข้อมูลเพิ่มเติมในเอกสารประกอบเกี่ยวกับขีดจำกัดอัตราตามคุณภาพ

400

คำขอไม่ถูกต้อง

131056

(Business Account, Consumer Account) pair rate limit hit

มีข้อความที่ส่งจากหมายเลขโทรศัพท์ของผู้ส่งไปยังหมายเลขโทรศัพท์เดิมของผู้รับมากเกินไปในช่วงระยะเวลาอันสั้น

รอและลองดำเนินการอีกครั้งหากคุณตั้งใจที่จะส่งข้อความไปยังหมายเลขโทรศัพท์เดิม คุณยังคงสามารถส่งข้อความไปยังหมายเลขโทรศัพท์อื่นได้โดยไม่ต้องรอ

400

คำขอไม่ถูกต้อง

133016

Account register deregister rate limit exceeded

ลงทะเบียนหรือยกเลิกการลงทะเบียนไม่สำเร็จ เนื่องจากมีความพยายามดำเนินการดังกล่าวสำหรับหมายเลขโทรศัพท์นี้หลายครั้งเกินไปภายในระยะเวลาสั้นๆ

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

400

คำขอไม่ถูกต้อง

ข้อผิดพลาดด้านความสมบูรณ์ถูกต้อง

รหัส คำอธิบาย วิธีแก้ไขที่ใช้ได้ รหัสสถานะ HTTP

368

Temporarily blocked for policies violations

บัญชี WhatsApp Business ที่เชื่อมโยงกับแอพถูกจำกัดหรือถูกปิดใช้งานเนื่องจากละเมิดนโยบายแพลตฟอร์ม

โปรดเรียนรู้เกี่ยวกับการละเมิดนโยบายและวิธีการแก้ไขในเอกสารการบังคับใช้นโยบาย

403

Forbidden

130497

Business account is restricted from messaging users in this country.

บัญชี WhatsApp Business ถูกจำกัดการส่งข้อความถึงผู้ใช้ในบางประเทศ

โปรดดูรายละเอียดเกี่ยวกับประเทศที่ได้รับอนุญาตให้ส่งข้อความในหมวดหมู่ธุรกิจของคุณที่นโยบายการส่งข้อความของธุรกิจของ WhatsApp

403

Forbidden

131031

Account has been locked

บัญชี WhatsApp Business ที่เชื่อมโยงกับแอพถูกจำกัดหรือถูกปิดใช้งานเนื่องจากละเมิดนโยบายแพลตฟอร์ม หรือเราไม่สามารถตรวจสอบยืนยันข้อมูลที่รวมอยู่ในคำขอกับชุดข้อมูลในบัญชี WhatsApp Business ได้ (เช่น PIN สำหรับการตรวจสอบยืนยันสองขั้นตอนที่รวมอยู่ในคำขอนั้นไม่ถูกต้อง)

เรียนรู้เกี่ยวกับการละเมิดนโยบายและวิธีการแก้ไขในเอกสารการบังคับใช้นโยบาย


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

403

Forbidden

ข้อผิดพลาดอื่นๆ

รหัส คำอธิบาย วิธีแก้ไขที่ใช้ได้ รหัสสถานะ HTTP

1

API Unknown

คำขอไม่ถูกต้องหรือเซิร์ฟเวอร์อาจมีข้อผิดพลาดเกิดขึ้น

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

400

คำขอไม่ถูกต้อง

2

API Service

มีปัญหาชั่วคราวเนื่องจากระบบล่มหรือทำงานหนักเกินไป

ดูข้อมูลสถานะ API ที่หน้าสถานะแพลตฟอร์ม WhatsApp Business ก่อนลองอีกครั้ง

503

Service Unavailable

33

Parameter value is not valid

หมายเลขโทรศัพท์ธุรกิจถูกลบแล้ว

ตรวจสอบยืนยันว่าหมายเลขโทรศัพท์ธุรกิจถูกต้อง

400

คำขอไม่ถูกต้อง

100

Invalid parameter

คำขอมีพารามิเตอร์ที่ไม่รองรับหรือสะกดผิดอย่างน้อย 1 รายการ

ดูข้อมูลอ้างอิงของตำแหน่งข้อมูลเพื่อระบุว่ามีพารามิเตอร์ใดบ้างที่รองรับและพารามิเตอร์เหล่านั้นสะกดอย่างไร

ตรวจสอบให้แน่ใจว่าคีย์สาธารณะของธุรกิจเป็นคีย์สาธารณะ RSA แบบ 2,048 บิตที่ถูกต้องในรูปแบบ PEM เมื่อตั้งค่าคีย์ดังกล่าว

ตรวจสอบให้แน่ใจว่า ID หมายเลขโทรศัพท์ที่คุณใช้ลงทะเบียนกับ ID หมายเลขโทรศัพท์ที่จัดเก็บไว้ก่อนหน้านี้ตรงกัน

ตรวจสอบให้แน่ใจว่าพารามิเตอร์ของคุณอยู่ภายใต้การจำกัดความยาวสำหรับประเภทนั้น

400

คำขอไม่ถูกต้อง

130472

User's number is part of an experiment

คุณไม่ได้ส่งข้อความในฐานะส่วนหนึ่งของการทดลอง

ดูการทดลองข้อความทางการตลาด

400

คำขอไม่ถูกต้อง

131000

เกิดข้อผิดพลาด

ส่งข้อความไม่สำเร็จเนื่องจากมีข้อผิดพลาดที่ไม่รู้จัก

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

ลองอีกครั้ง หากข้อผิดพลาดยังอยู่ ให้เปิดบัตรคำร้องขอความช่วยเหลือโดยตรง

500

Internal Server Error

131005

Access denied

ไม่ได้รับสิทธิ์การอนุญาตหรือมีการถอนสิทธิ์การอนุญาตแล้ว

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

403

Forbidden

131008

Required parameter is missing

คำขอไม่มีพารามิเตอร์ที่ต้องระบุ

ดูข้อมูลอ้างอิงของตำแหน่งข้อมูลเพื่อระบุว่ามีพารามิเตอร์ใดบ้างที่ต้องระบุ

400

คำขอไม่ถูกต้อง

131009

Parameter value is not valid

มีค่าพารามิเตอร์อย่างน้อย 1 ค่าไม่ถูกต้อง

ดูข้อมูลอ้างอิงของตำแหน่งข้อมูล เพื่อระบุว่ามีค่าใดบ้างที่รองรับสำหรับแต่ละพารามิเตอร์ และดูที่หมายเลขโทรศัพท์เพื่อเรียนรู้วิธีเพิ่มหมายเลขโทรศัพท์ลงในบัญชี WhatsApp Business

400

คำขอไม่ถูกต้อง

131016

Service unavailable

บริการไม่พร้อมใช้งานชั่วคราว

ดูข้อมูลสถานะ API ที่หน้าสถานะแพลตฟอร์ม WhatsApp Business ก่อนลองอีกครั้ง

500

Internal Server Error

131021

Recipient cannot be sender

หมายเลขโทรศัพท์ของผู้ส่งและผู้รับเป็นหมายเลขเดียวกัน

ส่งข้อความไปยังหมายเลขโทรศัพท์อื่นที่ไม่ใช่หมายเลขเดียวกับของผู้ส่ง

400

คำขอไม่ถูกต้อง

131026

Message Undeliverable

ไม่สามารถส่งข้อความได้ โดยอาจมีสาเหตุดังต่อไปนี้

  • หมายเลขโทรศัพท์ของผู้รับไม่ใช่หมายเลขโทรศัพท์ WhatsApp
  • การส่งเทมเพลตการยืนยันตัวตนไปให้กับผู้ใช้ WhatsApp ที่มีรหัสการโทรของประเทศเป็น +91 (อินเดีย) ขณะนี้ไม่สามารถส่งเทมเพลตการยืนยันตัวตนให้กับผู้ใช้ WhatsApp ในอินเดียได้
  • ผู้รับไม่ยอมรับข้อกำหนดในการใช้บริการและนโยบายความเป็นส่วนตัวใหม่ของเรา
  • ผู้รับใช้ WhatsApp เวอร์ชั่นเก่า โดยจะต้องใช้ WhatsApp เวอร์ชั่นต่อไปนี้ขึ้นไป
    • Android: 2.21.15.15
    • SMBA: 2.21.15.15
    • iOS: 2.21.170.4
    • SMBI: 2.21.170.4
    • KaiOS: 2.2130.10
    • Web: 2.2132.6

ใช้วิธีการสื่อสารที่ไม่ใช่ WhatsApp โดยขอให้ผู้ใช้ WhatsApp ดำเนินการดังต่อไปนี้

  • ยืนยันว่าผู้ใช้สามารถส่งข้อความไปยังหมายเลขโทรศัพท์ธุรกิจของ WhatsApp ของคุณได้จริง
  • ยืนยันว่าได้ยอมรับข้อกำหนดในการใช้บริการฉบับล่าสุดแล้ว (การตั้งค่า > ความช่วยเหลือ หรือ การตั้งค่า > ข้อมูลของแอพพลิเคชั่น ซึ่งจะแจ้งให้ผู้ใช้ยอมรับข้อกำหนด/นโยบายล่าสุดหากยังไม่ได้ยอมรับ)
  • อัพเดตไคลเอ็นต์ WhatsApp เป็นเวอร์ชั่นล่าสุด

400

คำขอไม่ถูกต้อง

131042

Business eligibility payment issue

มีข้อผิดพลาดเกี่ยวกับวิธีการชำระเงินของคุณ

ดูเกี่ยวกับการเรียกเก็บเงินสำหรับบัญชี WhatsApp Business และตรวจสอบยืนยันว่าคุณได้ตั้งค่าการเรียกเก็บเงินอย่างถูกต้อง

ปัญหาที่พบบ่อยมีดังนี้

  • ไม่ได้ผูกบัญชีการชำระเงินเข้ากับบัญชี WhatsApp Business
  • วงเงินเครดิตเกินขีดจำกัด
  • ไม่ได้กำหนดวงเงินเครดิต (บัญชีการชำระเงิน) ไว้ หรือไม่มีการใช้งานอยู่
  • บัญชี WhatsApp Business ถูกลบแล้ว
  • บัญชี WhatsApp Business ถูกระงับการใช้งาน
  • ไม่ได้กำหนดโซนเวลา
  • ไม่ได้กำหนดสกุลเงิน
  • คำขอ MessagingFor (On Behalf Of) อยู่ระหว่างรอดำเนินการหรือถูกปฏิเสธ
  • เกินเกณฑ์ระดับการสนทนาแบบไม่มีค่าใช้จ่ายโดยไม่มีวิธีการชำระเงินที่ถูกต้อง

400

คำขอไม่ถูกต้อง

131045

Incorrect certificate

ส่งข้อความไม่สำเร็จเนื่องจากมีข้อผิดพลาดในการลงทะเบียนหมายเลขโทรศัพท์

ลงทะเบียนหมายเลขโทรศัพท์ก่อนลองอีกครั้ง

500

Internal Server Error

131047

Re-engagement message

เวลาผ่านไปเกินกว่า 24 ชั่วโมงนับตั้งแต่ผู้รับตอบกลับหมายเลขของผู้ส่งครั้งล่าสุด

ส่งข้อความที่เริ่มโดยธุรกิจถึงผู้รับโดยใช้เทมเพลตข้อความแทน

400

คำขอไม่ถูกต้อง

131049

Meta chose not to deliver.

ระบบไม่ได้ส่งข้อความนี้เพื่อรักษาการมีส่วนร่วมที่ดีในระบบนิเวศเอาไว้

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

ดูขีดจำกัดข้อความของเทมเพลตการตลาดต่อผู้ใช้สำหรับข้อมูลเพิ่มเติม

400

คำขอไม่ถูกต้อง

131051

Unsupported message type

ประเภทข้อความที่ไม่รองรับ

ดูประเภทข้อความที่รองรับที่ข้อความก่อนลองอีกครั้ง

400

คำขอไม่ถูกต้อง

131052

Media download error

ไม่สามารถดาวน์โหลดสื่อที่ผู้ใช้ส่งมาได้

เราไม่สามารถดาวน์โหลดสื่อที่มีอยู่ในข้อความของผู้ใช้ WhatsApp ได้ หากต้องการข้อมูลเพิ่มเติม โปรดอ้างอิงค่า error.error_data.details ใน Webhooks ข้อความ ใดๆ ที่ทำงานเมื่อได้รับข้อความนี้

ขอให้ผู้ใช้ WhatsApp ส่งไฟล์สื่อให้คุณด้วยวิธีที่ไม่ใช่ WhatsApp

400

คำขอไม่ถูกต้อง

131051

Media upload error

ไม่สามารถอัพโหลดสื่อที่ใช้ในข้อความได้

เราไม่สามารถอัพโหลดสื่อได้เนื่องจากเหตุผลอย่างน้อย 1 ข้อ เช่น ประเภทสื่อไม่รองรับ

หากต้องการข้อมูลเพิ่มเติม โปรดอ้างอิงค่า error.error_data.details ใน Webhooks ข้อความ ใดๆ ที่ทำงานเมื่อส่งข้อความไม่สำเร็จ

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

file -I rejected-file.mov

จากนั้น คุณจะสามารถยืนยันได้ว่าระบบรองรับประเภท MIME หรือไม่ โปรดดูที่ประเภทสื่อที่รองรับ

400

คำขอไม่ถูกต้อง

131057

Account in maintenance mode

บัญชีธุรกิจอยู่ในโหมดบำรุงรักษา

บัญชี WhatsApp Business อยู่ในโหมดบำรุงรักษา สาเหตุหนึ่งอาจเป็นเพราะบัญชีกำลังอยู่ระหว่างการอัพเกรดปริมาณข้อความ

500

คำขอไม่ถูกต้อง

132000

Template Param Count Mismatch

จำนวนค่าพารามิเตอร์ตัวแปรที่รวมอยู่ในคำขอไม่ตรงกับจำนวนพารามิเตอร์ตัวแปรที่กำหนดไว้ในเทมเพลต

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

400

คำขอไม่ถูกต้อง

132001

Template does not exist

ไม่มีเทมเพลตในภาษาที่ระบุหรือเทมเพลตยังไม่ได้รับการอนุมัติ

ตรวจสอบให้แน่ใจว่าเทมเพลตของคุณได้รับการอนุมัติแล้ว รวมถึงชื่อและรูปแบบภาษาของเทมเพลตนั้นถูกต้อง โปรดตรวจสอบให้แน่ใจว่าคุณปฏิบัติตามคำแนะนำเกี่ยวกับเทมเพลตข้อความ

404

ไม่พบ

132005

Template Hydrated Text Too Long

ข้อความแปลยาวเกินไป

ตรวจสอบตัวจัดการ WhatsApp เพื่อตรวจสอบยืนยันว่าเทมเพลตของคุณได้รับการแปลแล้ว ดูการให้คะแนนคุณภาพและสถานะเทมเพลต

400

คำขอไม่ถูกต้อง

132007

Template Format Character Policy Violated

เนื้อหาในเทมเพลตละเมิดนโยบายของ WhatsApp

ดูเหตุผลที่ถูกปฏิเสธเพื่อระบุสาเหตุที่อาจเป็นการละเมิด

400

คำขอไม่ถูกต้อง

132012

Template Parameter Format Mismatch

ค่าพารามิเตอร์ตัวแปรได้รับการจัดรูปแบบไม่ถูกต้อง

ค่าพารามิเตอร์ตัวแปรที่รวมอยู่ในคำขอไม่ได้ใช้รูปแบบที่ระบุไว้ในเทมเพลต ดูคำแนะนำเกี่ยวกับเทมเพลตข้อความ

400

คำขอไม่ถูกต้อง

132015

Template is Paused

เทมเพลตถูกหยุดใช้งานชั่วคราวเนื่องจากมีคุณภาพต่ำจึงไม่สามารถส่งในข้อความเทมเพลตได้

แก้ไขเทมเพลตเพื่อปรับปรุงคุณภาพ และลองอีกครั้งเมื่อเทมเพลตได้รับอนุมัติแล้ว

400

คำขอไม่ถูกต้อง

132016

Template is Disabled

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

สร้างเทมเพลตใหม่ที่มีเนื้อหาต่างจากเดิม

400

คำขอไม่ถูกต้อง

132068

Flow is blocked

ขั้นตอนอยู่ในสถานะถูกบล็อก

แก้ไขขั้นตอน

400

คำขอไม่ถูกต้อง

132069

Flow is throttled

ขั้นตอนอยู่ในสถานะถูกจำกัดปริมาณและมีการส่งข้อความที่ใช้ขั้นตอนนี้ไปแล้ว 10 ข้อความในชั่วโมงที่ผ่านมา

แก้ไขขั้นตอน

400

คำขอไม่ถูกต้อง

133000

Incomplete Deregistration

ความพยายามในการยกเลิกการลงทะเบียนครั้งก่อนล้มเหลว

ยกเลิกการลงทะเบียนหมายเลขอีกครั้งก่อนลงทะเบียน

500

Internal Server Error

133004

Server Temporarily Unavailable

เซิร์ฟเวอร์ไม่สามารถใช้งานได้ชั่วคราว

โปรดดูข้อมูลสถานะ API ที่หน้าสถานะแพลตฟอร์ม WhatsApp Business และตรวจสอบค่า details ของการตอบกลับก่อนลองอีกครั้ง

503

Service Unavailable

133005

Two step verification PIN Mismatch

PIN สำหรับการตรวจสอบยืนยันสองขั้นตอนไม่ถูกต้อง

ตรวจสอบยืนยันว่า PIN สำหรับการตรวจสอบยืนยันสองขั้นตอนที่รวมอยู่ในคำขอนั้นถูกต้อง


วิธีรีเซ็ต PIN สำหรับการตรวจสอบยืนยันสองขั้นตอนมีดังนี้


  1. ปิดใช้งานการตรวจสอบยืนยันสองขั้นตอน
  2. ส่งคำขอ POST ที่มี PIN ใหม่รวมอยู่ด้วยไปยังตำแหน่งข้อมูลหมายเลขโทรศัพท์

400

คำขอไม่ถูกต้อง

133006

Phone number re-verification needed

จำเป็นต้องตรวจสอบยืนยันหมายเลขโทรศัพท์ก่อนลงทะเบียน

ตรวจสอบยืนยันหมายเลขโทรศัพท์ก่อนลงทะเบียนหมายเลขนั้น

400

คำขอไม่ถูกต้อง

133008

Too Many two step verification PIN Guesses

มีการคาดเดา PIN สำหรับการตรวจสอบยืนยันสองขั้นตอนหลายครั้งเกินไปสำหรับหมายเลขโทรศัพท์นี้

ลองอีกครั้งหลังพ้นระยะเวลาที่ระบุไว้ในค่าการตอบกลับ details

400

คำขอไม่ถูกต้อง

133009

Two step verification PIN Guessed Too Fast

ป้อน PIN สำหรับการตรวจสอบยืนยันสองขั้นตอนเร็วเกินไป

ตรวจสอบค่าการตอบกลับ details ก่อนลองอีกครั้ง

400

คำขอไม่ถูกต้อง

133010

Phone number Not Registered

ยังไม่ได้ลงทะเบียนหมายเลขโทรศัพท์บนแพลตฟอร์ม WhatsApp Business

ลงทะเบียนหมายเลขโทรศัพท์ก่อนลองอีกครั้ง

400

คำขอไม่ถูกต้อง

133015

Please wait a few minutes before attempting to register this phone number

หมายเลขโทรศัพท์ที่คุณพยายามลงทะเบียนถูกลบไปเมื่อเร็วๆ นี้ และการลบยังไม่เสร็จสมบูรณ์

รอ 5 นาที จากนั้นลองส่งคำขออีกครั้ง

400

คำขอไม่ถูกต้อง

135000

Generic user error

ส่งข้อความไม่สำเร็จเนื่องจากพารามิเตอร์คำขอของคุณมีข้อผิดพลาดที่ไม่รู้จัก

ดูข้อมูลอ้างอิงของตำแหน่งข้อมูลเพื่อพิจารณาว่าคุณสืบค้นตำแหน่งข้อมูลโดยใช้รูปแบบคำสั่งที่ถูกต้องหรือไม่ ติดต่อฝ่ายบริการลูกค้าหากคุณยังคงได้รับรหัสข้อผิดพลาดนี้ในการตอบกลับ

400

คำขอไม่ถูกต้อง