Nền tảng WhatsApp Business > API Đám mây

Mã lỗi cho API Đám mây

API Đám mây được xây dựng dựa trên API Đồ thị. Vì vậy, nếu bạn chưa nắm vững cách xử lý các phản hồi lỗi của API Đồ thị, hãy xem tài liệu hướng dẫn xử lý lỗi của API Đồ thị.

Nhìn chung, bạn nên xây dựng logic xử lý lỗi của ứng dụng xoay quanh các giá trị code và thuộc tính phần tải dữ liệu details. Những thuộc tính này cùng giá trị của chúng thể hiện nhiều hơn lỗi cơ bản.

Các tiêu đề mã không có thuộc tính riêng trong phần tải dữ liệu phản hồi lỗi API sẽ có trong giá trị message. Tuy nhiên, bạn không nên xây dựng logic xử lý lỗi dựa trên tiêu đề vì cuối cùng tiêu đề sẽ không được dùng nữa.

Nhận lỗi: đồng bộ và không đồng bộ

Lỗi API Đám mây được trả về theo cách đồng bộ dưới dạng phản hồi của API Đồ thị, không đồng bộ qua Webhook hoặc đôi khi thông qua cả hai phương thức này.

Khi làm việc với API Đám mây, bạn nên giám sát cả phản hồi của API Đồ thị và webhook messages để xử lý lỗi. Nếu đăng ký trường webhook messages, bạn sẽ nhận được thông báo lỗi khi xảy ra lỗi cho những loại lỗi không đồng bộ được hỗ trợ.

Webhook và cú pháp phản hồi lỗi

Lỗi API Đám mây có thể xuất hiện trong những đối tượng webhook sau đây:

API Đám mây

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

API Tại chỗ

errors

Cú pháp phản hồi lỗi

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

Nội dung phản hồi lỗi

Thuộc tính	Loại giá trị	Mô tả
`code`	Số nguyên	Mã lỗi. Bạn nên xây dựng logic xử lý lỗi của ứng dụng xoay quanh mã lỗi thay vì mã phụ hoặc mã trạng thái phản hồi HTTP.
`details`	Chuỗi	Mô tả lỗi và mô tả lý do có nhiều khả năng gây ra lỗi nhất. Cũng có thể chứa thông tin về cách xử lý lỗi, chẳng hạn như thông số không hợp lệ hoặc các giá trị được chấp nhận.
`error_subcode`	Số nguyên	Không dùng nữa. Sẽ không được trả về trong phản hồi của v16.0 trở lên. Mã phụ cho API Đồ thị. Không phải phản hồi nào cũng chứa mã phụ. Vì vậy, bạn nên xây dựng logic xử lý lỗi xoay quanh các thuộc tính `code` và `details`.
`fbtrace_id`	Chuỗi	ID theo dõi mà bạn có thể đưa vào khi liên hệ với bộ phận Hỗ trợ trực tiếp. ID này có thể hỗ trợ chúng tôi gỡ lỗi.
`message`	Chuỗi	Tổ hợp mã lỗi và tiêu đề lỗi. Ví dụ: `(#130429) Rate limit hit`.
`messaging_product`	Chuỗi	Sản phẩm nhắn tin. Thuộc tính này sẽ luôn là chuỗi `whatsapp` đối với phản hồi API Đám mây.
`type`	Chuỗi	Loại lỗi.

Phản hồi mẫu

{
  "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"
  }
}

Mã lỗi

Lỗi ủy quyền

Mã	Mô tả	Giải pháp khả thi	Mã trạng thái HTTP
`0` AuthException	Chúng tôi không thể xác thực người dùng ứng dụng.	Thông thường, mã lỗi này cho biết mã truy cập được đưa vào đã hết hạn, đã bị vô hiệu hóa hoặc người dùng ứng dụng đã thay đổi cài đặt để ngăn tất cả ứng dụng truy cập dữ liệu của họ. Bạn nên lấy mã truy cập mới.	`401` Trái phép
`3` Phương thức API	Vấn đề về tính năng hoặc quyền.	Sử dụng trình gỡ lỗi mã truy cập để xác minh rằng ứng dụng của bạn đã được cấp các quyền mà điểm cuối yêu cầu. Hãy xem bài viết Khắc phục sự cố.	`500` Lỗi máy chủ nội bộ
`10` Quyền bị từ chối	Quyền không được cấp hoặc đã bị gỡ.	Sử dụng trình gỡ lỗi mã truy cập để xác minh rằng ứng dụng của bạn đã được cấp các quyền mà điểm cuối yêu cầu. Hãy xem phần Khắc phục sự cố. Đảm bảo rằng số điện thoại dùng để đặt khóa công khai của doanh nghiệp đã được đưa vào danh sách cho phép.	`403` Bị cấm
`190` Mã truy cập đã hết hạn	Mã truy cập của bạn đã hết hạn.	Lấy mã truy cập mới.	`401` Trái phép
`200-299` Quyền truy cập vào API	Quyền không được cấp hoặc đã bị thu hồi.	Sử dụng trình gỡ lỗi mã truy cập để xác minh rằng ứng dụng của bạn đã được cấp các quyền mà điểm cuối yêu cầu. Hãy xem phần Khắc phục sự cố.	`403` Bị cấm

Lỗi giới hạn tốc độ

