Chúng tôi sẽ ngừng cung cấp API Tại chỗ. Hãy tham khảo tài liệu về việc Ngừng cung cấp API Tại chỗ để biết chi tiết, đồng thời tìm hiểu cách chuyển sang API Đám mây thế hệ tiếp theo của chúng tôi.
Thông báo trạng thái và thông báo lỗi
Tài liệu này cung cấp thêm thông tin về các loại thông báo lỗi và thông báo trạng thái sau:
Để tìm hiểu cách khắc phục sự cố trong quy trình Đăng ký nhúng sẵn, hãy xem phần Lỗi xảy ra với quy trình Đăng ký nhúng sẵn.
Mã lỗi ứng dụng API WhatsApp Business
| Mã lỗi | Mô tả |
|---|---|
| Không tải được file phương tiện xuống từ người gửi. |
| Không gửi được tin nhắn vì đã xảy ra 1 hoặc nhiều lỗi liên quan đến phương thức thanh toán của bạn.
Hãy kiểm tra phần thiết lập thanh toán của bạn trong Trình quản lý WhatsApp rồi thử lại. |
| Không gửi được tin nhắn vì chờ xử lý quá lâu (tức là hơn 1 ngày). Lỗi này xảy ra khi ứng dụng API WhatsApp Business ngừng hoạt động trong hơn 1 ngày rồi khởi động lại. Hãy gửi lại tin nhắn. |
| Không gửi được tin nhắn trong Thời gian tin nhắn tồn tại (TTL). |
|
|
| Không gửi được tin nhắn vì đã xảy ra lỗi liên quan đến chứng chỉ của bạn. Hãy tải xuống chứng chỉ mới từ Trình quản lý WhatsApp rồi đăng ký lại. |
| Không gửi được tin nhắn vì đã xảy ra lỗi liên quan đến chứng chỉ của bạn. Hãy tải xuống chứng chỉ mới từ Trình quản lý WhatsApp rồi đăng ký lại. |
| Lỗi này xảy ra khi bạn gửi tin nhắn nhưng chứng chỉ của khách hàng doanh nghiệp lại được ký không đúng cách bằng khóa danh tính của khách hàng đó. Điều này có thể cho thấy rằng khách hàng đã đăng ký lại bằng khóa danh tính mới nhưng chưa thực hiện toàn bộ quy trình tạo chứng chỉ. |
| Không gửi được tin nhắn vì đã quá 24 giờ kể từ lần gần đây nhất khách hàng trả lời số điện thoại này. Hãy sử dụng mẫu tin nhắn để trả lời. |
| 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. Hãy kiểm tra trạng thái chất lượng của bạn trong Trình quản lý WhatsApp. 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. |
| Không gửi được tin nhắn vì số điện thoại của người dùng này đang được thử nghiệm. Hãy bỏ qua việc gửi tin nhắn cho người dùng này. |
| Không gửi được tin nhắn vì người dùng có số điện thoại này có khả năng đã thay đổi. |
| Không gửi được tin nhắn do một lỗi không xác định. Hãy thử lại sau. |
| Tin nhắn chứa tài liệu kèm theo chú thích hiện không được hỗ trợ. |
| |
| Độ dài của tin nhắn vượt quá 4.096 ký tự. |
| Loại người nhận hợp lệ:
|
| Yêu cầu tải file phương tiện lên có thể bị xung đột UUID hoặc file phương tiện có UUID đó đã tồn tại. |
|
|
| Không tìm thấy tài nguyên hoặc file |
| Người nhận không có tên trong danh sách cho phép |
| Thiếu một thông số bắt buộc. Nếu đang cố gửi Tin nhắn theo danh sách thì bạn có thể bị thiếu phần Nếu đang cố gửi Tin nhắn gồm một sản phẩm hoặc Tin nhắn gồm nhiều sản phẩm thì bạn có thể bị thiếu |
| Giá trị đã nhập cho thông số thuộc loại không phù hợp hoặc gặp vấn đề khác. Nếu bạn đang cố gửi Tin nhắn theo danh sách, hãy kiểm tra xem ID của mỗi hàng có phải là duy nhất hay không. Nếu đang cố gửi Tin nhắn gồm một sản phẩm thì bạn có thể đã gửi không đúng Nếu bạn đang cố gửi Tin nhắn gồm nhiều sản phẩm, hãy kiểm tra để đảm bảo |
| Chứa một thông số không bắt buộc. |
| |
| |
|
|
| Đã đạt giới hạn tốc độ ở phía máy khách |
| Nếu hệ thống đang chịu tải nặng, lỗi này sẽ được trả về để hệ thống có thể khôi phục khả năng tải. |
| Lỗi này xảy ra khi bạn gửi yêu cầu chỉ dành cho Master - chẳng hạn như thiết lập chế độ cài đặt, tải chế độ cài đặt, nhập, xuất, yêu cầu mã, đăng ký, v.v. - đến một nút không phải là Master chính. Lỗi này có thể xảy ra khi Ứng dụng API WhatsApp Business được thiết lập không đúng cách hoặc có lỗi nội bộ. Để khắc phục lỗi này, hãy thử gửi lại yêu cầu. Nếu vẫn không khắc phục được lỗi, hãy liên hệ với bộ phận hỗ trợ. |
| Lỗi này xảy ra khi bạn gửi yêu cầu đến một nút Coreapp không phải là chủ sở hữu đoạn hoặc chưa hoàn tất quá trình trở thành chủ sở hữu đoạn. Bạn có thể thấy lỗi này khi chúng tôi đang chuyển đổi đoạn trong quá trình thiết lập đa kết nối. Trong hầu hết trường hợp, việc thử gửi lại yêu cầu sẽ khắc phục được lỗi này. Nếu không, hãy liên hệ với Bộ phận hỗ trợ. |
| Lỗi này xảy ra khi bạn gửi tin nhắn cho chính mình. |
| Lỗi này xảy ra nếu bạn chưa đặt cấu hình định dạng Webhook API REST. |
| |
| Bạn cần phải đổi mật khẩu. |
| Yêu cầu không hợp lệ. |
| Không gửi được tin nhắn. Hãy xem Câu hỏi thường gặp "Tại sao tỷ lệ gửi của tôi không đạt 100%?". |
| Bạn đã gửi tin nhắn cho một người dùng WhatsApp có khả năng đã thay đổi. Thông báo hệ thống |
| Tài khoản của bạn đã bị khóa tính năng gửi tin nhắn do vi phạm chính sách về tính toàn vẹn. Hãy xem phần Thực thi chính sách Nền tảng WhatsApp Business để biết thông tin. |
| Số lượng thông số được cung cấp không khớp với số lượng thông số cần có. |
| Mẫu ở trạng thái không hoạt động hoặc mẫu không tồn tại cho một ngôn ngữ và địa điểm. |
| Người nhận không tải mẫu xuống được. |
| Không có mẫu nào tồn tại cho một ngôn ngữ và địa điểm cụ thể. |
| Thông số quá dài |
| Bản dịch quá dài |
| Đã vi phạm chính sách khoảng trắng |
| Đã vi phạm chính sách ký tự định dạng |
| Không hỗ trợ định dạng file phương tiện được sử dụng |
| Thiếu thành phần bắt buộc trong Mẫu |
| URL trong thành phần nút không hợp lệ |
| Số điện thoại trong thành phần nút không hợp lệ |
| Định dạng thông số không khớp với định dạng trong Mẫu đã tạo |
| Thiết bị nhận không hỗ trợ các nút |
| Lỗi này xảy ra khi gói ngôn ngữ của tin nhắn mẫu chưa được tải xuống. |
| Tin nhắn đang chờ chứa số phần thấp hơn giá trị tối thiểu hoặc cao hơn giá trị tối đa. Hãy xem đối tượng Bạn cần có ít nhất 1 đối tượng |
| Có số hàng không hợp lệ. Đối với Tin nhắn theo danh sách, phải có ít nhất 1 đối tượng |
| Đã vi phạm chính sách ký tự định dạng. |
| Đối tượng section (phần) không có sản phẩm hoặc tổng số sản phẩm đã vượt quá số lượng tối đa cho phép. |
| ID danh mục bạn đã cung cấp không tồn tại hoặc không thuộc về Tài khoản WhatsApp Business (WABA) của bạn. |
| ID danh mục bạn đã cung cấp không được kết nối với số điện thoại bạn đang dùng để gửi tin nhắn. |
| Không tìm thấy một số sản phẩm bạn đã nêu trong yêu cầu của mình trong danh mục. |
| Không tìm thấy sản phẩm trong danh mục bạn đã cung cấp. |
| Chỉ dành cho doanh nghiệp tại Ấn Độ. Lỗi này được trả về khi doanh nghiệp gửi Tin nhắn gồm một sản phẩm bị thiếu thông tin và thông tin không đầy đủ về việc tuân thủ quy định thương mại điện tử. |
| Chỉ dành cho doanh nghiệp tại Ấn Độ. Lỗi này được trả về khi doanh nghiệp gửi Tin nhắn gồm nhiều sản phẩm bị thiếu thông tin và thông tin không đầy đủ về việc tuân thủ quy định thương mại điện tử. |
| Chỉ dành cho doanh nghiệp tại Ấn Độ. Lỗi này được trả về khi doanh nghiệp gửi Tin nhắn gồm nhiều sản phẩm, trong đó có hỗn hợp các sản phẩm không hợp lệ và sản phẩm bị thiếu thông tin về việc tuân thủ. |
| Lỗi này được trả về khi cấu trúc đối tượng |
| Chỉ dành cho doanh nghiệp tại Ấn Độ. Lỗi này được trả về khi doanh nghiệp không cung cấp thông tin nào về việc tuân thủ. Hãy xem điểm cuối Sự tuân thủ của doanh nghiệp. |
| Không thể gửi mẫu do trạng thái mẫu là |
| Không thể gửi mẫu do trạng thái mẫu là |
| Không thể gửi mẫu do trạng thái mẫu là |
| Quy trình có ID đã chỉ định không tồn tại hoặc không thuộc Tài khoản WhatsApp Business (WABA) của bạn hay ở trạng thái không hợp lệ. |
| Quy trình ở trạng thái bị chặn. Hệ thống cũng có thể trả về lỗi này nếu quy trình sử dụng điểm cuối và quá trình thiết lập bắt buộc chưa hoàn tất. Ví dụ: khóa công khai chưa được tải lên hoặc không hợp lệ. Hãy xem bài viết Triển khai điểm cuối cho Flows. |
| 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. |
Để tìm hiểu các mã lỗi trên Công cụ quản lý thương mại dành riêng cho doanh nghiệp tại Ấn Độ, hãy xem Trung tâm trợ giúp doanh nghiệp.
Mã trạng thái HTTP
Dưới đây là những Mã trạng thái HTTP mà Ứng dụng API WhatsApp Business có thể dùng.
| Mã HTTP | Mô tả |
|---|---|
| Thành công |
| Thành công (OK) |
| Đã tạo thành công (Đối với yêu cầu POST) |
| Đã tìm thấy |
| Lỗi ứng dụng |
| Yêu cầu không hợp lệ |
| Trái phép |
| Bị cấm |
| Không tìm thấy |
| Phương thức không được phép. |
| Không thể đặt điều kiện trước |
| Tin nhắn bị giới hạn tốc độ |
| Quá nhiều yêu cầu |
| Lỗi máy chủ |
| Lỗi máy chủ nội bộ |
| Hết thời gian chờ |