> ## Documentation Index > Fetch the complete documentation index at: https://chatbotx.io/docs/llms.txt > Use this file to discover all available pages before exploring further. # Nhật ký lỗi hệ thống > Tra cứu nhật ký lỗi, chẩn đoán nguyên nhân và cách xử lý sự cố kịch bản, tin nhắn đa kênh và tích hợp trong ChatbotX Error Logs. **Error Logs** là trung tâm theo dõi và ghi nhận nhật ký lỗi thời gian thực của ChatbotX. Khi kịch bản tự động bị dừng đột ngột, tin nhắn không gửi được tới khách hàng hoặc các khối tích hợp API gặp sự cố, Error Logs giúp bạn nhanh chóng xác định nguyên nhân chính xác và thực hiện các bước khắc phục phù hợp. ## Truy cập Error Logs Để mở trang nhật ký lỗi trong Workspace của bạn: 1. Tại thanh điều hướng bên trái, chọn **Flows**. 2. Trên thanh tab phụ phía trên, chọn tab **Error Logs**. ## Giao diện và các trường dữ liệu Giao diện Error Logs được thiết kế dạng bảng trực quan, cho phép lọc và kiểm tra chi tiết từng sự cố phát sinh. Error Logs Interface Details ### Bộ lọc và công cụ quản lý bảng * **Select type (Bộ lọc loại lỗi)**: Ô chọn phía trên bảng giúp bạn lọc danh sách nhật ký theo từng loại kênh hoặc tính năng phát sinh lỗi cụ thể (như WhatsApp, Messenger, Instagram, External Request, Send Email...). * **Hộp kiểm chọn hàng (Checkbox)**: Tích chọn từng dòng hoặc tích vào ô đầu bảng để chọn tất cả bản ghi (ví dụ: `0 of 7 row(s) selected`), giúp bạn chọn hàng loạt và xóa nhanh các bản ghi nhật ký lỗi đã xử lý hoặc không còn cần thiết. * **Phân trang (Pagination)**: Tùy chỉnh số lượng bản ghi hiển thị trên mỗi trang qua mục **Rows per page** (10, 20, 50 dòng) và di chuyển qua lại giữa các trang nhật ký. ### Các cột thông tin trong bảng Cột hiển thị kênh nhắn tin (Messenger, WhatsApp, Instagram, Zalo) hoặc khối tính năng thực thi phát sinh lỗi. Bạn có thể nhấp vào tiêu đề cột Type để sắp xếp danh sách theo thứ tự bảng chữ cái tăng dần (Asc) hoặc giảm dần (Desc). Nội dung mô tả chi tiết sự cố, kèm mã phản hồi lỗi (Error Code) trả về từ hệ thống ChatbotX hoặc nền tảng Meta (Messenger Platform, WhatsApp Cloud API...). Tên hoặc định danh của liên hệ gặp sự cố trong phiên tương tác thực tế. Thời điểm chính xác xảy ra lỗi kèm nút thao tác nhanh (biểu tượng ba chấm ...) để xem chi tiết hoặc xóa bản ghi lỗi. ## Quy trình 3 bước xử lý sự cố Khi phát hiện chatbot phản hồi không đúng hoặc nhận được phản ánh từ khách hàng, hãy thực hiện kiểm tra theo quy trình chuẩn sau: Truy cập **Flows > Error Logs**. Sử dụng ô lọc **Select type** phía trên bảng để khoanh vùng các sự cố thuộc kênh hoặc tính năng bạn đang nghi ngờ. Đọc kỹ thông điệp trong cột **Description** để nắm rõ mã lỗi. Nhấn vào tên khách hàng ở cột **Contact** để kiểm tra lịch sử trò chuyện thực tế trong Inbox. Chỉnh sửa nội dung khối tin nhắn, cập nhật quyền truy cập hoặc cấu hình lại API theo bảng mã lỗi tương ứng. Sau đó gửi tin nhắn thử nghiệm để xác nhận sự cố đã được giải quyết. ## Bảng tra cứu mã lỗi và giải pháp khắc phục Các lỗi vận hành phổ biến thường xuất phát từ chính sách nền tảng nhắn tin của Meta, cấu hình kịch bản chưa hợp lệ hoặc lỗi xác thực tích hợp bên ngoài. Hãy tra cứu theo từng nhóm kênh bên dưới: ### Các mã lỗi thường gặp trên Messenger và Instagram Tra cứu danh mục mã lỗi đầy đủ từ Meta tại [Tài liệu mã lỗi Messenger Platform](https://developers.facebook.com/documentation/business-messaging/messenger-platform/error-codes). | Mã lỗi và Thông điệp | Nguyên nhân | Cách khắc phục | | - | - | - | | `Error validating access token: The session has been invalidated...` ([Mã lỗi 190](https://developers.facebook.com/documentation/business-messaging/messenger-platform/error-codes)) | Token truy cập của Trang Facebook bị hết hạn hoặc thu hồi do tài khoản quản trị viên vừa đổi mật khẩu, gặp checkpoint bảo mật hoặc bị thay đổi quyền trên Fanpage. | Truy cập **Settings > Channels**, chọn kết nối lại Trang (Reconnect) hoặc nhấn **Refresh All Permissions** để cấp lại token truy cập mới. | | `(#10) This message is sent outside of the allowed window` ([Mã lỗi 10](https://developers.facebook.com/documentation/business-messaging/messenger-platform/error-codes)) | Bạn gửi tin nhắn tự động khi đã quá 24 giờ kể từ tương tác gần nhất của khách hàng. | Chờ khách hàng chủ động nhắn tin lại để mở lại cửa sổ hội thoại 24 giờ, hoặc sử dụng đúng **Message Tag** phù hợp với chính sách của Meta (như Post-Purchase Update, Confirmed Event Update). | | `(#10) Message failed to send because another app is controlling this thread now` ([Giao thức chuyển giao](https://developers.facebook.com/documentation/business-messaging/messenger-platform/error-codes)) | Fanpage đang cài đặt ứng dụng khác làm ứng dụng nhận chính trong Giao thức chuyển giao (Handover Protocol). | Vào Cài đặt Fanpage trên Facebook > Nhắn tin nâng cao > Cài đặt giao thức chuyển giao và chọn ChatbotX làm ứng dụng chính. | | `(#100) Message cannot be empty, must provide valid attachment or text` ([Mã lỗi 100](https://developers.facebook.com/documentation/business-messaging/messenger-platform/error-codes)) | Khối tin nhắn chứa biến thuộc tính `{{custom_field}}` nhưng thuộc tính này chưa có dữ liệu đối với khách hàng đang chat, khiến nội dung gửi đi bị rỗng. | Thiết lập giá trị mặc định cho thuộc tính, hoặc thêm khối **Condition** kiểm tra thuộc tính có dữ liệu trước khi gửi tin. | | `(#100) name_placeholder[buttons][0][url] should represent a valid URL` ([Mã lỗi 100](https://developers.facebook.com/documentation/business-messaging/messenger-platform/error-codes)) | Nút bấm dạng URL hoặc đường dẫn ảnh không có tiền tố hợp lệ. | Đảm bảo mọi đường dẫn liên kết website bắt đầu đầy đủ bằng `https://`. | | `Error #551 This person isn't available right now` ([Mã lỗi 551](https://developers.facebook.com/documentation/business-messaging/messenger-platform/error-codes)) | Khách hàng đã chủ động chặn tin nhắn của Fanpage, hoặc tài khoản cá nhân của họ đang bị khóa hoặc tạm ngưng. | Bot không thể gửi tin cho liên hệ này. Cần chờ khách hàng chủ động bỏ chặn hoặc liên hệ qua kênh hỗ trợ khác. | | `(#200) Permissions error` / `(#230) Requires pages_messaging permission` ([Mã lỗi 200](https://developers.facebook.com/documentation/business-messaging/messenger-platform/error-codes)) | Quyền truy cập Fanpage bị gián đoạn do tài khoản Facebook đổi mật khẩu, bị checkpoint hoặc mất quyền Admin. | Truy cập **Settings > Channels**, chọn kết nối lại Trang hoặc cấp đủ quyền `pages_messaging` trong Meta Business Manager. | | `(#613) Calls to this api have exceeded the rate limit` ([Mã lỗi 613](https://developers.facebook.com/documentation/business-messaging/messenger-platform/error-codes)) | Số lượng tin nhắn gửi đi quá nhanh vượt quá giới hạn tần suất API của Meta đối với Trang. | Sử dụng khối **Wait** trong kịch bản để giãn cách thời gian phản hồi giữa các tin nhắn liên tiếp. | | `(#10900) Activity already replied to` / `(#10903) This user cant reply...` ([Mã lỗi 10900](https://developers.facebook.com/documentation/business-messaging/messenger-platform/error-codes)) | Khách hàng bình luận trên bài viết đã được trả lời inbox trước đó, hoặc bình luận đã quá thời hạn 7 ngày. | Điều hướng khách hàng bình luận bài viết mới hoặc nhắn tin trực tiếp vào Fanpage. | ### Các mã lỗi thường gặp trên WhatsApp Cloud API Tra cứu danh mục mã lỗi đầy đủ từ Meta tại [Tài liệu mã lỗi WhatsApp Business](https://developers.facebook.com/documentation/business-messaging/whatsapp/support/error-codes). | Mã lỗi và Thông điệp | Nguyên nhân | Cách khắc phục | | - | - | - | | `Business account is restricted from messaging users in this country` / `Code 131031: Account has been locked` ([Mã lỗi 131031](https://developers.facebook.com/documentation/business-messaging/whatsapp/support/error-codes)) | Tài khoản WhatsApp Business bị hạn chế gửi tin nhắn đến người dùng tại quốc gia mục tiêu hoặc tài khoản bị Meta tạm khóa do vi phạm chính sách chất lượng gửi tin. | Kiểm tra trạng thái sức khỏe tài khoản tại WhatsApp Account Health trên Meta Business Manager và gửi yêu cầu xem xét lại. | | `Code 131026: Message undeliverable` ([Mã lỗi 131026](https://developers.facebook.com/documentation/business-messaging/whatsapp/support/error-codes)) | Tin nhắn không thể gửi đến người nhận (người nhận không sử dụng WhatsApp, đã chặn số điện thoại doanh nghiệp, chưa chấp nhận Điều khoản WhatsApp mới hoặc Meta áp dụng giới hạn bảo vệ hộp thư người dùng). | Xác thực lại số điện thoại người nhận có đầy đủ mã quốc gia và tài khoản WhatsApp còn hoạt động bình thường. | | `Code 131047` / `Code 470: Re-engagement message` ([Mã lỗi 131047](https://developers.facebook.com/documentation/business-messaging/whatsapp/support/error-codes)) | Bạn cố gắng gửi tin nhắn dạng văn bản thông thường ngoài cửa sổ hội thoại 24 giờ kể từ tin nhắn cuối của khách hàng. | Ngoài 24 giờ, WhatsApp chỉ cho phép gửi các **WhatsApp Template** đã được Meta xét duyệt thành công. | | `Code 130429` / `Code 80007: Rate limit hit` ([Mã lỗi 130429](https://developers.facebook.com/documentation/business-messaging/whatsapp/support/error-codes)) | Số điện thoại hoặc tài khoản doanh nghiệp đã đạt giới hạn tần suất gửi tin nhắn theo hạn mức (Tier) hiện tại. | Sử dụng khối **Wait** trong kịch bản để giãn cách tiến trình gửi tin và theo dõi hạn mức gửi tin của số điện thoại trên WhatsApp Manager. | | `Code 1008: Required parameter is missing` ([Mã lỗi 1008](https://developers.facebook.com/documentation/business-messaging/whatsapp/support/error-codes)) | Mẫu tin nhắn Template yêu cầu tham số văn bản (biến `{{1}}`, `{{2}}`) nhưng Flow gửi đi giá trị rỗng. | Kiểm tra khối gửi WhatsApp Template trong Flow và điền đầy đủ các biến nội dung. | | `Code 2012: Parameter format does not match format in the created template` ([Mã lỗi 2012](https://developers.facebook.com/documentation/business-messaging/whatsapp/support/error-codes)) | Định dạng dữ liệu truyền vào không khớp với cấu hình mẫu (ví dụ: Template yêu cầu Header là Hình ảnh nhưng Flow truyền dạng Văn bản). | Điều chỉnh đúng định dạng Header và các trường dữ liệu theo đúng cấu hình Template trên WhatsApp Manager. | | `Code 131051: Unsupported message type` ([Mã lỗi 131051](https://developers.facebook.com/documentation/business-messaging/whatsapp/support/error-codes)) | Loại tin nhắn hoặc thành phần tương tác không được phiên bản WhatsApp Cloud API hiện tại hỗ trợ. | Kiểm tra lại cấu trúc khối tin nhắn và định dạng dữ liệu gửi đi. | | `Code 131053: Unsupported Image mime type image/gif` / `Downloading media from weblink failed` ([Mã lỗi 131053](https://developers.facebook.com/documentation/business-messaging/whatsapp/support/error-codes)) | WhatsApp không hỗ trợ gửi hình động định dạng `.gif`, hoặc đường dẫn ảnh/video/audio bị hỏng (404), máy chủ lưu trữ không cho phép truy cập. | Chuyển đổi định dạng ảnh sang `.png` hoặc `.jpeg`, đảm bảo tệp tin media mở công khai và truy cập bình thường trên trình duyệt. | | `Code 1005` / `Invalid catalog Id` ([Mã lỗi 1005](https://developers.facebook.com/documentation/business-messaging/whatsapp/support/error-codes)) | Danh mục sản phẩm (Catalog) chưa được liên kết với WhatsApp Business Manager hoặc vượt quá 30 sản phẩm trong một tin nhắn. | Liên kết Catalog trong Meta Commerce Manager và đảm bảo danh sách gửi tối đa 30 sản phẩm. | ### Các mã lỗi về External Request, Email và Tích hợp | Dịch vụ | Lỗi hiển thị | Nguyên nhân và Hướng xử lý | | - | - | - | | **External Request** | `Fail to execute the request` | Yêu cầu API thất bại do sai URL endpoint, thiếu Header xác thực (`Authorization`), dữ liệu JSON Body sai cấu trúc hoặc máy chủ đối tác phản hồi quá lâu (timeout quá 10 giây). Hãy kiểm tra lại API trên phần mềm Postman trước khi gắn vào Flow. | | **Google Sheets** | `{"error": "invalid_grant", "error_description": "Bad Request"}` | Quyền xác thực tài khoản Google liên kết đã hết hạn hoặc bị thu hồi. Truy cập mục **Settings > Integrations**, ngắt kết nối và kết nối lại tài khoản Google của bạn. | | **SendMail (SMTP)** | `SMTP Error: Could not authenticate` | Thông tin đăng nhập tài khoản email hoặc mật khẩu SMTP không chính xác. Nếu sử dụng Gmail SMTP, bạn bắt buộc phải bật xác thực 2 bước và tạo **Mật khẩu ứng dụng (App Password)** để điền vào cấu hình. | | **SendMail** | `No email address (TO)` | Trường dữ liệu `{{email}}` của khách hàng đang rỗng khi kịch bản chạy đến khối gửi email. Hãy dùng khối User Input để thu thập email hợp lệ trước khối SendMail. | | **MailerLite / SendGrid** | `API-Key Unauthorized` / `No email or opted-in` | Khóa API Key cung cấp không chính xác, hoặc người nhận chưa tích chọn đồng ý nhận email (opt-in). Kiểm tra lại API Key trong mục cấu hình tích hợp. | ## Mẹo thực tiễn để hạn chế lỗi kịch bản Áp dụng các thói quen vận hành sau để chatbot luôn hoạt động ổn định: Khi sử dụng các biến dữ liệu như `{{first_name}}` hoặc `{{custom_field}}`, luôn cấu hình giá trị thay thế phòng trường hợp thông tin của khách hàng chưa kịp cập nhật. Thêm khối **Condition** để kiểm tra điều kiện (ví dụ: `Email is set` hoặc `Phone is valid`) trước khi kích hoạt các khối gửi Email, SMS hoặc Webhook. Sau khi tạo hoặc chỉnh sửa kịch bản tự động, hãy mở ngay mục **Error Logs** để kiểm tra và khắc phục kịp thời các sự cố phát sinh. Luôn chạy thử nghiệm Flow qua nút **Preview** để đảm bảo tất cả nút bấm URL mở được website bình thường trên thiết bị di động. Khi gặp mã lỗi chưa có trong danh sách, hãy sao chép toàn bộ chuỗi ký tự trong cột **Description** và gửi cho đội ngũ hỗ trợ ChatbotX để được trợ giúp kỹ thuật nhanh chóng. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.