Mã	Mô tả	Giải pháp khả thi	Mã trạng thái HTTP
`4` Quá nhiều lệnh gọi API	Ứng dụng đã đạt đến giới hạn tốc độ cho lệnh gọi API.	Tải ứng dụng vào Bảng điều khiển ứng dụng và xem phần Giới hạn tốc độ ứng dụng để xác minh rằng ứng dụng đã đạt đến giới hạn tốc độ. Nếu đúng, hãy thử lại sau hoặc giảm tần suất hay số lượng truy vấn API mà ứng dụng đang thực hiện.	`400` Yêu cầu không hợp lệ
`80007` Vấn đề về giới hạn tốc độ	Tài khoản WhatsApp Business đã đạt đến giới hạn tốc độ.	Xem phần Giới hạn tốc độ cho Tài khoản WhatsApp Business. Hãy thử lại sau hoặc giảm tần suất hay số lượng truy vấn API mà ứng dụng đang thực hiện.	`400` Yêu cầu không hợp lệ
`130429` Đã đạt giới hạn tốc độ	Đã đạt đến thông lượng tin nhắn của API Đám mây.	Ứng dụng đã đạt đến giới hạn thông lượng của API. Hãy xem phần Thông lượng. Thử lại sau hoặc giảm tần suất gửi tin nhắn của ứng dụng.	`400` Yêu cầu không hợp lệ
`131048` Đã đạt giới hạn tỷ lệ spam	Không gửi được tin nhắn vì có hạn chế về số lượng tin nhắn có thể gửi từ số điện thoại này. Lỗi này có thể là do quá nhiều tin nhắn bị chặn hoặc bị gắn cờ là spam trước đây.	Kiểm tra trạng thái chất lượng của bạn trong Trình quản lý WhatsApp và xem tài liệu về Giới hạn tốc độ dựa trên chất lượng để biết thêm thông tin.	`400` Yêu cầu không hợp lệ
`131056` Đã đạt giới hạn tốc độ ghép nối (Tài khoản kinh doanh, Tài khoản khách hàng)	Số điện thoại của người gửi đã gửi quá nhiều tin nhắn đến cùng một số điện thoại của người nhận trong khoảng thời gian ngắn.	Nếu bạn định gửi tin nhắn đến cùng một số điện thoại, hãy đợi và thử thực hiện lại thao tác. Bạn vẫn có thể gửi tin nhắn đến số điện thoại khác mà không cần đợi	`400` Yêu cầu không hợp lệ
`133016` Đã vượt quá giới hạn tốc độ đăng ký/hủy đăng ký tài khoản	Đăng ký hoặc Hủy đăng ký không thành công do bạn đã đăng ký/hủy đăng ký quá nhiều lần cho số điện thoại này trong một khoảng thời gian ngắn	Số điện thoại của doanh nghiệp đang bị chặn vì đã đạt đến giới hạn số lần đăng ký/hủy đăng ký. Hãy thử lại sau khi số này được bỏ chặn. Xem phần "Giới hạn" trong tài liệu Đăng ký.	`400` Yêu cầu không hợp lệ

Lỗi về tính toàn vẹn

Mã Mô tả Giải pháp khả thi Mã trạng thái HTTP

Mã	Mô tả	Giải pháp khả thi	Mã trạng thái HTTP
`368` Tạm thời bị chặn do vi phạm chính sách	Tài khoản WhatsApp Business liên kết với ứng dụng đã bị hạn chế hoặc vô hiệu hóa do vi phạm chính sách nền tảng.	Xem tài liệu về Thực thi chính sách để tìm hiểu về các trường hợp vi phạm chính sách và cách giải quyết.	`403` Bị cấm
`130497` Tài khoản kinh doanh bị hạn chế nhắn tin cho người dùng ở quốc gia này.	Tài khoản WhatsApp Business bị hạn chế nhắn tin cho người dùng ở một số quốc gia.	Xem Chính sách nhắn tin của WhatsApp Business để biết chi tiết về các quốc gia được phép nhắn tin trong hạng mục kinh doanh của bạn.	`403` Bị cấm
`131031` Tài khoản đã bị khóa	Tài khoản WhatsApp Business liên kết với ứng dụng đã bị hạn chế hoặc vô hiệu hóa do vi phạm chính sách nền tảng hoặc chúng tôi không thể xác minh dữ liệu có trong yêu cầu dựa vào tập dữ liệu trên Tài khoản WhatsApp Business (ví dụ: mã pin 2 bước trong yêu cầu không chính xác).	Xem tài liệu về Thực thi chính sách để tìm hiểu về các trường hợp vi phạm chính sách và cách giải quyết. Bạn cũng có thể dùng API Trạng thái tình trạng để biết thêm thông tin chi tiết về (các) lý do khiến tài khoản bị khóa.	`403` Bị cấm

368

Tạm thời bị chặn do vi phạm chính sách

Tài khoản WhatsApp Business liên kết với ứng dụng đã bị hạn chế hoặc vô hiệu hóa do vi phạm chính sách nền tảng.

Xem tài liệu về Thực thi chính sách để tìm hiểu về các trường hợp vi phạm chính sách và cách giải quyết.

403

Bị cấm

130497

Tài khoản kinh doanh bị hạn chế nhắn tin cho người dùng ở quốc gia này.

Tài khoản WhatsApp Business bị hạn chế nhắn tin cho người dùng ở một số quốc gia.

