DM Champ Docs

Nhật ký lỗi

Nhật ký lỗi là danh sách theo trình tự thời gian về mọi thứ không hoạt động trong tài khoản của bạn: một tin nhắn không thể gửi đi, một phản hồi AI không bao giờ được gửi, một kênh bị mất kết nối, một quá trình nhập dữ liệu bị lỗi giữa chừng.

Mỗi mục nhập đều có một mã ngắn, lời giải thích bằng ngôn ngữ đơn giản và cách xử lý — vì vậy khi có điều gì đó không ổn, bạn có thể tự mình xem lý do và khắc phục thay vì phải viết thư cho bộ phận hỗ trợ và chờ đợi câu trả lời. Đây cũng là cách nhanh nhất để phân biệt một vấn đề thực sự với một hành động diễn ra đúng như dự kiến (ví dụ: một liên hệ đã chọn hủy đăng ký, một cửa sổ trả lời đã đóng).

Tìm ở đâu

Trong menu chính ở phía bên trái màn hình, ngay dưới cùng, hãy nhấp vào Nhật ký lỗi — nó nằm ngay phía trên Trợ giúp. (Trên điện thoại, trước tiên hãy nhấn vào biểu tượng menu ☰, sau đó chọn Nhật ký lỗi.)

Trang Nhật ký lỗi, được mở từ mục Nhật ký lỗi gần cuối thanh bên trái, hiển thị khoảng thời gian 30 ngày qua đã chọn, các bộ lọc kênh và Chỉ lỗi, các thẻ danh mục, và năm lần gửi WhatsApp thất bại — hàng đầu tiên được mở rộng để hiển thị mã APP-1104, giải thích bằng ngôn ngữ đơn giản, cách khắc phục, những gì hệ thống báo cáo, và các nút Đi đến Kênh và Giới thiệu về mã này

Mỗi hàng chứa một mã, những gì đã xảy ra và cách khắc phục; việc mở rộng một hàng sẽ thêm thông báo của chính nhà cung cấp và các nút tắt đến nơi bạn thực hiện khắc phục.

Đọc một hàng

Mỗi hàng là một sự cố đã xảy ra, hiển thị theo thứ tự mới nhất trước.

Phần của hàng Thông tin cung cấp
Thời gian Thời điểm xảy ra sự cố. Di chuột qua để xem ngày và giờ chính xác.
Mã Mã ngắn cho loại lỗi này, ví dụ: TW-63016. Nhấp để sao chép. Mọi mã đều được giải thích bên dưới.
Danh mục và kênh Khu vực liên quan (gửi tin, AI, kênh, thanh toán, v.v.) và kênh xảy ra sự cố.
Điều gì đã xảy ra Lỗi trong một dòng, kèm theo liên kết đến liên hệ nếu có.
Cách xử lý Cách khắc phục, trong một dòng.

Nhấp vào một hàng để mở rộng. Hàng được mở rộng sẽ thêm lời giải thích đầy đủ, thông báo từ chính nhà cung cấp (nếu có), mã số của nhà cung cấp và các nút đưa bạn trực tiếp đến nơi cần khắc phục — Mở trò chuyện, Đi tới Kênh và các nút tương tự. Về mã này sẽ mở trang này tại mục nhập của mã đó.

Bộ lọc

Phía trên danh sách, bạn có thể thu hẹp phạm vi tìm kiếm:

  • Phạm vi thời gian — 24 giờ, 7 ngày hoặc 30 ngày. Mặc định là 7 ngày và hệ thống sẽ ghi nhớ phạm vi bạn chọn.
  • Thẻ danh mục — mỗi thẻ đại diện cho một danh mục, kèm theo số lượng mục nhập trong phạm vi đó. Nhấp để chỉ hiển thị danh mục đó.
  • Kênh — giới hạn danh sách trong một kênh, ví dụ: WhatsApp hoặc Instagram.
  • Chỉ lỗi — ẩn các cảnh báo và mục nhập thông tin, chỉ để lại những thứ thực sự bị lỗi.
  • Tìm kiếm — nhập tên hoặc số điện thoại của liên hệ, hoặc một mã, để tìm mục nhập cụ thể.

Những gì Nhật ký bao gồm

  • Các tin nhắn không thể gửi được, trên mọi kênh — WhatsApp Business, WhatsApp Web, SMS, Instagram, Messenger, Telegram và email. Thông báo email về việc gửi thất bại sẽ nêu tên liên hệ và số điện thoại của họ, tên tài khoản xảy ra lỗi khi bạn quản lý nhiều tài khoản, và có nút Mở cuộc trò chuyện để đưa bạn đến cuộc trò chuyện đó.
  • Các lần AI không phản hồi, và lý do — không có tác nhân (agent) nào được thiết lập để trả lời, hết tín dụng, đạt đến giới hạn, lịch trình đã đóng, hoặc AI không thể tạo phản hồi ngay cả sau khi thử lại.
  • Các vấn đề về kênh — phiên WhatsApp Web bị ngắt kết nối, thông tin đăng nhập hết hạn, đạt giới hạn gửi.
  • Thanh toán và giới hạn — thanh toán quá hạn, việc gửi bị tạm dừng, số dư tín dụng bằng không, đạt giới hạn liên hệ.
  • Nhập cơ sở kiến thức bị thất bại.
  • Broadcast (bao gồm các mục chiến dịch Cổ điển) đã bị tạm dừng tự động.
  • Các lần chạy tự động hóa đã dừng do lỗi.
  • Webhook đang bị lỗi hoặc đã bị tắt sau nhiều lần thất bại liên tiếp.
  • Lịch phòng không thể đọc được.

