Truy cập Error Logs
Để mở trang nhật ký lỗi trong Workspace của bạn:- Tại thanh điều hướng bên trái, chọn Flows.
- 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.
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
Type
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).
Description
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…).
Contact
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ế.
Date & Actions
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:1
Mở Error Logs và lọc theo loại lỗi
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ờ.
2
Đối soát thông tin lỗi và liên hệ gặp sự cố
Đọ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.
3
Áp dụng giải pháp khắc phục và kiểm tra lại
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:- Facebook & Instagram
- WhatsApp
- Tích hợp & APIs
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.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:Sử dụng Fallback Text cho biến
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.Kiểm tra Condition trước khi gửi
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.Kiểm tra Error Logs định kỳ
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.
Kiểm tra liên kết và định dạng link
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.