Xem Chính sách nhắn tin của WhatsApp Business để biết chi tiết về các quốc gia được phép nhắn tin trong hạng mục kinh doanh của bạn.

403

Bị cấm

131031

Tài khoản đã bị khóa

Tài khoản WhatsApp Business liên kết với ứng dụng đã bị hạn chế hoặc vô hiệu hóa do vi phạm chính sách nền tảng hoặc chúng tôi không thể xác minh dữ liệu có trong yêu cầu dựa vào tập dữ liệu trên Tài khoản WhatsApp Business (ví dụ: mã pin 2 bước trong yêu cầu không chính xác).

Xem tài liệu về Thực thi chính sách để tìm hiểu về các trường hợp vi phạm chính sách và cách giải quyết.

Bạn cũng có thể dùng API Trạng thái tình trạng để biết thêm thông tin chi tiết về (các) lý do khiến tài khoản bị khóa.

403

Bị cấm

Lỗi khác

Mã Mô tả Giải pháp khả thi Mã trạng thái HTTP

Mã	Mô tả	Giải pháp khả thi	Mã trạng thái HTTP
`1` API không xác định	Yêu cầu không hợp lệ hoặc có thể do lỗi máy chủ.	Truy cập trang Trạng thái Nền tảng WhatsApp Business để xem thông tin về trạng thái API. Nếu không có lỗi máy chủ, hãy xem tài liệu tham khảo về điểm cuối và xác minh rằng yêu cầu của bạn được định dạng chính xác và đáp ứng mọi yêu cầu của điểm cuối.	`400` Yêu cầu không hợp lệ
`2` Dịch vụ API	Sự cố tạm thời do thời gian dừng chạy hoặc do quá tải.	Truy cập trang Trạng thái Nền tảng WhatsApp Business để xem thông tin về trạng thái API trước khi thử lại.	`503` Dịch vụ không khả dụng
`33` Giá trị thông số không hợp lệ	Số điện thoại của doanh nghiệp đã bị xóa.	Xác minh rằng số điện thoại của doanh nghiệp là chính xác.	`400` Yêu cầu không hợp lệ
`100` Thông số không hợp lệ	Yêu cầu có chứa một hoặc nhiều thông số không được hỗ trợ hoặc bị sai chính tả.	Xem tài liệu tham khảo của điểm cuối để xác định những thông số được hỗ trợ và cách viết đúng chính tả thông số đó. Đảm bảo rằng khi đặt khóa công khai của doanh nghiệp, khóa này là khóa công khai RSA 2048 bit hợp lệ ở định dạng PEM. Đảm bảo rằng ID số điện thoại bạn đang đăng ký trùng khớp với ID số điện thoại đã lưu trữ trước đây. Đảm bảo thông số nằm trong giới hạn độ dài dành cho loại thông số đó.	`400` Yêu cầu không hợp lệ
`130472` Số của người dùng đang được thử nghiệm	Tin nhắn không gửi được do đang trong quá trình thử nghiệm.	Xem phần Thử nghiệm tin nhắn marketing.	`400` Yêu cầu không hợp lệ
`131000` Đã xảy ra lỗi	Không gửi được tin nhắn do một lỗi không xác định. Khi đặt khóa công khai của doanh nghiệp, khóa này không tính được chữ ký, không gọi được điểm cuối GraphQL hoặc điểm cuối GraphQL trả về lỗi.	Thử lại. Nếu lỗi vẫn tiếp diễn, hãy mở phiếu Hỗ trợ trực tiếp.	`500` Lỗi máy chủ nội bộ
`131005` Truy cập bị từ chối	Quyền không được cấp hoặc đã bị gỡ.	Sử dụng trình gỡ lỗi mã truy cập để xác minh rằng ứng dụng của bạn đã được cấp các quyền mà điểm cuối yêu cầu. Hãy xem phần Khắc phục sự cố.	`403` Bị cấm
`131008` Thiếu thông số bắt buộc	Yêu cầu bị thiếu thông số bắt buộc.	Xem tài liệu tham khảo của điểm cuối để xác định những thông số bắt buộc.	`400` Yêu cầu không hợp lệ
`131009` Giá trị thông số không hợp lệ	Một hoặc nhiều giá trị thông số không hợp lệ.	Xem tài liệu tham khảo của điểm cuối để xác định giá trị được hỗ trợ cho mỗi thông số, đồng thời xem bài viết Số điện thoại để tìm hiểu cách thêm số điện thoại vào Tài khoản WhatsApp Business.	`400` Yêu cầu không hợp lệ
`131016` Dịch vụ không khả dụng	Dịch vụ tạm thời không khả dụng.	Truy cập trang Trạng thái Nền tảng WhatsApp Business để xem thông tin về trạng thái API trước khi thử lại.	`500` Lỗi máy chủ nội bộ
`131021` Người nhận không được là người gửi	Số điện thoại của người gửi và người nhận giống nhau.	Gửi tin nhắn đến số điện thoại khác với số điện thoại của người gửi.	`400` Yêu cầu không hợp lệ
`131026` Không gửi được tin nhắn	Không thể gửi tin nhắn. Lý do có thể bao gồm: Số điện thoại của người nhận không phải là số điện thoại WhatsApp. Gửi mẫu xác thực cho người dùng WhatsApp có mã vùng quốc gia là +91 (Ấn Độ). Hiện tại, bạn không thể gửi mẫu xác thực cho người dùng WhatsApp ở Ấn Độ. Người nhận chưa chấp nhận Điều khoản dịch vụ và Chính sách quyền riêng tư mới của chúng tôi. Người nhận đang dùng phiên bản WhatsApp cũ; phải sử dụng phiên bản WhatsApp dưới đây trở lên: 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	Trong trường hợp sử dụng phương thức liên lạc khác ngoài WhatsApp, hãy yêu cầu người dùng WhatsApp: Xác nhận rằng người dùng thực sự có thể gửi tin nhắn đến số điện thoại WhatsApp của doanh nghiệp bạn. Xác nhận rằng người dùng đã chấp nhận Điều khoản dịch vụ mới nhất của chúng tôi (nếu chưa làm vậy, người dùng sẽ được nhắc chấp nhận điều khoản/chính sách mới nhất trong phần Cài đặt > Trợ giúp hoặc Cài đặt > Thông tin ứng dụng) Cập nhật ứng dụng WhatsApp lên phiên bản mới nhất.	`400` Yêu cầu không hợp lệ
`131042` Vấn đề thanh toán liên quan đến tình trạng đủ điều kiện kinh doanh	Đã xảy ra lỗi liên quan đến phương thức thanh toán của bạn.	Xem bài viết Giới thiệu về cách lập hóa đơn cho Tài khoản WhatsApp Business và xác minh rằng bạn đã thiết lập chính xác thông tin lập hóa đơn. Các sự cố thường gặp: Tài khoản thanh toán không gắn liền với Tài khoản WhatsApp Business Vượt quá hạn mức tín dụng Hạn mức tín dụng (Tài khoản thanh toán) chưa được đặt hoặc không hoạt động Tài khoản WhatsApp Business đã bị xóa Tài khoản WhatsApp Business đã bị đình chỉ Chưa đặt múi giờ Chưa đặt đơn vị tiền tệ Yêu cầu MessagingFor (Thay mặt) đang chờ xử lý hoặc đã bị từ chối Đã vượt quá ngưỡng trò chuyện gói miễn phí mà không có phương thức thanh toán hợp lệ	`400` Yêu cầu không hợp lệ
`131045` Chứng chỉ không chính xác	Không gửi được tin nhắn do lỗi đăng ký số điện thoại.	Đăng ký số điện thoại trước khi thử lại.	`500` Lỗi máy chủ nội bộ
`131047` Tin nhắn tái thu hút	Đã quá 24 giờ kể từ lần gần đây nhất người nhận trả lời số điện thoại của người gửi.	Gửi cho người nhận một tin nhắn do doanh nghiệp bắt đầu bằng cách sử dụng mẫu tin nhắn.	`400` Yêu cầu không hợp lệ
`131049` Meta đã chọn không gửi tin nhắn.	Tin nhắn này không được gửi để duy trì hoạt động tương tác lành mạnh trong hệ sinh thái.	Không thử gửi lại ngay nếu bạn nhận được mã lỗi này và nghi ngờ là do giới hạn. Thay vào đó, hãy thử lại với khoảng thời gian tăng dần cho đến khi gửi được tin nhắn, vì giới hạn có thể có hiệu lực trong những khoảng thời gian khác nhau. Hãy xem phần Giới hạn tin nhắn marketing mẫu cho mỗi người dùng để biết thêm thông tin.	`400` Yêu cầu không hợp lệ
`131051` Loại tin nhắn không được hỗ trợ	Loại tin nhắn không được hỗ trợ.	Xem bài viết Tin nhắn để biết các loại tin nhắn được hỗ trợ trước khi thử lại với loại tin nhắn được hỗ trợ.	`400` Yêu cầu không hợp lệ
`131052` Lỗi tải xuống file phương tiện	Không thể tải xuống file phương tiện do người dùng gửi.	Chúng tôi không thể tải xuống file phương tiện có trong tin nhắn của người dùng WhatsApp. Để biết thêm thông tin, hãy tham khảo giá trị `error.error_data.details` trong bất kỳ webhook tin nhắn nào được kích hoạt khi nhận được tin nhắn này. Yêu cầu người dùng WhatsApp gửi cho bạn file phương tiện bằng phương thức khác ngoài WhatsApp.	`400` Yêu cầu không hợp lệ
`131053` Lỗi tải file phương tiện lên	Không thể tải lên file phương tiện được sử dụng trong tin nhắn.	Chúng tôi không thể tải file phương tiện lên vì một hoặc nhiều lý do, chẳng hạn như loại file phương tiện không được hỗ trợ. Để biết thêm thông tin, hãy tham khảo giá trị `error.error_data.details` trong bất kỳ webhook tin nhắn nào được kích hoạt khi không gửi được tin nhắn này. Bạn nên kiểm tra bất kỳ file phương tiện nào gây ra lỗi và xác nhận rằng trên thực tế, những file phương tiện đó được hỗ trợ. Ví dụ: trong UNIX, bạn có thể dùng lệnh kiểm tra file qua dòng lệnh để xác định loại MIME của file này: `file -I rejected-file.mov` Sau đó, bạn có thể xác nhận rằng loại MIME của file này được hỗ trợ. Hãy xem phần Loại file phương tiện được hỗ trợ.	`400` Yêu cầu không hợp lệ
`131057` Tài khoản đang ở chế độ bảo trì	Tài khoản kinh doanh đang ở chế độ bảo trì	Tài khoản WhatsApp Business đang ở chế độ bảo trì. Nguyên nhân có thể là do tài khoản đang trong quá trình nâng cấp thông lượng.	`500` Yêu cầu không hợp lệ
`132000` Số lượng thông số trong mẫu không khớp	Số lượng giá trị thông số biến có trong yêu cầu không khớp với số lượng thông số biến được xác định trong mẫu.	Xem Nguyên tắc tạo mẫu tin nhắn và đảm bảo rằng yêu cầu có chứa mọi giá trị thông số biến đã được xác định trong mẫu.	`400` Yêu cầu không hợp lệ
`132001` Mẫu không tồn tại	Mẫu không tồn tại ở ngôn ngữ đã chỉ định hoặc mẫu chưa được phê duyệt.	Đảm bảo mẫu của bạn đã được phê duyệt, cũng như tên và ngôn ngữ của mẫu chính xác. Vui lòng đảm bảo bạn tuân thủ nguyên tắc tạo mẫu tin nhắn.	`404` Không tìm thấy
`132005` Văn bản tái lập của mẫu quá dài	Bản dịch quá dài.	Kiểm tra Trình quản lý WhatsApp để xác minh rằng mẫu của bạn đã được dịch. Hãy xem phần Xếp hạng chất lượng và trạng thái mẫu.	`400` Yêu cầu không hợp lệ
`132007` Đã vi phạm chính sách ký tự định dạng trong mẫu	Nội dung mẫu vi phạm chính sách của WhatsApp.	Xem phần Lý do từ chối để xác định những lý do có thể đã dẫn đến trường hợp vi phạm.	`400` Yêu cầu không hợp lệ
`132012` Định dạng thông số trong mẫu không khớp	Các giá trị thông số biến được định dạng không chính xác.	Các giá trị thông số biến có trong yêu cầu không sử dụng định dạng được chỉ định trong mẫu. Hãy xem phần Nguyên tắc tạo mẫu tin nhắn.	`400` Yêu cầu không hợp lệ
`132015` Mẫu bị tạm dừng	Mẫu bị tạm dừng do có chất lượng thấp nên không thể gửi mẫu trong tin nhắn mẫu.	Chỉnh sửa mẫu để cải thiện chất lượng rồi thử lại sau khi mẫu được phê duyệt.	`400` Yêu cầu không hợp lệ
`132016` Mẫu bị vô hiệu hóa	Mẫu đã bị tạm dừng quá nhiều lần do có chất lượng thấp nên giờ bị vô hiệu hóa vĩnh viễn.	Tạo mẫu mới có nội dung khác.	`400` Yêu cầu không hợp lệ
`132068` Quy trình bị chặn	Quy trình ở trạng thái bị chặn.	Sửa quy trình	`400` Yêu cầu không hợp lệ
`132069` Quy trình bị giới hạn tốc độ	Quy trình ở trạng thái bị giới hạn tốc độ và 10 tin nhắn sử dụng quy trình này đã được gửi trong một giờ qua.	Sửa quy trình	`400` Yêu cầu không hợp lệ
`133000` Hủy đăng ký chưa hoàn tất	Lần hủy đăng ký trước đó không thành công.	Hủy đăng ký số điện thoại lần nữa trước khi đăng ký.	`500` Lỗi máy chủ nội bộ
`133004` Máy chủ tạm thời không khả dụng	Máy chủ tạm thời không khả dụng.	Truy cập trang Trạng thái Nền tảng WhatsApp Business để xem thông tin về trạng thái API và kiểm tra giá trị `details` của phần phản hồi trước khi thử lại.	`503` Dịch vụ không khả dụng
`133005` Mã PIN xác minh 2 bước không khớp	Mã PIN xác minh 2 bước không chính xác.	Xác minh rằng mã PIN xác minh 2 bước có trong yêu cầu là chính xác. Cách đặt lại mã PIN xác minh 2 bước: Tắt tính năng xác minh hai bước. Gửi yêu cầu POST chứa mã PIN mới đến điểm cuối Số điện thoại.	`400` Yêu cầu không hợp lệ
`133006` Cần xác minh lại số điện thoại	Cần xác minh lại số điện thoại trước khi đăng ký.	Xác minh số điện thoại trước khi đăng ký.	`400` Yêu cầu không hợp lệ
`133008` Đoán mã PIN xác minh 2 bước quá nhiều lần	Đoán mã PIN xác minh 2 bước quá nhiều lần cho số điện thoại này.	Thử lại sau khoảng thời gian đã chỉ định trong giá trị phản hồi `details`.	`400` Yêu cầu không hợp lệ
`133009` Tốc độ đoán mã PIN xác minh 2 bước quá nhanh	Mã PIN xác minh 2 bước được nhập quá nhanh.	Kiểm tra giá trị phản hồi `details` trước khi thử lại.	`400` Yêu cầu không hợp lệ
`133010` Số điện thoại chưa được đăng ký	Số điện thoại chưa được đăng ký trên Nền tảng WhatsApp Business.	Đăng ký số điện thoại trước khi thử lại.	`400` Yêu cầu không hợp lệ
`133015` Vui lòng chờ vài phút rồi mới đăng ký số điện thoại này	Số điện thoại bạn đang đăng ký đã bị xóa gần đây và quá trình xóa vẫn chưa hoàn tất.	Chờ 5 phút rồi mới thử yêu cầu lại.	`400` Yêu cầu không hợp lệ
`135000` Lỗi người dùng chung	Không gửi được tin nhắn do một lỗi không xác định liên quan đến thông số yêu cầu của bạn.	Xem tài liệu tham khảo của điểm cuối để xác định liệu bạn có đang dùng cú pháp chính xác để truy vấn điểm cuối hay không. Hãy liên hệ với bộ phận hỗ trợ khách hàng nếu bạn tiếp tục nhận được mã lỗi này trong phản hồi.	`400` Yêu cầu không hợp lệ