Những gì không bao gồm

  • Mọi thứ hoạt động bình thường. Nhật ký chỉ liệt kê các lỗi, vì vậy một trang trống là tin tốt.
  • Sự cố trên toàn nền tảng. Nếu nhiều vấn đề không liên quan xảy ra cùng lúc, trước tiên hãy kiểm tra Trạng thái hệ thống.
  • Kết quả theo từng người nhận của một tin nhắn quảng bá. Để biết hiệu suất gửi tổng thể, hãy mở chính tin nhắn quảng bá đó — xem Tin nhắn quảng bá.

Đọc Nhật ký thông qua API

Các mục tương tự có sẵn thông qua API tại GET /v1/error-log, và đối với các trợ lý AI được kết nối thông qua máy chủ MCP dưới dạng công cụ list_error_log_entries.

Các tài khoản đại lý có thể truyền sub_account_id để đọc nhật ký Lỗi của tài khoản khách hàng bằng khóa API của chính đại lý (xem API dành cho Đại lý).

Khi nào cần liên hệ với bộ phận hỗ trợ

Hầu hết các mục đều cho bạn biết chính xác cần thay đổi những gì và bạn có thể tự thực hiện. Khi một mục yêu cầu liên hệ, hoặc cùng một mã lỗi liên tục xuất hiện sau khi bạn đã thực hiện sửa lỗi, hãy liên hệ với bộ phận hỗ trợ và đính kèm mã lỗi cùng thời điểm xảy ra lỗi (sao chép trực tiếp từ hàng đó). Thông thường, điều đó là đủ để chúng tôi tìm ra nguyên nhân mà không cần trao đổi qua lại nhiều lần.

Tất cả mã lỗi

Phần đầu của mã cho biết lỗi xuất phát từ đâu:

  • TW — Twilio, nhà cung cấp đứng sau WhatsApp Business và SMS. Số theo sau là mã lỗi của chính Twilio.
  • META — WhatsApp Business thông qua Meta. Số này là mã lỗi của chính Meta.
  • WAW — WhatsApp Web.
  • APP — Mã của riêng DM Champ, được sử dụng cho mọi thứ mà nhà cung cấp không cung cấp mã.

Mỗi mã dưới đây đều có liên kết riêng, vì vậy khi chọn Về mã này trong ứng dụng, bạn sẽ được đưa đến đúng mục đó.

WhatsApp Business (Twilio)

Mã Ý nghĩa Cách xử lý
TW-63005 WhatsApp từ chối nội dung tin nhắn. WhatsApp đã từ chối nội dung của tin nhắn này. Kiểm tra văn bản tin nhắn, mọi phương tiện, cũng như tiêu đề và các biến của mẫu, sau đó gửi lại.
TW-63007 Số người gửi chưa được kết nối. Tin nhắn này được gửi từ một số điện thoại chưa được kết nối với tư cách là người gửi WhatsApp. Kết nối lại số điện thoại trong Cài đặt → Kênh, sau đó thử lại.
TW-63012 Sự cố WhatsApp tạm thời. WhatsApp gặp sự cố tạm thời từ phía họ. Thử gửi lại sau vài phút.
TW-63016 Cửa sổ trả lời 24 giờ đã đóng. Cửa sổ trả lời 24 giờ với liên hệ này đã đóng, vì vậy tin nhắn tự do không thể được gửi đi. Gửi một mẫu đã được phê duyệt để mở lại cuộc trò chuyện.
TW-63021 Nội dung không được WhatsApp chấp nhận. Nội dung không vượt qua được kiểm duyệt của WhatsApp: loại tin nhắn không được hỗ trợ, phương tiện quá lớn hoặc không thể truy cập công khai, hoặc tiêu đề/văn bản nút vượt quá giới hạn độ dài. Kiểm tra xem liên kết phương tiện có mở được trong cửa sổ trình duyệt ẩn danh không, rút ngắn nhãn nút và giữ nội dung mẫu dưới 1.024 ký tự.
TW-63024 Số điện thoại không thể nhận tin nhắn WhatsApp. Số này không thể nhận tin nhắn WhatsApp. Có thể số này không sử dụng WhatsApp hoặc người đó chưa chấp nhận các điều khoản mới nhất của WhatsApp. Xác nhận lại số điện thoại với liên hệ, hoặc liên hệ với họ qua SMS hoặc email.
TW-63027 Mẫu không khả dụng bằng ngôn ngữ này. Mẫu không tồn tại bằng ngôn ngữ đã gửi. Chọn một mẫu đã được phê duyệt bằng ngôn ngữ của liên hệ, hoặc tạo một mẫu bằng ngôn ngữ đó trong phần Mẫu.
TW-63032 Bị chặn bởi thử nghiệm của Meta. WhatsApp sẽ không gửi tin nhắn đến số này vì Meta đã đưa nó vào một thử nghiệm nền tảng. Không có gì cần sửa từ phía bạn. Hãy liên hệ với người đó qua kênh khác nếu việc này khẩn cấp.
TW-63049 Mẫu tiếp thị bị Meta chặn. Meta đã chặn mẫu tiếp thị này. Các mẫu tiếp thị không còn có thể được gửi đến các số điện thoại tại Hoa Kỳ. Ở những nơi khác, đây thường là giới hạn tạm thời về số lượng tin nhắn tiếp thị mà người đó có thể nhận. Đối với các liên hệ tại Hoa Kỳ, hãy sử dụng SMS hoặc email. Đối với các quốc gia khác, hãy thử lại sau.
TW-63050 Liên hệ đã từ chối nhận tin nhắn tiếp thị. Người này đã từ chối nhận tin nhắn tiếp thị từ doanh nghiệp của bạn trên WhatsApp. Họ sẽ không nhận được mẫu tiếp thị nữa cho đến khi họ chọn nhận lại. Các tin nhắn dịch vụ và tiện ích vẫn hoạt động bình thường.
TW-63051 Người gửi WhatsApp bị Meta khóa. Người gửi WhatsApp này bị Meta khóa. Điều này thường xảy ra sau 30 ngày không gửi tin nhắn nào. Liên hệ với bộ phận hỗ trợ để đăng ký lại.
TW-63058 Quốc gia không được phép gửi tin nhắn doanh nghiệp. WhatsApp không cho phép gửi tin nhắn doanh nghiệp đến người nhận tại quốc gia này. Liên hệ với người đó qua SMS hoặc email.
TW-21211 Số điện thoại không hợp lệ. Số điện thoại của liên hệ không hợp lệ: thiếu mã quốc gia, lỗi đánh máy hoặc thừa chữ số. Mở liên hệ và sửa số điện thoại theo định dạng quốc tế, ví dụ: +14155551234.
TW-21212 Không có người gửi được phê duyệt trên tài khoản này. Số điện thoại gửi tin nhắn này không phải là người gửi WhatsApp được phê duyệt, vì vậy nhà cung cấp đã từ chối. Mở Cài đặt → Kênh và kiểm tra xem số WhatsApp Business của bạn đã được kết nối và phê duyệt chưa. Nếu trạng thái là đã kết nối, hãy liên hệ với bộ phận hỗ trợ và cung cấp mã này.
TW-21408 Quốc gia đích chưa được kích hoạt. Việc gửi tin nhắn đến quốc gia của liên hệ đã bị tắt trên tài khoản gửi. Đối với SMS bằng tài khoản Twilio của riêng bạn, hãy kích hoạt quốc gia trong phần Nhắn tin → Cài đặt → Quyền địa lý trong Bảng điều khiển Twilio. Đối với WhatsApp, hãy liên hệ với bộ phận hỗ trợ.
TW-21602 Tin nhắn trống. Tin nhắn không có văn bản nên không thể gửi được. Thêm văn bản vào tin nhắn và gửi lại.
TW-21610 Liên hệ đã trả lời STOP. Người này đã nhắn tin STOP đến số của bạn, vì vậy các nhà mạng chặn các tin nhắn tiếp theo gửi đến họ. Xóa họ khỏi danh sách của bạn. Họ có thể nhắn tin START đến số của bạn để chọn nhận lại.
TW-21656 Các biến của mẫu không khớp. Các giá trị được điền vào mẫu không khớp với các trình giữ chỗ của nó: thiếu giá trị, giá trị trống hoặc giá trị có ngắt dòng. Kiểm tra xem mọi biến đều có giá trị và không có ngắt dòng, sau đó gửi lại.
TW-21703 Không có người gửi khả dụng cho điểm đến này. Tài khoản không có người gửi nào có thể tiếp cận quốc gia của liên hệ này với loại tin nhắn này. Kiểm tra số điện thoại trong Cài đặt → Kênh. Nếu số đã được kết nối và phê duyệt, hãy liên hệ với bộ phận hỗ trợ và cung cấp mã này.

