Your AI Connector 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.)

Đọ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.

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 Your AI Connector, đượ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

Code What it means What to do
APP-3001 No AI agent answered a new message. A message came in but no active AI agent was set to answer on that channel, so nobody replied. The message is in your inbox. Open AI Agents and switch an agent on, or assign one to that channel’s entry point.
APP-3002 AI paused: no credits left. The AI did not reply because the account ran out of credits. Top up or enable auto-recharge under Settings → Billing.
APP-3003 AI paused: billing. The AI did not reply because the subscription is blocked for billing. Settle the payment under Settings → Billing.
APP-3004 Your AI key failed and fallback is off. Your own AI provider key returned an error and fallback to the platform’s AI is switched off, so no reply was generated. Fix the key under Settings → AI Model, or switch fallback on.
APP-3101 Your AI provider key has a problem. Your own AI provider key was rejected. Your bots keep working on the platform’s AI in the meantime. Check the key and the provider’s billing under Settings → AI Model.
APP-3103 A long-running function never sent its result. The AI started a job through a custom function set to “Result comes later”, but the service never posted the result to the callback link before it expired. The AI was told the result never came. Check the service’s logs for the call, make sure it posts to the exact callback link from the request, and raise “Wait up to” on the function if the job can take longer.
APP-3201 Bot stopped: message cap reached for this contact. (warning) The AI reached the maximum number of messages allowed for this contact and stopped. Take over the chat, or raise the per-contact message limit in the agent’s settings.
APP-3301 AI skipped: outside active hours. (information only) The message arrived outside the bot’s availability schedule. Adjust the schedule under the agent’s Availability if it should have answered.
APP-3302 AI skipped: keyword trigger. (information only) The contact’s message matched a keyword that pauses the AI. Review the pause keywords in the agent’s settings.
APP-3303 AI skipped: contact opted out. (information only) This contact is excluded from the AI. Remove the exclusion on the contact if that was not intended.
APP-3304 AI skipped: Instagram story reply. (information only) Replies to Instagram stories are switched off for this agent. Turn on story replies in the agent’s Instagram settings if you want them answered.
APP-3305 AI skipped: shared post or Reel. (information only) Someone sent a post or Reel on its own, with nothing written next to it, and replies to those are switched off for this agent. Turn on Instagram post and Reel shares in the agent’s settings if you want these answered.
APP-3306 AI could not reply. The AI agent could not produce a reply to this message, even after retrying automatically, so the message was left unanswered. Reply to the customer yourself, or wait for their next message.
APP-3307 Follow-up skipped: no approved template. The follow-up after 24 hours was not sent because this agent has no approved follow-up template for that cycle. After 24 hours, WhatsApp only allows approved templates. This applies to the WhatsApp Business API; other channels send an AI-written follow-up instead. Generate templates in the agent’s Follow-ups tab and wait until they are approved.
APP-3308 AI paused for the whole account. (information only) The AI did not reply because AI replies are paused for your whole account. Click Resume AI in the banner at the top of the app when you want the AI to answer again.
APP-3309 Daily WhatsApp Web limit reached. The AI did not reply because this WhatsApp Web number reached its daily message limit. Nothing to do: the AI answers this message automatically after the limit resets at 00:00 UTC. You can still reply from WhatsApp on your phone.
APP-3310 Not answered: agent in test mode. (information only) The AI did not reply because this agent is in test mode and only answers the contacts on its test mode list. Add this contact to the agent’s test mode list, or turn test mode off to let the AI answer everyone.
APP-3311 AI reply limit reached in this chat. This chat reached the most AI replies your plan allows in one chat, so the AI was switched off for this chat. Reply yourself, or upgrade your plan to allow more AI replies per chat.
APP-3312 AI chose not to reply. (information only) The AI read this message and decided it did not need a reply, so nothing was sent to the contact. Nothing to do if no reply was needed. If one was, reply yourself, or tell the agent in its instructions when it should always answer.

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.