1

API không xác định

Yêu cầu không hợp lệ hoặc có thể do lỗi máy chủ.

Truy cập trang Trạng thái Nền tảng WhatsApp Business để xem thông tin về trạng thái API. Nếu không có lỗi máy chủ, hãy xem tài liệu tham khảo về điểm cuối và xác minh rằng yêu cầu của bạn được định dạng chính xác và đáp ứng mọi yêu cầu của điểm cuối.

400

Yêu cầu không hợp lệ

2

Dịch vụ API

Sự cố tạm thời do thời gian dừng chạy hoặc do quá tải.

Truy cập trang Trạng thái Nền tảng WhatsApp Business để xem thông tin về trạng thái API trước khi thử lại.

503

Dịch vụ không khả dụng

33

Giá trị thông số không hợp lệ

Số điện thoại của doanh nghiệp đã bị xóa.

Xác minh rằng số điện thoại của doanh nghiệp là chính xác.

400

Yêu cầu không hợp lệ

100

Thông số không hợp lệ

Yêu cầu có chứa một hoặc nhiều thông số không được hỗ trợ hoặc bị sai chính tả.

Xem tài liệu tham khảo của điểm cuối để xác định những thông số được hỗ trợ và cách viết đúng chính tả thông số đó.

Đảm bảo rằng khi đặt khóa công khai của doanh nghiệp, khóa này là khóa công khai RSA 2048 bit hợp lệ ở định dạng PEM.