SMS (Twilio)

Mã Ý nghĩa Cách xử lý
TW-30003 Điện thoại không liên lạc được. Điện thoại của liên hệ đã tắt, nằm ngoài vùng phủ sóng hoặc không thể nhận tin nhắn văn bản. Thử lại sau. Nếu vẫn tiếp tục lỗi, hãy kiểm tra xem đó có phải là số di động không.
TW-30004 Tin nhắn bị chặn. Nhà mạng hoặc người nhận đã chặn tin nhắn này. Người đó có thể đã chặn số của bạn, từ chối nhận tin hoặc nội dung đã bị lọc. Nếu họ đã từ chối nhận tin, họ cần nhắn tin START đến số của bạn. Nếu không, hãy thử dùng từ ngữ ngắn gọn, đơn giản hơn.
TW-30005 Số điện thoại không xác định hoặc không còn tồn tại. Nhà mạng không nhận diện được số này. Nó có thể đã bị ngắt kết nối hoặc nhập sai. Kiểm tra lại số điện thoại với liên hệ.
TW-30006 Số điện thoại cố định hoặc nhà mạng không thể liên lạc. Đây là số điện thoại cố định hoặc thuộc nhà mạng không thể nhận tin nhắn văn bản. Sử dụng số di động hoặc liên hệ với người đó qua kênh khác.
TW-30007 Tin nhắn bị lọc là thư rác. Bộ lọc thư rác của nhà mạng đã chặn tin nhắn này. Tránh sử dụng các công cụ rút gọn liên kết, VIẾT HOA TOÀN BỘ và các tin nhắn giống hệt nhau lặp đi lặp lại. Đối với các số tại Hoa Kỳ, hãy đảm bảo việc đăng ký Twilio A2P 10DLC của bạn đã hoàn tất.
TW-30008 Gửi thất bại vì lý do không xác định. Nhà mạng báo cáo lỗi mà không có nguyên nhân cụ thể. Thử lại. Nếu lỗi lặp lại với số này, hãy liên hệ với người đó bằng cách khác.
TW-30024 Người gửi chưa đăng ký với nhà mạng. Số điện thoại bạn đang gửi từ đó chưa được đăng ký hoặc xác minh với nhà mạng đích. Trong tài khoản Twilio của bạn, hãy hoàn tất việc đăng ký số điện thoại (A2P 10DLC hoặc xác minh số miễn phí) và đợi cho đến khi trạng thái hiển thị là đã xác minh.
TW-30034 Số điện thoại Hoa Kỳ chưa đăng ký A2P 10DLC. Các nhà mạng Hoa Kỳ chặn tin nhắn từ các số không được liên kết với chiến dịch A2P 10DLC đã được phê duyệt. Hoàn tất đăng ký thương hiệu và chiến dịch trong Twilio Console của bạn và thêm số điện thoại vào dịch vụ nhắn tin của chiến dịch.

