Khắc phục sự cố và câu hỏi thường gặp
Hãy dùng trang này để nhanh chóng chẩn đoán và giải quyết sự cố trên các kênh nhắn tin WhatsApp, Instagram và Facebook. Bạn sẽ thấy danh sách đầy đủ các mã lỗi, ý nghĩa và hành động khuyến nghị, cùng phần Câu hỏi thường gặp giúp bạn xử lý các vấn đề phổ biến và tối ưu thiết lập nhắn tin.
Câu hỏi thường gặp
Tôi có thể kết nối những kênh liên lạc nào với MonoChat?
MonoChat hỗ trợ nhiều kênh liên lạc, gồm WhatsApp, Instagram, Facebook Messenger, Telegram, live chat và các kênh SIP. Nhờ vậy bạn có thể quản lý mọi cuộc trò chuyện từ một hộp thư hợp nhất.
Tôi có thể bắt đầu nhanh đến mức nào?
Bạn có thể bắt đầu chỉ trong vài phút. Chỉ cần đăng ký, kết nối các kênh bạn muốn, mời nhóm của bạn và tạo quy trình làm việc bằng quy trình thiết lập trực quan của MonoChat. Không cần quá trình làm quen dài dòng.
Tôi có cần kiến thức kỹ thuật để tạo trợ lý AI của mình không?
Không, bạn không cần bất kỳ kiến thức kỹ thuật nào. MonoChat cung cấp giao diện đơn giản, thân thiện giúp bạn tạo và tùy chỉnh trợ lý AI chỉ trong vài phút—không cần viết code. Bạn có thể dễ dàng điều chỉnh tính cách, giọng điệu và nhiệm vụ của trợ lý thông qua các thiết lập trực quan. Mọi thứ được thiết kế để bạn tập trung vào việc trợ lý nên làm gì, còn MonoChat lo phần kỹ thuật cho bạn.
Dữ liệu của tôi có an toàn với MonoChat không?
Có, MonoChat coi trọng bảo mật dữ liệu. Mọi dữ liệu đều được mã hóa cả khi truyền tải và khi lưu trữ. Chúng tôi tuân theo các thông lệ bảo mật tiêu chuẩn ngành để đảm bảo thông tin của bạn được bảo vệ.
Việc thanh toán diễn ra như thế nào?
Thanh toán đơn giản và linh hoạt. Bạn có thể chọn gói đăng ký theo tháng hoặc theo năm, và có thể thêm các gói bổ sung nếu cần. Bạn sẽ được xuất hóa đơn theo gói đã chọn và mức sử dụng của mình.
Các bạn chấp nhận những phương thức thanh toán nào?
Bạn có thể dễ dàng thanh toán trực tiếp trên nền tảng MonoChat bằng thẻ tín dụng hoặc thẻ ghi nợ. Mọi tùy chọn thanh toán đều có trong phần thanh toán của tài khoản, giúp bạn dễ dàng quản lý và cập nhật phương thức thanh toán.
Tôi có thể thay đổi hoặc hủy gói đăng ký không?
Có, bạn có thể nâng cấp, hạ cấp hoặc hủy gói đăng ký bất cứ lúc nào trực tiếp từ tài khoản của mình. Các thay đổi có hiệu lực ngay lập tức hoặc vào chu kỳ thanh toán tiếp theo, tùy theo gói của bạn.
Có bản dùng thử miễn phí không?
Có, MonoChat cung cấp bản dùng thử miễn phí để bạn khám phá nền tảng trước khi cam kết dùng gói trả phí. Bản dùng thử gồm 1 kênh, 1 người dùng và tối đa 1.000 tin nhắn.
Tôi có thể nhờ trợ giúp ở đâu nếu gặp sự cố hoặc cần hỗ trợ thiết lập hay tích hợp?
MonoChat cung cấp nhiều gói hỗ trợ phù hợp với nhu cầu của bạn, và kênh hỗ trợ WhatsApp của chúng tôi dành cho tất cả người dùng. Dù bạn cần hướng dẫn khi thiết lập, trợ giúp về tích hợp hay khắc phục sự cố, đội ngũ của chúng tôi luôn sẵn sàng hỗ trợ bạn.
Trợ lý của tôi không trả lời sau khi cài đặt một ứng dụng. Vì sao?
Các ứng dụng trả lời khách hàng được cài đặt với luồng bot ở trạng thái tắt, để một trợ lý chưa được thiết lập không bao giờ trò chuyện với khách hàng của bạn. Hãy hoàn tất các bước thiết lập của ứng dụng (trên bảng Bắt đầu hoặc màn hình riêng của ứng dụng), rồi bật trợ lý từ màn hình của ứng dụng hoặc bằng cách kích hoạt luồng của nó trong Cài đặt › Tự động hóa › Luồng. Việc cập nhật ứng dụng sau này vẫn giữ nguyên trạng thái bật/tắt bạn đã chọn. Xem MonoStore.
Tôi không đổi được phiếu giảm giá.
Thông báo lỗi cho bạn biết lý do. Một phiếu giảm giá chỉ dùng được một lần, có thể hết hạn và có thể giới hạn cho một số không gian làm việc nhất định: ví dụ chỉ các không gian làm việc được tạo trong vài ngày gần đây, chỉ các không gian làm việc đã nạp một số tiền tối thiểu trong những tháng gần đây, hoặc chỉ các không gian làm việc gần đây chưa dùng phiếu giảm giá khác. Khi một điều kiện chưa được đáp ứng, phiếu giảm giá không bị dùng hết, nên bạn có thể thử lại khi đủ điều kiện. Bạn cũng cần có quyền thanh toán trong không gian làm việc. Xem Phiếu giảm giá.
Các cuộc trò chuyện WhatsApp cũ của tôi ở đâu?
Khi bạn kết nối một kênh, các tin nhắn trước đây của kênh đó sẽ đến dưới dạng các phiên lịch sử. Chúng được giữ ngoài danh sách cuộc trò chuyện để lượng lớn tin nhắn cũ không chôn vùi tin nhắn mới. Khi có phiên lịch sử, một thanh màu xám ở đầu danh sách hiển thị You have history sessions. Nhấp Hiện và xác nhận để lọc danh sách theo các phiên đó; dấu thập sẽ ẩn thanh này cho đến khi bạn tải lại trang.
Giao diện đang hiển thị sai ngôn ngữ.
MonoChat khởi động theo ngôn ngữ của trình duyệt của bạn. Để thay đổi, hãy mở nút tài khoản ở cuối thanh điều hướng, chọn một ngôn ngữ trong Ngôn ngữ mặc định và lưu; trên trang đăng nhập, hãy dùng bộ chọn ngôn ngữ ở cuối trang. Lựa chọn được ghi nhớ theo từng trình duyệt. Các email về không gian làm việc (thanh toán, tóm tắt hằng tuần) dùng ngôn ngữ mặc định của không gian làm việc, được đặt trong Cài đặt › CRM › Ngôn ngữ. Xem Ngôn ngữ giao diện.
Vì sao tôi được yêu cầu thanh toán ít hơn giá của gói khi thanh toán?
Khi bạn đổi gói hoặc mua một gói bổ sung mà số dư không đủ chi trả, MonoChat chỉ tính phần chênh lệch giữa giá và số dư của bạn. Nếu số dư âm, khoản bạn nợ sẽ được cộng thêm. Nếu số dư đủ chi trả giá, sẽ không mở bước thanh toán nào cả. Xem Thanh toán trực tiếp cho gói hoặc gói bổ sung.
Bảng Bắt đầu đã đi đâu?
Tab Bắt đầu vẫn nằm trong thanh điều hướng, kèm số bước còn mở, cho đến khi mọi bước hoàn tất; sau đó nó tự biến mất. Ẩn phần này chỉ ngăn bảng tự động mở ra. Để xem lại chuyến tham quan thanh điều hướng, hãy mở Bắt đầu và nhấp Hướng dẫn cho tôi. Xem Bảng Bắt đầu.
Mã lỗi – WhatsApp, Instagram, Facebook
Dưới đây là các mã lỗi thường gặp nhất trên từng kênh nhắn tin, kèm giải thích và hành động khuyến nghị.
Mã lỗi WhatsApp (Cloud API)
Các mã lỗi này do WhatsApp Business API trả về. Hãy dùng danh sách này để xác định các sự cố gửi tin, vấn đề cấu hình, giới hạn tốc độ hoặc lỗi liên quan đến quyền ảnh hưởng đến việc nhắn tin WhatsApp của bạn.
| Mã lỗi | Chi tiết | Nguyên nhân có thể và giải pháp |
|---|---|---|
| 368 - Tạm thời bị chặn do vi phạm chính sách | Xem tài liệu Policy Enforcement để tìm hiểu về các vi phạm chính sách và cách giải quyết. Bị hạn chế hoặc vô hiệu hóa do vi phạm chính sách nền tảng. | Kiểm tra định dạng payload và các trường bắt buộc. |
| 130497 - Tài khoản doanh nghiệp 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 WhatsApp Business Messaging Policy để biết chi tiết về các quốc gia được phép nhắn tin đối với danh mục doanh nghiệp của bạn. |
| 2388019 - Vượt quá giới hạn mẫu tin nhắn | Bạn đã vượt quá số lượng mẫu tin nhắn tối đa có thể có cho tài khoản WhatsApp Business này. | Một tài khoản WhatsApp Business có thể có tối đa 250 mẫu tin nhắn. Xem Template limits. |
| 1 - API không xác định | Yêu cầu không hợp lệ hoặc có thể là lỗi máy chủ. | Kiểm tra trang WhatsApp Business Platform Status để xem thông tin trạng thái API. Nếu không có sự cố máy chủ, hãy kiểm tra tài liệu tham chiếu endpoint và xác minh rằng yêu cầu của bạn có định dạng đúng và đáp ứng mọi yêu cầu của endpoint. |
| 2 - Dịch vụ API | Tạm thời do ngừng hoạt động hoặc do quá tải. | Kiểm tra trang WhatsApp Business Platform Status để xem thông tin trạng thái API trước khi thử lại. |
| 33 - Giá trị tham số không hợp lệ | Số điện thoại doanh nghiệp đã bị xóa. | Xác minh rằng số điện thoại doanh nghiệp là chính xác. |
| 100 - Tham số không hợp lệ | Yêu cầu có một hoặc nhiều tham số không được hỗ trợ hoặc bị viết sai chính tả. | Xem tài liệu tham chiếu của endpoint để biết những tham số nào được hỗ trợ và cách viết đúng. |
| 130472 - Số của người dùng thuộc một thử nghiệm | Tin nhắn không được gửi vì thuộc một thử nghiệm. | Xem Marketing Message Experiment. |
| 131000 - Đã xảy ra lỗi | Gửi tin nhắn thất bại do lỗi không xác định. | Hãy thử lại. Nếu lỗi vẫn tiếp diễn, hãy mở một phiếu Direct Support. |
| 131005 - Truy cập bị từ chối | Quyền chưa được cấp hoặc đã bị gỡ bỏ. | Dùng công cụ gỡ lỗi access token để xác minh rằng ứng dụng của bạn đã được cấp các quyền mà endpoint yêu cầu. Xem Authentication and authorization errors. |
| 131008 - Thiếu tham số bắt buộc | Yêu cầu thiếu một tham số bắt buộc. | Xem tài liệu tham chiếu của endpoint để biết những tham số nào là bắt buộc. |
| 131009 - Giá trị tham số không hợp lệ | Một hoặc nhiều giá trị tham số không hợp lệ. | Xem tài liệu tham chiếu của endpoint để biết những giá trị nào được hỗ trợ cho từng tham số, và xem Phone Numbers để biết cách thêm số điện thoại vào tài khoản WhatsApp Business. |
| 131016 - Dịch vụ không khả dụng | Một dịch vụ tạm thời không khả dụng. | Kiểm tra trang WhatsApp Business Platform Status để xem thông tin trạng thái API trước khi thử lại. |
| 131021 - Người nhận không thể là người gửi | Số điện thoại của người gửi và người nhận giống nhau. | Hãy gửi tin nhắn đến một số điện thoại khác với số của người gửi. |
| 131026 - Không thể gửi tin nhắn | Không thể gửi tin nhắn. Các nguyên nhân có thể gồm: Số điện thoại người nhận không phải là số WhatsApp. 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 dùng phiên bản WhatsApp cũ; phải dùng phiên bản WhatsApp sau đây hoặc mới hơ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 | Bằng một phương thức liên lạc không phải WhatsApp, hãy yêu cầu người dùng WhatsApp: Xác nhận rằng họ thực sự có thể gửi tin nhắn đến số điện thoại WhatsApp doanh nghiệp của bạn. Xác nhận rằng họ đã chấp nhận Điều khoản dịch vụ mới nhất của chúng tôi (Settings > Help, hoặc Settings > Application information sẽ nhắc họ chấp nhận các điều khoản/chính sách mới nhất nếu họ chưa làm). Cập nhật lên phiên bản mới nhất của ứng dụng WhatsApp. |
| 131037 - Số do WhatsApp cung cấp cần được duyệt tên hiển thị trước khi có thể gửi tin nhắn. | Số điện thoại doanh nghiệp 555 dùng để gửi yêu cầu chưa có tên hiển thị được duyệt. | Hãy đổi tên hiển thị của số điện thoại doanh nghiệp 555. Xem thêm bài viết Trung tâm trợ giúp How to change your WhatsApp Business display name. |
| 131042 - Sự cố thanh toán về điều kiện đủ của doanh nghiệp | Đã xảy ra lỗi liên quan đến phương thức thanh toán của bạn. | Xem About Billing For Your WhatsApp Business Account và xác minh rằng bạn đã thiết lập thanh toán đúng cách. Các vấn đề thường gặp: Tài khoản thanh toán chưa được gắn với tài khoản WhatsApp Business / Hạn mức tín dụng vượt giới hạn / Hạn mức tín dụng (Tài khoản thanh toán) chưa được đặt hoặc chưa 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 (On Behalf Of) đang chờ xử lý hoặc bị từ chối |
| 131045 - Chứng chỉ không đúng | Gửi tin nhắn thất bại do lỗi đăng ký số điện thoại. | Hãy đăng ký số điện thoại trước khi thử lại. |
| 131047 - Tin nhắn tương tác lại | Đã hơn 24 giờ kể từ lần cuối người nhận trả lời số của người gửi. | Hãy gửi cho người nhận một tin nhắn mẫu thay thế. |
| 131049 - Meta chọn không gửi. | Tin nhắn này không được gửi để duy trì mức tương tác lành mạnh của hệ sinh thái. | Nếu bạn nhận được mã lỗi này và nghi ngờ nguyên nhân là do giới hạn, hãy chờ ít nhất 24 giờ trước khi gửi lại tin nhắn mẫu. Làm vậy chỉ dẫn đến một phản hồi lỗi khác vì giới hạn có thể có hiệu lực trong các khoảng thời gian khác nhau. |
| 131050 - Người dùng đã ngừng nhận tin nhắn tiếp thị. | Không thể gửi tin nhắn. Người nhận này đã chọn ngừng nhận tin nhắn tiếp thị trên WhatsApp từ doanh nghiệp của bạn. | Không thử gửi lại tin nhắn cho người dùng này vì họ sẽ không nhận được. Để được thông báo mỗi khi người dùng WhatsApp ngừng hoặc tiếp tục nhận các tin nhắn mẫu tiếp thị từ doanh nghiệp của bạn, hãy đăng ký webhook user_preferences. |
| 131051 - Loại tin nhắn không được hỗ trợ | Loại tin nhắn không được hỗ trợ. | Xem Messages để biết các loại tin nhắn được hỗ trợ trước khi thử lại với một loại tin nhắn được hỗ trợ. |
| 131052 - Lỗi tải phương tiện | Không thể tải phương tiện do người dùng gửi. | Chúng tôi không thể tải 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 xem giá trị error.error_data.details trong mọi webhook tin nhắn được kích hoạt khi tin nhắn này được nhận. Hãy yêu cầu người dùng WhatsApp gửi tệp phương tiện cho bạn bằng một phương thức không phải WhatsApp. |
| 131057 - Tài khoản ở chế độ bảo trì | Tài khoản doanh nghiệp đang ở chế độ bảo trì | Tài khoản WhatsApp Business đang ở chế độ bảo trì. Một nguyên nhân có thể là tài khoản đang được nâng cấp thông lượng. |
| 132000 - Số lượng tham số mẫu không khớp | Số giá trị tham số biến trong yêu cầu không khớp với số tham số biến được xác định trong mẫu. | Xem tài liệu Templates để tìm hiểu về tham số và đảm bảo yêu cầu có giá trị cho tất cả tham số mà mẫu yêu cầu. |
| 132001 - Mẫu không tồn tại | Mẫu không tồn tại trong 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, và tên mẫu cùng mã ngôn ngữ là chính xác. Xem tài liệu Templates để tìm hiểu thêm về mẫu. |
| 132005 - Văn bản mẫu sau khi điền quá dài | Văn bản đã dịch quá dài. | Kiểm tra WhatsApp Manager để xác minh rằng mẫu của bạn đã được dịch. Xem tài liệu Template quality để biết cách kiểm tra trạng thái mẫu của bạn. |
| 132007 - Vi phạm chính sách ký tự định dạng của mẫu | Nội dung mẫu vi phạm chính sách của WhatsApp. | Xem tài liệu Template review để biết các lý do có thể gây ra vi phạm. |
| 132012 - Định dạng tham số mẫu không khớp | Giá trị tham số biến được định dạng không đúng. | Các giá trị tham số biến trong yêu cầu không dùng định dạng được chỉ định trong mẫu. Xem tài liệu Templates để tìm hiểu thêm về tham số và định dạng của mẫu. |
| 132015 - Mẫu bị tạm dừng | Mẫu bị tạm dừng do chất lượng thấp nên không thể gửi trong tin nhắn mẫu. | Chỉnh sửa mẫu để cải thiện chất lượng và thử lại sau khi mẫu được phê duyệt. |
| 132016 - Mẫu bị vô hiệu hóa | Mẫu đã bị tạm dừng quá nhiều lần do chất lượng thấp và nay bị vô hiệu hóa vĩnh viễn. | Hãy tạo một mẫu mới với nội dung khác. |
| 132068 - Flow bị chặn | Flow đang ở trạng thái bị chặn. | Hãy sửa Flow |
| 132069 - Flow bị giới hạn tốc độ | Flow đang ở trạng thái bị giới hạn tốc độ và đã có 10 tin nhắn dùng flow này được gửi trong giờ qua. | Hãy sửa Flow |
| 133000 - Hủy đăng ký chưa hoàn tất | Lần hủy đăng ký trước đó đã thất bại. | Hãy hủy đăng ký số này lần nữa trước khi đăng ký. |
| 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. | Kiểm tra trang WhatsApp Business Platform Status để xem thông tin trạng thái API và kiểm tra giá trị chi tiết của phản hồi trước khi thử lại. |
| 133005 - PIN xác minh hai bước không khớp | PIN xác minh hai bước không đúng. | Xác minh rằng PIN xác minh hai bước trong yêu cầu là chính xác. Để đặt lại PIN, hãy tắt xác minh hai bước, rồi đặt PIN mới. Xem Two-step verification. |
| 133006 - Cần xác minh lại số điện thoại | Số điện thoại cần được xác minh trước khi đăng ký. | Hãy xác minh và đăng ký số điện thoại. |
| 133010 - Số điện thoại chưa được đăng ký | Số điện thoại chưa được đăng ký trên WhatsApp Business Platform. | Hãy đăng ký số điện thoại trước khi thử lại. |
| 135000 - Lỗi người dùng chung | Gửi tin nhắn thất bại do lỗi không xác định với các tham số yêu cầu của bạn. | Xem tài liệu tham chiếu của endpoint để xác định bạn có đang truy vấn endpoint với đúng cú pháp hay không. Hãy liên hệ bộ phận hỗ trợ khách hàng nếu bạn tiếp tục nhận mã lỗi này trong phản hồi. |
Mã lỗi Instagram Messaging API
Các lỗi này bắt nguồn từ Messenger Platform. Chúng giúp chẩn đoán các sự cố liên quan đến quyền của người dùng, cài đặt trang, hạn chế của API, giới hạn tốc độ và hạn chế gửi tin nhắn.
| Mã lỗi | Thông báo cho người dùng | Giải pháp khuyến nghị |
|---|---|---|
| 2207003 | Tải phương tiện mất quá nhiều thời gian. | Đã xảy ra hết thời gian chờ khi tải phương tiện. Hãy thử lại. |
| 2207020 | Phương tiện bạn đang cố truy cập đã hết hạn. Vui lòng thử tải lên lại. | Tạo một container ID mới và dùng nó để thử lại. |
| 2207001 | Lỗi máy chủ Instagram. Hãy thử lại. | Lỗi máy chủ Instagram. Hãy thử lại. |
| 2207032 | Tạo phương tiện thất bại, vui lòng thử tạo lại phương tiện | Không tạo được container phương tiện. Hãy thử lại. |
| 2207053 | lỗi tải lên không xác định | Đã xảy ra lỗi không xác định trong quá trình tải lên. Hãy tạo một container mới và dùng nó để thử lại. Lỗi này chỉ nên ảnh hưởng đến việc tải lên video. |
| 2207057 | Độ lệch ảnh thu nhỏ phải lớn hơn hoặc bằng 0 và nhỏ hơn thời lượng video, tức là {video-length} | Độ lệch ảnh thu nhỏ nằm ngoài phạm vi. Hãy nhập độ lệch hợp lệ tính bằng mili giây. |
| 2207051 | Chúng tôi hạn chế một số hoạt động để bảo vệ cộng đồng. Hãy cho chúng tôi biết nếu bạn cho rằng chúng tôi đã nhầm. | Hành động đăng bị nghi ngờ là spam. Hãy gửi phản hồi nếu nhận định sai và giảm các hành động lặp lại. |
| 2207042 | Bạn đã đạt số bài đăng tối đa được phép đăng bởi Content Publishing API. | Đã đạt giới hạn đăng hằng ngày. Hãy thử lại vào ngày mai. |
| 2207006 | Không tìm thấy phương tiện có {media-id} | Có thể thiếu quyền hoặc token đã hết hạn. Hãy tạo một container mới và thử lại. |
| 2207008 | Trình tạo phương tiện có creation id = {creation-id} không tồn tại hoặc đã hết hạn. | Lỗi tạm thời. Hãy thử lại trong 30–120 giây. Nếu vẫn thất bại, hãy tạo một container mới. |
| 2207050 | Tài khoản Instagram bị hạn chế. | Tài khoản Instagram Professional không hoạt động hoặc bị hạn chế. Hãy đăng nhập Instagram và hoàn tất các hành động được yêu cầu. |
| 2207023 | Loại phương tiện {media-type} không xác định. | Loại phương tiện không hợp lệ. Hãy dùng một loại phương tiện được hỗ trợ. |
| 2207028 | Bài đăng của bạn không dùng được dưới dạng carousel. Carousel cần ít nhất 2 ảnh/video và tối đa 10 ảnh/video. | Điều chỉnh số mục thành 2–10 ảnh/video. |
| 2207035 | Không nên chỉ định vị trí thẻ sản phẩm cho phương tiện video. | Video không hỗ trợ tọa độ X/Y. Hãy bỏ tọa độ. |
| 2207036 | Phương tiện ảnh yêu cầu vị trí thẻ sản phẩm. | Thẻ trên ảnh yêu cầu tọa độ X/Y. Hãy thêm chúng. |
| 2207037 | Chúng tôi không thể thêm tất cả thẻ sản phẩm của bạn. Product ID có thể không đúng, đã bị xóa hoặc thiếu quyền. | Làm mới danh mục và chỉ dùng các product ID đủ điều kiện. |
| 2207040 | Không thể dùng hơn {max-tag-count} thẻ cho mỗi phương tiện được tạo. | Cho phép tối đa 20 thẻ. Hãy giảm số thẻ. |
| 2207026 | Định dạng video không được hỗ trợ. Vui lòng kiểm tra thông số về định dạng {video} được hỗ trợ. | Định dạng không được hỗ trợ. Hãy dùng MP4 hoặc MOV. |
| 2207052 | Không thể tải phương tiện từ uri này: {uri} | URI không hợp lệ hoặc không truy cập được. Hãy đảm bảo nó công khai và truy cập được. |
| 2207027 | Phương tiện chưa sẵn sàng để đăng, vui lòng chờ một lát | Chỉ đăng khi trạng thái container là FINISHED. |
| 2207004 | Ảnh quá lớn để tải xuống. Ảnh phải nhỏ hơn {size}. | Cho phép tối đa 8MiB. Hãy tải lên ảnh nhỏ hơn. |
| 2207005 | Định dạng ảnh {current-image-format} không được hỗ trợ. Các định dạng được hỗ trợ là: {format}. | Định dạng ảnh không được hỗ trợ hoặc token đã hết hạn. Hãy tạo lại container. |
| 2207009 | Không thể đăng ảnh đã gửi có tỷ lệ khung hình {submitted-ratio}. Vui lòng gửi ảnh có tỷ lệ khung hình hợp lệ. | Phải nằm trong khoảng 4:5 đến 1.91:1. Hãy tải lên với tỷ lệ hợp lệ. |
| 2207010 | Chú thích của ảnh đã gửi dài {submitted-caption-length} ký tự. Tối đa là {maximum-caption-length}. | Tối đa: 2200 ký tự, 30 hashtag, 20 @tag. Hãy dùng chú thích ngắn hơn. |
Mã lỗi Facebook Messenger
Các mã này dành riêng cho Instagram Messaging API. Hãy tham khảo danh sách này để hiểu các sự cố liên quan đến liên kết tài khoản, quyền của người dùng, loại tin nhắn và các quy tắc riêng của nền tảng Instagram.
| Mã lỗi | Mô tả | Chi tiết / Nguyên nhân có thể |
|---|---|---|
| 1 – 99 | Đã xảy ra lỗi không xác định | Thiếu quyền, ứng dụng có thể cần Advanced Access, Business Verification hoặc các quyền bổ sung |
| 1 – 1357046 | Phản hồi JSON không hợp lệ | Chậm trễ hệ thống hoặc phản hồi lô tin nhắn bị sai định dạng |
| 2 | Lỗi không mong muốn, hãy thử lại sau | Nền tảng Meta gặp sự cố hoặc khách hàng đã chặn doanh nghiệp của bạn |
| 2 – 2018344 | Dịch vụ tạm thời không khả dụng | Quản trị viên trang phải chấp nhận Privacy ToS cho inbox label API |
| 4 | Đạt giới hạn tốc độ | Quá nhiều yêu cầu; hãy tạm dừng gửi |
| 4 – 2018354 | Tần suất tin nhắn tiếp thị quá cao | Không tuân thủ khoảng trễ tối thiểu giữa hai thông báo |
| 9 – 2018352 | Người dùng thực hiện quá nhiều hành động | Vượt quá giới hạn opt-in Marketing Message |
| 10 | Không có quyền cho hành động này | User Profile API không khả dụng cho Instant Games |
| 10 – 1404170 | Ứng dụng thiếu quyền | Trang tạm thời bị hạn chế đối với opt-in Marketing Message |
| 10 – 1893015 | Người dùng đã ngừng nhận tin nhắn thông báo | Người dùng đã nhấp “Stop these messages” |
| 10 – 2018336 | Ảnh hưởng đến luồng của người dùng | Luồng bị ảnh hưởng; hãy kiểm tra User Level Menu API |
| 10 – 2534022 | Tin nhắn ngoài khung thời gian cho phép | Phải nhắn trong khung 24 giờ |
| 10 – 2534077 | Sự cố kết nối IG–FB | IG + Page chưa được liên kết hoặc thiếu 2FA |
| 10 – 2018278 | Tin nhắn ngoài khung thời gian cho phép | Tham khảo chính sách Meta đã cập nhật |
| 10 – 2018065 | Ngoài khung thời gian cho phép; cần quyền News Messaging | Cần được phê duyệt News Messaging |
| 10 – 2018108 | Người này không thể nhận tin nhắn | Người dùng không nhận tin nhắn từ doanh nghiệp |
| 100 | Tham số không hợp lệ | FBID không hợp lệ, notification token không hợp lệ/đã hết hạn |
| 100 – 33 | Yêu cầu GET không được hỗ trợ | Thiếu quyền, đối tượng không tồn tại |
| 100 – 2018001 | Không tìm thấy người dùng phù hợp | Mã định danh người dùng không hợp lệ hoặc bị thiếu |
| 100 – 2018008 | Không tải được tệp | URL, SSL, kích thước không hợp lệ hoặc hết thời gian chờ |
| 100 – 2018014 | Không thể gửi cả tin nhắn và trạng thái | Hãy bỏ một trong các trường xung đột |
| 100 – 2018047 | Tải lên tệp đính kèm thất bại | Loại phương tiện không khớp |
| 100 – 2018074 | Tệp đính kèm không hợp lệ/không được phép | Tệp đính kèm không thuộc quyền sở hữu hoặc không hợp lệ |
| 100 – 2018109 | Kích thước tệp đính kèm quá lớn | Hãy giảm kích thước tệp |
| 100 – 2018164 | App ID không đúng | App ID không hợp lệ |
| 100 – 2018294 | Tải video lên hết thời gian chờ hoặc bị hỏng | Không thể tải trong vòng 75 giây |
| 100 – 2018320 | Product ID không hợp lệ | Sản phẩm không tồn tại hoặc không có quyền |
| 100 – 2018328 | Mẫu sản phẩm không được hỗ trợ | Phải dùng API phiên bản 8+ |
| 100 – 2534013 | Page chưa được liên kết với IG | Hãy liên kết Trang FB với tài khoản IG Professional |
| 100 – 2534014 | Không có người dùng IG phù hợp | Instagram-scoped ID không hợp lệ |
| 100 – 2534015 | Dữ liệu tin nhắn không hợp lệ | Nội dung không được phép cho loại tin nhắn này |
| 100 – 2534025 | Bình luận không hợp lệ cho phản hồi riêng tư | Dữ liệu không được phép cho phản hồi riêng tư |
| 100 – 2534029 | Doanh nghiệp bị chặn khỏi IG Messaging API | Phải giải quyết các vi phạm chính sách |
| 100 – 2534037 | Không phải chủ luồng | Thiếu quyền đối với cuộc trò chuyện |
| 190 | OAuth access token không hợp lệ | Token đã hết hạn hoặc không hợp lệ |
| 200 | Lỗi quyền | Yêu cầu quyền pages_messaging |
| 200 – 1545041 | Người này không có mặt | Người dùng hiện không khả dụng |
| 200 – 2018021 | Cần phí phone-matching | Yêu cầu phí truy cập phone matching |
| 200 – 2018027 | Nhắn tin bị hạn chế | Thiếu quyền pages_messaging_phone_number |
| 200 – 2018028 | Nhắn tin bị hạn chế | Thiếu quyền pages_messaging |
| 200 – 2534041 | Tin nhắn trực tiếp IG bị tắt | Chủ sở hữu đã tắt quyền truy cập API |
| 551 | Người dùng đã chặn doanh nghiệp của bạn | Người dùng sẽ không nhận được tin nhắn |
| 551 – 1545041 | Người dùng không khả dụng | Giống như trên |
| 613 – 1893016 | Yêu cầu opt-in bị trùng lặp | Nhiều yêu cầu opt-in về cùng một chủ đề |
| 613 – 2018338 | Cảnh báo: hành vi lạm dụng | Hãy giảm tốc độ gửi tin nhắn |
| 613 – 2534040 | Vượt quá giới hạn tốc độ | Hãy tạm dừng các lệnh gọi API |
| 2022 | Nhắn tin thương mại bị tắt | Do vi phạm chính sách |
| 10303 | Account linking token không hợp lệ | Token không đúng hoặc đã hết hạn |
| 24001 | Người dùng đã hủy luồng thanh toán | Thanh toán đã bị hủy |
| 24002 | Thiếu URL quyền riêng tư | Hãy cung cấp URL quyền riêng tư cho thanh toán |
| 24005 | Không lấy được ID người dùng | Sự cố nhận dạng người dùng |
| 36103 | Tài khoản IG không đủ điều kiện dùng API | Thuộc đợt triển khai theo giai đoạn |
| 2018144 | Giới hạn Instant Game | Chỉ 5 thông báo trong 10 ngày |
| 2018154 | Lỗi Messenger Extensions | Lỗi SDK không mong muốn |
| 2018163 | Lỗi xác thực tham số chia sẻ | Tham số chia sẻ không hợp lệ |
| 2018166 | Quyền SDK không hợp lệ | Thiếu quyền |
| 2018171 | Chỉ dành cho bên nhận chính/phụ | Quyền truy cập bị hạn chế |
| 2018218 | Không có hồ sơ | Người dùng được tạo qua số điện thoại |
| 2018234 | Khả năng hiển thị bị từ chối | Cô lập bên nhận phụ |
| 2018247 | Không đủ quyền hồ sơ | Thiếu quyền User Profile |
| 2018300 | Ứng dụng khác đang kiểm soát luồng | Sự kiện hand-off đang hoạt động |
| 2018321 | Luồng Hỏi & Đáp tự động đang hoạt động | Hãy chờ đến khi luồng kết thúc |
| 2071010 | Phương thức SDK không được hỗ trợ | Hãy cập nhật Messenger client |
| 2071011 | Messenger Extensions bị tắt | Tên miền chưa được cho phép hoặc client đã lỗi thời |
| 2071014–1025 | Các trường nội dung tin nhắn không hợp lệ | Tiêu đề, URL, tệp đính kèm, mẫu không hợp lệ |
| 9000001 | Tin nhắn đã bị xóa | Không thể truy xuất nội dung đã xóa |
| OAuthException | Sự cố xác thực | Lỗi OAuth chung |
| 2018389 | Page chưa được thêm vào danh sách cho phép | Page phải được thêm vào danh sách cho phép |
| 2018390 | Call ID không hợp lệ | Call ID không khớp |
| 2018391 | Tham số kết nối không hợp lệ | Không được để trống |
| 2018392 | Tham số SDP không hợp lệ | Phải tuân theo đặc tả JSON dict |
| 2018393 | Người tham gia cuộc gọi không hợp lệ | Page không thuộc cuộc gọi |
| 2018394 | Không đủ quyền để tham gia cuộc gọi | Page thiếu quyền |
| 2018395 | Không thể tham gia cuộc gọi thất bại | Hãy chờ callback |
| 2018396 | Không thể tham gia cuộc gọi đã kết thúc | Cuộc gọi đã kết thúc |
| TBD | Vượt quá giới hạn tốc độ cuộc gọi | Hãy giảm tần suất gọi |