Đảm bảo rằng ID số điện thoại bạn đang đăng ký trùng khớp với ID số điện thoại đã lưu trữ trước đây.

Đảm bảo thông số nằm trong giới hạn độ dài dành cho loại thông số đó.

400

Yêu cầu không hợp lệ

130472

Số của người dùng đang được thử nghiệm

Tin nhắn không gửi được do đang trong quá trình thử nghiệm.

Xem phần Thử nghiệm tin nhắn marketing.

400

Yêu cầu không hợp lệ

131000

Đã xảy ra lỗi

Không gửi được tin nhắn do một lỗi không xác định.

Khi đặt khóa công khai của doanh nghiệp, khóa này không tính được chữ ký, không gọi được điểm cuối GraphQL hoặc điểm cuối GraphQL trả về lỗi.

Thử lại. Nếu lỗi vẫn tiếp diễn, hãy mở phiếu Hỗ trợ trực tiếp.

500

Lỗi máy chủ nội bộ

131005

Truy cập bị từ chối

Quyền không được cấp hoặc đã bị gỡ.

Sử dụng trình gỡ lỗi mã truy cập để xác minh rằng ứng dụng của bạn đã được cấp các quyền mà điểm cuối yêu cầu. Hãy xem phần Khắc phục sự cố.

403