WhatsApp Business (Meta)

Mã Ý nghĩa Cách xử lý
META-131026 Tin nhắn không thể gửi. WhatsApp không thể gửi tin nhắn này. Số điện thoại có thể không sử dụng WhatsApp, người đó có thể chưa chấp nhận các điều khoản mới nhất hoặc ứng dụng của họ đã quá cũ. Xác nhận lại số điện thoại với liên hệ hoặc liên hệ với họ theo cách khác.
META-131047 Cửa sổ trả lời 24 giờ đã đóng. Đã hơn 24 giờ kể từ lần cuối liên hệ nhắn tin cho bạn, vì vậy tin nhắn tự do không thể được gửi đi. Gửi một mẫu đã được phê duyệt để mở lại cuộc trò chuyện.
META-131049 Tin nhắn tiếp thị bị Meta giữ lại. Meta không gửi tin nhắn tiếp thị này để duy trì mức độ tương tác lành mạnh. Liên hệ đã đạt giới hạn nhận tin nhắn tiếp thị vào lúc này. Đợi ít nhất 24 giờ trước khi gửi lại mẫu tiếp thị cho liên hệ này.
META-131053 Không thể tải lên phương tiện. Phương tiện đính kèm trong tin nhắn này không thể tải lên WhatsApp. Kiểm tra xem loại tệp có được hỗ trợ và liên kết có mở được công khai không, sau đó gửi lại.
META-131056 Gửi quá nhiều tin nhắn cho liên hệ này. Đã gửi quá nhiều tin nhắn cho liên hệ này trong một khoảng thời gian ngắn. Đợi một chút trước khi nhắn tin lại cho liên hệ này.
META-132000 Các biến của mẫu không khớp. Số lượng giá trị được điền vào mẫu không khớp với các trình giữ chỗ của mẫu. Kiểm tra xem mọi trình giữ chỗ đều có giá trị, sau đó gửi lại.
META-132001 Không tìm thấy mẫu hoặc mẫu chưa được phê duyệt. Mẫu không tồn tại bằng ngôn ngữ này hoặc chưa được phê duyệt. Chọn một mẫu đã được phê duyệt bằng ngôn ngữ của liên hệ trong phần Mẫu.
META-132015 Mẫu bị tạm dừng do chất lượng thấp. Meta đã tạm dừng mẫu này do xếp hạng chất lượng thấp. Chỉnh sửa mẫu để cải thiện và gửi lại; trong thời gian chờ đợi, hãy sử dụng mẫu đã được phê duyệt khác.
META-130472 Bị chặn bởi thử nghiệm của Meta. Meta không gửi tin nhắn này do là một phần của thử nghiệm nền tảng. Không có gì cần sửa từ phía bạn.
META-133010 Số điện thoại chưa đăng ký với WhatsApp Business. Số gửi tin nhắn chưa được đăng ký trên Nền tảng WhatsApp Business. Kết nối lại số điện thoại trong Cài đặt → Kênh. Nếu tình trạng vẫn tiếp diễn, hãy liên hệ với bộ phận hỗ trợ.

Messenger và Instagram

Mã Ý nghĩa Cách xử lý
APP-1901 Xung đột tự động hóa trang Facebook. Facebook không cho phép gửi phản hồi này vì một ứng dụng khác hoặc các phản hồi tự động của chính Facebook hiện đang kiểm soát cuộc trò chuyện này. Trong cài đặt Trang Facebook của bạn, hãy tắt các phản hồi tự động của Facebook, sau đó mở Cài đặt trang → Nhắn tin nâng cao → Giao thức bàn giao (Handover protocol) và nhấp vào Định cấu hình (Configure) bên cạnh trình nhận Messenger (hoặc trình nhận Instagram) để đặt ứng dụng đã kết nối làm trình nhận chính. Sau đó, hãy thử phản hồi lại.
APP-1902 Đã hết cửa sổ 24 giờ của Meta. Instagram và Messenger chỉ cho phép phản hồi trong vòng 24 giờ kể từ tin nhắn cuối cùng của liên hệ. Liên hệ này đã không hoạt động hơn một ngày, vì vậy Meta đã chặn tin nhắn. Chờ liên hệ nhắn tin lại. Các mẫu tin nhắn không tồn tại trên các kênh này; hãy liên hệ với họ qua WhatsApp, SMS hoặc email nếu vấn đề không thể chờ đợi.
APP-1903 Bình luận đã có phản hồi riêng tư. Meta cho phép một phản hồi riêng tư cho mỗi bình luận và bình luận này đã nhận được một phản hồi rồi. Không cần sửa gì cả. Hãy tiếp tục trong chuỗi tin nhắn trực tiếp (DM) của liên hệ.
APP-1904 Bình luận không còn khả dụng. Bình luận đã bị xóa hoặc quá cũ để phản hồi riêng tư (Instagram cho phép phản hồi riêng tư trong vòng 7 ngày). Không cần sửa gì cả.
APP-1905 Thiếu quyền truy cập Facebook hoặc Instagram. Meta từ chối tin nhắn vì kết nối đang thiếu quyền truy cập. Kết nối lại tài khoản trong Cài đặt → Kênh và chấp nhận mọi quyền. Đối với Instagram, hãy kiểm tra xem tài khoản đó có phải là tài khoản chuyên nghiệp được liên kết với Trang Facebook của bạn hay không và đảm bảo “Cho phép truy cập tin nhắn” đã được bật trong ứng dụng Instagram.
APP-1906 Đăng nhập Facebook hoặc Instagram đã hết hạn. Mã thông báo đăng nhập cho Trang hoặc tài khoản Instagram này đã hết hạn hoặc bị thu hồi, vì vậy không thể gửi bất kỳ nội dung nào. Kết nối lại tài khoản trong Cài đặt → Kênh.
APP-1907 Liên hệ không còn khả dụng. Meta không còn tìm thấy cuộc trò chuyện hoặc người này nữa. Họ có thể đã chặn bạn, xóa tài khoản hoặc xóa cuộc trò chuyện. Không cần sửa gì cả.
APP-1908 Lỗi Meta tạm thời. Meta gặp sự cố tạm thời. Thử lại sau vài phút.
APP-1909 Meta đã từ chối tin nhắn này. Meta từ chối tin nhắn này vì lý do được hiển thị trong hàng mở rộng. Đọc chi tiết; nếu không rõ ràng, hãy liên hệ với bộ phận hỗ trợ và trích dẫn mã này.

WhatsApp Web

Mã Ý nghĩa Việc cần làm
WAW-463 WhatsApp đang giới hạn tin nhắn gửi đến liên hệ này. Họ có thể đã chặn số này, hoặc đây là một cuộc hội thoại mới mà WhatsApp chưa cho phép từ tài khoản này. Hãy đợi và thử lại sau, hoặc liên hệ với người đó bằng cách khác. Các số mới nên được làm nóng dần dần.
WAW-479 Sự cố kết nối WhatsApp tạm thời. Hãy thử gửi lại.
APP-1101 WhatsApp Web chưa được kết nối. Tin nhắn không thể gửi đi vì kết nối WhatsApp Web bị gián đoạn tại thời điểm đó. Mở Cài đặt → Kênh và nhấp vào Kết nối lại, sau đó quét mã QR bằng điện thoại. Sau đó gửi lại tin nhắn.
APP-1102 Không có số WhatsApp nào được kết nối. Tài khoản này không có số WhatsApp được kết nối, vì vậy tin nhắn không có nơi để gửi đến. Kết nối một số điện thoại trong phần Cài đặt → Kênh.
APP-1103 Đã gửi qua kết nối WhatsApp sai. Cuộc hội thoại này nằm trên số WhatsApp Web của bạn, nhưng tin nhắn lại được gửi qua WhatsApp Business. Trả lời trực tiếp từ cuộc trò chuyện để sử dụng đúng kênh của cuộc hội thoại đó.
APP-1104 Người gửi WhatsApp Business chưa được thiết lập. Tài khoản đã cố gắng gửi qua WhatsApp Business, nhưng chưa có số WhatsApp Business nào được thiết lập. Kết nối số WhatsApp Business trong phần Cài đặt → Kênh, hoặc chuyển liên hệ sang kênh mà bạn đã kết nối. Nếu đã có số được kết nối, hãy liên hệ bộ phận hỗ trợ và cung cấp mã này.
APP-1105 WhatsApp không xác nhận tin nhắn. Tin nhắn đã được chuyển đến WhatsApp Web, nhưng WhatsApp không xác nhận đã nhận được, vì vậy rất có thể tin nhắn chưa đến được người nhận. Điều này thường có nghĩa là kết nối WhatsApp Web bị gián đoạn trong giây lát khi đang gửi. Kiểm tra xem số WhatsApp Web có hiển thị là đã kết nối trong phần Cài đặt → Kênh hay không, sau đó gửi lại tin nhắn.
APP-1201 Số điện thoại không hợp lệ. Số điện thoại của liên hệ không thể xác thực được. Mở liên hệ và sửa lại số điện thoại theo định dạng quốc tế.
APP-1301 Đã đạt giới hạn liên hệ mới hàng ngày. (cảnh báo) Số WhatsApp Web này đã đạt giới hạn trong ngày về việc nhắn tin cho những người chưa từng nhắn tin cho nó. Giới hạn này tồn tại để bảo vệ số điện thoại khỏi bị cấm. Hãy đợi đến ngày mai. Giới hạn sẽ tăng lên khi số điện thoại được làm nóng dần. Xem Mở rộng phạm vi tiếp cận WhatsApp một cách an toàn.
APP-1401 Chưa đính kèm mẫu tin nhắn đã được phê duyệt. Một tin nhắn mẫu đã được gửi mà không có mẫu đã được phê duyệt. Chọn một mẫu đã được phê duyệt trong phần Mẫu và gửi lại.

Các kênh khác

Mã Ý nghĩa Cách xử lý
APP-1501 Địa chỉ email bị từ chối. Máy chủ thư của người nhận đã từ chối địa chỉ này. Kiểm tra xem địa chỉ email của liên hệ có bị lỗi chính tả không.
APP-1502 Chưa kết nối hộp thư email. Tài khoản này không có hộp thư email nào được kết nối để gửi đi. Kết nối một hộp thư trong Cài đặt → Kênh → Email.
APP-1503 Không thể gửi email. Email không thể gửi được vì lý do hiển thị trong hàng mở rộng. Kiểm tra cài đặt nhà cung cấp email của bạn trong Cài đặt → Nhà cung cấp email tùy chỉnh.
APP-1601 Phiên Telegram hết hạn. Đăng nhập Telegram cho tài khoản này đã kết thúc, thường là từ các phiên hoạt động của ứng dụng Telegram. Kết nối lại Telegram trong Cài đặt → Kênh.
APP-1602 Bị chặn trên Telegram. Một bên đã chặn bên kia trên Telegram, vì vậy tin nhắn không thể gửi được. Không có gì cần sửa từ đây.
APP-1603 Tin nhắn Telegram thất bại. Telegram không chấp nhận tin nhắn này. Thử lại; nếu vẫn tiếp diễn, hãy kết nối lại Telegram trong Cài đặt → Kênh.
APP-1701 SMS chưa được thiết lập. Tài khoản này không có người gửi SMS nào được kết nối. Kết nối tài khoản Twilio hoặc điện thoại Android của bạn trong Cài đặt → Nhà cung cấp SMS.
APP-2001 Việc gửi bị tạm dừng: thanh toán. Các tin nhắn gửi đi bị tạm dừng do hóa đơn chưa thanh toán hoặc đăng ký bị chặn. Thanh toán trong Cài đặt → Thanh toán; việc gửi sẽ tự động tiếp tục.
APP-9001 Gửi thất bại. Tin nhắn không thể gửi được. Lý do từ nhà cung cấp, nếu có, sẽ hiển thị trong hàng mở rộng. Thử lại; nếu lỗi vẫn tiếp diễn, hãy liên hệ bộ phận hỗ trợ và cung cấp mã này cùng thời điểm xảy ra lỗi.