Bị cấm

131008

Thiếu thông số bắt buộc

Yêu cầu bị thiếu thông số bắt buộc.

Xem tài liệu tham khảo của điểm cuối để xác định những thông số bắt buộc.

400

Yêu cầu không hợp lệ

131009

Giá trị thông số không hợp lệ

Một hoặc nhiều giá trị thông số không hợp lệ.

Xem tài liệu tham khảo của điểm cuối để xác định giá trị được hỗ trợ cho mỗi thông số, đồng thời xem bài viết Số điện thoại để tìm hiểu cách thêm số điện thoại vào Tài khoản WhatsApp Business.

400

Yêu cầu không hợp lệ

131016

Dịch vụ không khả dụng

Dịch vụ tạm thời không khả dụng.

Truy cập trang Trạng thái Nền tảng WhatsApp Business để xem thông tin về trạng thái API trước khi thử lại.

500

Lỗi máy chủ nội bộ

131021

Người nhận không được là người gửi

Số điện thoại của người gửi và người nhận giống nhau.

Gửi tin nhắn đến số điện thoại khác với số điện thoại của người gửi.

400

Yêu cầu không hợp lệ

131026

Không gửi được tin nhắn

Không thể gửi tin nhắn. Lý do có thể bao gồm:

Số điện thoại của người nhận không phải là số điện thoại WhatsApp.
Gửi mẫu xác thực cho người dùng WhatsApp có mã vùng quốc gia là +91 (Ấn Độ). Hiện tại, bạn không thể gửi mẫu xác thực cho người dùng WhatsApp ở Ấn Độ.
Người nhận chưa chấp nhận Điều khoản dịch vụ và Chính sách quyền riêng tư mới của chúng tôi.
Người nhận đang dùng phiên bản WhatsApp cũ; phải sử dụng phiên bản WhatsApp dưới đây trở lên:
- 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

Trong trường hợp sử dụng phương thức liên lạc khác ngoài WhatsApp, hãy yêu cầu người dùng WhatsApp:

Xác nhận rằng người dùng thực sự có thể gửi tin nhắn đến số điện thoại WhatsApp của doanh nghiệp bạn.
Xác nhận rằng người dùng đã chấp nhận Điều khoản dịch vụ mới nhất của chúng tôi (nếu chưa làm vậy, người dùng sẽ được nhắc chấp nhận điều khoản/chính sách mới nhất trong phần Cài đặt > Trợ giúp hoặc Cài đặt > Thông tin ứng dụng)
Cập nhật ứng dụng WhatsApp lên phiên bản mới nhất.

400

Yêu cầu không hợp lệ

131042

Vấn đề thanh toán liên quan đến tình trạng đủ điều kiện kinh doanh

Đã xảy ra lỗi liên quan đến phương thức thanh toán của bạn.

Xem bài viết Giới thiệu về cách lập hóa đơn cho Tài khoản WhatsApp Business và xác minh rằng bạn đã thiết lập chính xác thông tin lập hóa đơn.

Các sự cố thường gặp:

Tài khoản thanh toán không gắn liền với Tài khoản WhatsApp Business
Vượt quá hạn mức tín dụng
Hạn mức tín dụng (Tài khoản thanh toán) chưa được đặt hoặc không hoạt động
Tài khoản WhatsApp Business đã bị xóa
Tài khoản WhatsApp Business đã bị đình chỉ
Chưa đặt múi giờ
Chưa đặt đơn vị tiền tệ
Yêu cầu MessagingFor (Thay mặt) đang chờ xử lý hoặc đã bị từ chối
Đã vượt quá ngưỡng trò chuyện gói miễn phí mà không có phương thức thanh toán hợp lệ

400

Yêu cầu không hợp lệ

131045

Chứng chỉ không chính xác

Không gửi được tin nhắn do lỗi đăng ký số điện thoại.

Đăng ký số điện thoại trước khi thử lại.

500

Lỗi máy chủ nội bộ

131047

Tin nhắn tái thu hút

Đã quá 24 giờ kể từ lần gần đây nhất người nhận trả lời số điện thoại của người gửi.

Gửi cho người nhận một tin nhắn do doanh nghiệp bắt đầu bằng cách sử dụng mẫu tin nhắn.

400

Yêu cầu không hợp lệ

131049

Meta đã chọn không gửi tin nhắn.

Tin nhắn này không được gửi để duy trì hoạt động tương tác lành mạnh trong hệ sinh thái.

Không thử gửi lại ngay nếu bạn nhận được mã lỗi này và nghi ngờ là do giới hạn. Thay vào đó, hãy thử lại với khoảng thời gian tăng dần cho đến khi gửi được tin nhắn, vì giới hạn có thể có hiệu lực trong những khoảng thời gian khác nhau.

Hãy xem phần Giới hạn tin nhắn marketing mẫu cho mỗi người dùng để biết thêm thông tin.

400

Yêu cầu không hợp lệ

131051

Loại tin nhắn không được hỗ trợ

Loại tin nhắn không được hỗ trợ.

Xem bài viết Tin nhắn để biết các loại tin nhắn được hỗ trợ trước khi thử lại với loại tin nhắn được hỗ trợ.

400

Yêu cầu không hợp lệ

131052

Lỗi tải xuống file phương tiện

Không thể tải xuống file phương tiện do người dùng gửi.

Chúng tôi không thể tải xuống file phương tiện có trong tin nhắn của người dùng WhatsApp. Để biết thêm thông tin, hãy tham khảo giá trị error.error_data.details trong bất kỳ webhook tin nhắn nào được kích hoạt khi nhận được tin nhắn này.

Yêu cầu người dùng WhatsApp gửi cho bạn file phương tiện bằng phương thức khác ngoài WhatsApp.

400

Yêu cầu không hợp lệ

131053

Lỗi tải file phương tiện lên

Không thể tải lên file phương tiện được sử dụng trong tin nhắn.

Chúng tôi không thể tải file phương tiện lên vì một hoặc nhiều lý do, chẳng hạn như loại file phương tiện không được hỗ trợ.

Để biết thêm thông tin, hãy tham khảo giá trị error.error_data.details trong bất kỳ webhook tin nhắn nào được kích hoạt khi không gửi được tin nhắn này.

Bạn nên kiểm tra bất kỳ file phương tiện nào gây ra lỗi và xác nhận rằng trên thực tế, những file phương tiện đó được hỗ trợ. Ví dụ: trong UNIX, bạn có thể dùng lệnh kiểm tra file qua dòng lệnh để xác định loại MIME của file này:

file -I rejected-file.mov

Sau đó, bạn có thể xác nhận rằng loại MIME của file này được hỗ trợ. Hãy xem phần Loại file phương tiện được hỗ trợ.

400

Yêu cầu không hợp lệ

131057

Tài khoản đang ở chế độ bảo trì

Tài khoản kinh doanh đang ở chế độ bảo trì

Tài khoản WhatsApp Business đang ở chế độ bảo trì. Nguyên nhân có thể là do tài khoản đang trong quá trình nâng cấp thông lượng.

500

Yêu cầu không hợp lệ

132000

Số lượng thông số trong mẫu không khớp

Số lượng giá trị thông số biến có trong yêu cầu không khớp với số lượng thông số biến được xác định trong mẫu.