AI

Mã Ý nghĩa Việc cần làm
APP-3001 Không có tác nhân AI nào trả lời tin nhắn mới. Một tin nhắn đã được gửi đến nhưng không có tác nhân AI nào được thiết lập để trả lời trên kênh đó, vì vậy không có ai phản hồi. Tin nhắn hiện đang nằm trong hộp thư đến của bạn. Mở Tác nhân AI (AI Agents) và bật một tác nhân, hoặc chỉ định một tác nhân cho điểm truy cập của kênh đó.
APP-3002 AI tạm dừng: hết tín dụng. AI không trả lời vì tài khoản đã hết tín dụng. Nạp thêm hoặc bật tính năng tự động nạp tiền trong Cài đặt → Thanh toán (Settings → Billing).
APP-3003 AI tạm dừng: thanh toán. AI không trả lời vì gói đăng ký bị chặn do vấn đề thanh toán. Hoàn tất thanh toán trong Cài đặt → Thanh toán (Settings → Billing).
APP-3004 Khóa AI của bạn bị lỗi và tính năng dự phòng đã tắt. Khóa nhà cung cấp AI của riêng bạn trả về lỗi và tính năng dự phòng sang AI của nền tảng đã bị tắt, vì vậy không có phản hồi nào được tạo. Sửa khóa trong Cài đặt → Mô hình AI (Settings → AI Model), hoặc bật tính năng dự phòng.
APP-3101 Khóa nhà cung cấp AI của bạn gặp sự cố. Khóa nhà cung cấp AI của riêng bạn đã bị từ chối. Trong thời gian chờ đợi, các bot của bạn vẫn tiếp tục hoạt động trên AI của nền tảng. Kiểm tra khóa và tình trạng thanh toán của nhà cung cấp trong Cài đặt → Mô hình AI (Settings → AI Model).
APP-3103 Một hàm chạy lâu không gửi kết quả. AI đã bắt đầu một công việc thông qua một hàm tùy chỉnh được thiết lập là “Kết quả sẽ có sau”, nhưng dịch vụ không bao giờ gửi kết quả đến liên kết callback trước khi hết hạn. AI đã được thông báo rằng kết quả không bao giờ đến. Kiểm tra nhật ký của dịch vụ cho lệnh gọi đó, đảm bảo nó gửi đến đúng liên kết callback từ yêu cầu, và tăng thời gian “Chờ tối đa” (Wait up to) trên hàm nếu công việc có thể mất nhiều thời gian hơn.
APP-3201 Bot đã dừng: đạt giới hạn tin nhắn cho liên hệ này. (cảnh báo) AI đã đạt đến số lượng tin nhắn tối đa cho phép đối với liên hệ này và đã dừng lại. Tiếp quản cuộc trò chuyện, hoặc tăng giới hạn tin nhắn cho mỗi liên hệ trong cài đặt của tác nhân.
APP-3301 AI đã bỏ qua: ngoài giờ hoạt động. (chỉ thông tin) Tin nhắn đến ngoài lịch trình khả dụng của bot. Điều chỉnh lịch trình trong phần Khả dụng (Availability) của tác nhân nếu nó lẽ ra phải trả lời.
APP-3302 AI đã bỏ qua: kích hoạt bằng từ khóa. (chỉ thông tin) Tin nhắn của liên hệ khớp với một từ khóa tạm dừng AI. Xem lại các từ khóa tạm dừng trong cài đặt của tác nhân.
APP-3303 AI đã bỏ qua: liên hệ đã chọn không tham gia. (chỉ thông tin) Liên hệ này bị loại trừ khỏi AI. Xóa bỏ loại trừ trên liên hệ nếu đó không phải là ý định của bạn.
APP-3304 AI đã bỏ qua: trả lời tin Instagram story. (chỉ thông tin) Các phản hồi cho Instagram story đã bị tắt đối với tác nhân này. Bật phản hồi story trong cài đặt Instagram của tác nhân nếu bạn muốn chúng được trả lời.
APP-3305 AI đã bỏ qua: bài đăng hoặc Reel được chia sẻ. (chỉ thông tin) Ai đó đã gửi một bài đăng hoặc Reel riêng lẻ mà không có nội dung viết kèm, và các phản hồi cho những nội dung này đã bị tắt đối với tác nhân này. Bật chia sẻ bài đăng và Reel trên Instagram trong cài đặt của tác nhân nếu bạn muốn chúng được trả lời.
APP-3306 AI không thể trả lời. Tác nhân AI không thể tạo phản hồi cho tin nhắn này, ngay cả sau khi tự động thử lại, vì vậy tin nhắn không được trả lời. Hãy tự trả lời khách hàng hoặc đợi tin nhắn tiếp theo của họ.
APP-3307 Bỏ qua theo dõi: không có mẫu được phê duyệt. Tin nhắn theo dõi sau 24 giờ không được gửi vì tác nhân này không có mẫu theo dõi được phê duyệt cho chu kỳ đó. Sau 24 giờ, WhatsApp chỉ cho phép các mẫu được phê duyệt. Điều này áp dụng cho WhatsApp Business API; các kênh khác sẽ gửi phản hồi theo dõi do AI viết thay thế. Tạo các mẫu trong tab Theo dõi (Follow-ups) của tác nhân và đợi cho đến khi chúng được phê duyệt.
APP-3308 AI tạm dừng cho toàn bộ tài khoản. (chỉ thông tin) AI không trả lời vì các phản hồi AI đã bị tạm dừng cho toàn bộ tài khoản của bạn. Nhấp vào Tiếp tục AI (Resume AI) trong biểu ngữ ở đầu ứng dụng khi bạn muốn AI trả lời lại.
APP-3309 Đã đạt giới hạn WhatsApp Web hàng ngày. AI không trả lời vì số WhatsApp Web này đã đạt giới hạn tin nhắn hàng ngày. Không cần làm gì cả: AI sẽ tự động trả lời tin nhắn này sau khi giới hạn được đặt lại vào lúc 00:00 UTC. Bạn vẫn có thể trả lời từ WhatsApp trên điện thoại của mình.
APP-3310 Không trả lời: tác nhân đang ở chế độ kiểm tra. (chỉ thông tin) AI không trả lời vì tác nhân này đang ở chế độ kiểm tra và chỉ trả lời các liên hệ trong danh sách chế độ kiểm tra của nó. Thêm liên hệ này vào danh sách chế độ kiểm tra của tác nhân, hoặc tắt chế độ kiểm tra để cho phép AI trả lời mọi người.
APP-3311 Đã đạt giới hạn phản hồi AI trong cuộc trò chuyện này. Cuộc trò chuyện này đã đạt đến số lượng phản hồi AI tối đa mà gói của bạn cho phép, vì vậy AI đã bị tắt cho cuộc trò chuyện này. Hãy tự trả lời hoặc nâng cấp gói của bạn để cho phép nhiều phản hồi AI hơn cho mỗi cuộc trò chuyện.
APP-3312 AI chọn không trả lời. (chỉ thông tin) AI đã đọc tin nhắn này và quyết định rằng nó không cần phản hồi, vì vậy không có gì được gửi đến liên hệ. Không cần làm gì nếu không cần phản hồi. Nếu cần, hãy tự trả lời hoặc hướng dẫn tác nhân trong phần chỉ dẫn về thời điểm nó nên trả lời.
APP-3313 Đã đạt ngân sách hàng tháng cho khóa AI. AI không trả lời vì khóa AI mà tài khoản này sử dụng đã đạt đến ngân sách chi tiêu hàng tháng được thiết lập cho nó, vì vậy không có gì được gửi đến liên hệ. Lưu ý này xuất hiện tối đa một lần mỗi ngày cho mỗi cuộc trò chuyện. Tăng hoặc xóa ngân sách hàng tháng của BYOK. Đối với tài khoản khách hàng, đại lý thiết lập nó trong phần Tài khoản phụ (Sub-accounts) bằng cách chỉnh sửa khách hàng. Nếu không, AI sẽ trả lời lại sau khi mức sử dụng hàng tháng được đặt lại.