Xem Nguyên tắc tạo mẫu tin nhắn và đảm bảo rằng yêu cầu có chứa mọi giá trị thông số biến đã được xác định trong mẫu.

400

Yêu cầu không hợp lệ

132001

Mẫu không tồn tại

Mẫu không tồn tại ở ngôn ngữ đã chỉ định hoặc mẫu chưa được phê duyệt.

Đảm bảo mẫu của bạn đã được phê duyệt, cũng như tên và ngôn ngữ của mẫu chính xác. Vui lòng đảm bảo bạn tuân thủ nguyên tắc tạo mẫu tin nhắn.

404

Không tìm thấy

132005

Văn bản tái lập của mẫu quá dài

Bản dịch quá dài.

Kiểm tra Trình quản lý WhatsApp để xác minh rằng mẫu của bạn đã được dịch. Hãy xem phần Xếp hạng chất lượng và trạng thái mẫu.

400

Yêu cầu không hợp lệ

132007

Đã vi phạm chính sách ký tự định dạng trong mẫu

Nội dung mẫu vi phạm chính sách của WhatsApp.

Xem phần Lý do từ chối để xác định những lý do có thể đã dẫn đến trường hợp vi phạm.

400

Yêu cầu không hợp lệ

132012

Định dạng thông số trong mẫu không khớp

Các giá trị thông số biến được định dạng không chính xác.

Các giá trị thông số biến có trong yêu cầu không sử dụng định dạng được chỉ định trong mẫu. Hãy xem phần Nguyên tắc tạo mẫu tin nhắn.

400

Yêu cầu không hợp lệ

132015

Mẫu bị tạm dừng

Mẫu bị tạm dừng do có chất lượng thấp nên không thể gửi mẫu trong tin nhắn mẫu.

Chỉnh sửa mẫu để cải thiện chất lượng rồi thử lại sau khi mẫu được phê duyệt.

400

Yêu cầu không hợp lệ

132016

Mẫu bị vô hiệu hóa

Mẫu đã bị tạm dừng quá nhiều lần do có chất lượng thấp nên giờ bị vô hiệu hóa vĩnh viễn.

Tạo mẫu mới có nội dung khác.

400

Yêu cầu không hợp lệ

132068

Quy trình bị chặn

Quy trình ở trạng thái bị chặn.

Sửa quy trình

400

Yêu cầu không hợp lệ

132069

Quy trình bị giới hạn tốc độ

Quy trình ở trạng thái bị giới hạn tốc độ và 10 tin nhắn sử dụng quy trình này đã được gửi trong một giờ qua.

Sửa quy trình

400

Yêu cầu không hợp lệ

133000

Hủy đăng ký chưa hoàn tất

Lần hủy đăng ký trước đó không thành công.

Hủy đăng ký số điện thoại lần nữa trước khi đăng ký.

500

Lỗi máy chủ nội bộ

133004

Máy chủ tạm thời không khả dụng

Máy chủ tạm thời không khả dụng.

Truy cập trang Trạng thái Nền tảng WhatsApp Business để xem thông tin về trạng thái API và kiểm tra giá trị details của phần phản hồi trước khi thử lại.

503

Dịch vụ không khả dụng

133005

Mã PIN xác minh 2 bước không khớp

Mã PIN xác minh 2 bước không chính xác.

Xác minh rằng mã PIN xác minh 2 bước có trong yêu cầu là chính xác.

Cách đặt lại mã PIN xác minh 2 bước:

Tắt tính năng xác minh hai bước.
Gửi yêu cầu POST chứa mã PIN mới đến điểm cuối Số điện thoại.

400

Yêu cầu không hợp lệ

133006

Cần xác minh lại số điện thoại

Cần xác minh lại số điện thoại trước khi đăng ký.

Xác minh số điện thoại trước khi đăng ký.

400

Yêu cầu không hợp lệ

133008

Đoán mã PIN xác minh 2 bước quá nhiều lần

Đoán mã PIN xác minh 2 bước quá nhiều lần cho số điện thoại này.

Thử lại sau khoảng thời gian đã chỉ định trong giá trị phản hồi details.

400

Yêu cầu không hợp lệ

133009

Tốc độ đoán mã PIN xác minh 2 bước quá nhanh

Mã PIN xác minh 2 bước được nhập quá nhanh.

Kiểm tra giá trị phản hồi details trước khi thử lại.

400

Yêu cầu không hợp lệ

133010

Số điện thoại chưa được đăng ký

Số điện thoại chưa được đăng ký trên Nền tảng WhatsApp Business.

Đăng ký số điện thoại trước khi thử lại.

400

Yêu cầu không hợp lệ

133015

Vui lòng chờ vài phút rồi mới đăng ký số điện thoại này

Số điện thoại bạn đang đăng ký đã bị xóa gần đây và quá trình xóa vẫn chưa hoàn tất.

Chờ 5 phút rồi mới thử yêu cầu lại.

400

Yêu cầu không hợp lệ

135000

Lỗi người dùng chung

Không gửi được tin nhắn do một lỗi không xác định liên quan đến thông số yêu cầu của bạn.

Xem tài liệu tham khảo của điểm cuối để xác định liệu bạn có đang dùng cú pháp chính xác để truy vấn điểm cuối hay không. Hãy liên hệ với bộ phận hỗ trợ khách hàng nếu bạn tiếp tục nhận được mã lỗi này trong phản hồi.

400

Yêu cầu không hợp lệ