Khi AI không phản hồi, hệ thống sẽ tự động thử lại vài lần. Nếu vẫn không thể phản hồi, cuộc trò chuyện sẽ hiển thị một ghi chú và nhật ký Lỗi sẽ nhận được một mục APP-3306. Một cuộc trò chuyện mà tác nhân đã chuyển cho nhân viên (đã cảnh báo đồng đội hoặc kết thúc cuộc trò chuyện) sẽ không được tính: AI cố tình im lặng trong trường hợp đó, vì vậy sẽ không có ghi chú và không có mục APP-3306 nào được tạo.

Kênh

Mã Ý nghĩa Cách xử lý
APP-1111 WhatsApp Web bị ngắt kết nối. Số WhatsApp Web đã mất kết nối và cần quét lại mã QR. Các tin nhắn trong hàng đợi khi bị ngắt kết nối sẽ không được gửi đi. Mở Cài đặt → Kênh và nhấp vào Kết nối lại, sau đó quét mã QR.
APP-1112 Sự cố kết nối WhatsApp Business. Meta đã báo cáo sự cố với kết nối WhatsApp Business của bạn; chi tiết được hiển thị trong hàng mở rộng. Làm theo chi tiết; nếu có đề cập đến mã thông báo hoặc quyền, hãy kết nối lại trong Cài đặt → Kênh.
APP-1113 Xung đột chuyển giao Instagram. Một ứng dụng khác đang kiểm soát các cuộc trò chuyện Instagram cho tài khoản này, vì vậy các phản hồi có thể bị chặn. Trong cài đặt Trang Facebook của bạn, mở Thiết lập trang → Nhắn tin nâng cao → Giao thức chuyển giao, nhấp vào Cấu hình bên cạnh trình nhận Instagram và chọn ứng dụng đã kết nối làm trình nhận chính. Nếu tab Thiết lập trang cũng liệt kê định tuyến cuộc trò chuyện Instagram, hãy trỏ ứng dụng định tuyến mặc định của nó vào cùng một ứng dụng.
APP-1114 Đã đạt giới hạn gửi WhatsApp Web. (cảnh báo) Số điện thoại đã đạt giới hạn gửi hiện tại. Vui lòng đợi; giới hạn sẽ đặt lại hàng ngày và tăng lên khi số điện thoại hoạt động ổn định hơn.
APP-1115 Một ứng dụng khác đang gửi từ WhatsApp của bạn. (cảnh báo) Cùng một tin nhắn liên tục được gửi đi từ số WhatsApp Web bên ngoài ứng dụng này: ba lần đến một cuộc trò chuyện trong vòng một phút, hoặc đến nhiều cuộc trò chuyện trong vòng mười phút. Mọi tin nhắn gửi từ bên ngoài ứng dụng đều được tính là bạn đang trả lời, vì vậy AI sẽ tạm dừng trong mỗi cuộc trò chuyện mà nó tiếp cận. Mục này trích dẫn văn bản lặp lại và xuất hiện tối đa một lần mỗi ngày cho mỗi số điện thoại. Mở WhatsApp trên điện thoại, đi tới Thiết bị đã liên kết và đăng xuất khỏi ứng dụng bạn không còn sử dụng nữa, hoặc tắt tính năng tự động trả lời của ứng dụng đó. Sau đó, tiếp tục chạy AI trong các cuộc trò chuyện bị ảnh hưởng.

Thanh toán và Giới hạn

Mã Ý nghĩa Cách thực hiện
APP-2002 Thanh toán quá hạn. Lần thanh toán đăng ký cuối cùng đã thất bại. Dịch vụ bị gián đoạn nếu vẫn chưa thanh toán. Cập nhật phương thức thanh toán trong Cài đặt → Thanh toán.
APP-2003 Gửi đi bị tạm dừng. Nhắn tin đi đã bị tạm dừng do vấn đề thanh toán chưa được giải quyết. Thanh toán trong Cài đặt → Thanh toán.
APP-2004 Hết tín dụng. Số dư tín dụng đã về 0, vì vậy các phản hồi AI và tin nhắn trả phí sẽ dừng lại. Nạp thêm hoặc bật tự động nạp tiền trong Cài đặt → Thanh toán.
APP-2101 Đã đạt giới hạn liên hệ. Giới hạn liên hệ của gói đã đạt, vì vậy nhắn tin AI bị tạm dừng cho các liên hệ mới. Nâng cấp gói hoặc xóa các liên hệ không sử dụng.

Cơ sở Kiến thức

Mã Ý nghĩa Cách thực hiện
APP-4001 Nhập cơ sở kiến thức thất bại. Các trang từ một lần nhập không thể đọc được. Kiểm tra xem trang web có thể truy cập công khai không (không có tường đăng nhập) và thử lại việc nhập trong Cơ sở kiến thức.

Phát sóng và Chiến dịch

Mã Ý nghĩa Cách xử lý
APP-5101 Tác nhân tự động tạm dừng. Tác nhân đã ngừng nhắn tin cho người mới vì quá ít người trong số họ trả lời, điều này gây rủi ro cho số điện thoại. Xem lại những người mà tác nhân đang tiếp cận và tin nhắn mở đầu của nó, sau đó bật lại tác nhân từ trang của nó.
APP-5102 Trình bảo vệ gửi đã dừng một chương trình phát sóng. Chương trình phát sóng đã bị dừng vì có vẻ như nó đang gửi đến những người chưa bao giờ nhắn tin cho bạn, điều này gây rủi ro cho số điện thoại. Xem lại đối tượng, sau đó tiếp tục từ trang chương trình phát sóng.
APP-5103 Cảnh báo trình bảo vệ gửi. (cảnh báo) Một chương trình phát sóng đang nhắn tin cho nhiều người chưa bao giờ nhắn tin cho bạn. Hãy giữ cho đối tượng tương tác tốt và duy trì tốc độ gửi dần dần. Xem Mở rộng quy mô tiếp cận WhatsApp một cách an toàn.
APP-5104 Chương trình phát sóng tự động tạm dừng. Chương trình phát sóng đã bị tạm dừng sau nhiều lần thất bại. Khắc phục nguyên nhân hiển thị trong các lỗi gửi, sau đó tiếp tục.

Tự động hóa

Mã Ý nghĩa Việc cần làm
APP-5001 Tự động hóa cần bạn chú ý. Một quy trình tự động hóa đã gửi cảnh báo cần sự can thiệp của con người. Mở cuộc trò chuyện hoặc quy trình tự động hóa được liên kết.
APP-5201 Tự động hóa chạy thất bại. Một lần chạy của quy trình tự động hóa này đã dừng lại do lỗi; thông báo của bước đó được hiển thị trong hàng mở rộng. Mở lần chạy để xem bước nào đã thất bại, sửa cài đặt của bước đó và chạy lại. Bật Tự động hóa thất bại trong phần Thông báo để được cảnh báo khi điều này xảy ra.

Tích hợp

Mã Ý nghĩa Cách xử lý
APP-6001 Gửi Webhook thất bại. Điểm cuối webhook của bạn đang từ chối hoặc hết thời gian chờ khi gửi; phản hồi cuối cùng được hiển thị trong hàng mở rộng. Kiểm tra xem điểm cuối có đang hoạt động và trả về trạng thái 2xx nhanh chóng hay không.
APP-6002 Webhook bị vô hiệu hóa sau nhiều lần thất bại. Webhook đã bị tắt vì liên tục thất bại. Các sự kiện không được gửi đến nó. Sửa điểm cuối, sau đó bật lại webhook trong Cài đặt → Webhooks.

Cuộc hẹn

Mã Ý nghĩa Việc cần làm
APP-7001 Không thể đọc lịch phòng. Không thể đọc Lịch Google được liên kết với một phòng, do đó tình trạng phòng trống của phòng đó có thể không chính xác. Chia sẻ lại lịch với tài khoản Google đã kết nối hoặc kết nối lại Lịch Google.

Các bước tiếp theo

  • Trạng thái hệ thống — kiểm tra xem sự cố có nằm ở phía chúng tôi hay không.
  • Thông báo — chọn những lỗi nào sẽ được gửi đến bạn qua email, thông báo đẩy hoặc biểu tượng chuông.
  • Webhook — gửi sự kiện đến các hệ thống của riêng bạn.