Skip to content
  • en
  • troubleshooting
  • facebook session

Xử lý sự cố Facebook & Hết hạn Token (Facebook Session)

This content is not available in your language yet.

Khi sử dụng kênh Facebook Messenger, Meta yêu cầu làm mới quyền truy cập định kỳ. Nếu gặp sự cố mất kết nối, hệ thống sẽ hiển thị dải banner cảnh báo ChannelWarningBanner hoặc ZaloConnectionBanner.

Dấu hiệu nhận biết sự cố

Phần tiêu đề “Dấu hiệu nhận biết sự cố”
  • Thanh cảnh báo màu vàng ở đầu Hộp thư: “Phiên kết nối Facebook đã hết hạn” hoặc “Cần xác thực lại”.
  • Tin nhắn gửi cho khách có chip màu đỏ: Gửi thất bại.
  • Khách nhắn vào Fanpage nhưng không thấy xuất hiện tin nhắn mới trên TrolyPage.

6 Nguyên nhân ngắt kết nối Facebook thường gặp

Phần tiêu đề “6 Nguyên nhân ngắt kết nối Facebook thường gặp”
Mã sự cố (Issue Code) Lý do chính Hướng giải quyết
token_expired / session_expired Access Token của Facebook User hoặc Fanpage đã hết hạn (thường sau 60 ngày). Nhấp Xác thực lại để mở popup Meta OAuth đăng nhập lại.
reauthorization_required Bạn đã đổi mật khẩu Facebook hoặc đăng xuất trên mọi thiết bị. Đăng nhập lại Facebook và cấp lại quyền cho TrolyPage.
webhook_not_subscribed Webhook đăng ký nhận tin từ Fanpage bị nhả hoặc chưa bật pages_messaging. Mở trang Kênh → Bấm Đăng ký lại Webhook.
refresh_failed Hệ thống tự động làm mới token thất bại do mất kết nối mạng. Bấm nút Làm mới kết nối (refresh).
connection_unavailable Fanpage Facebook bị tạm khóa, đổi tên hoặc bị ẩn khỏi công khai. Kiểm tra lại trạng thái Fanpage trên Meta Business Suite.
channel_disabled Admin trong team chủ động tắt kênh trong TrolyPage. Vào trang Kênh → Bật lại công tắc kích hoạt.

Quy trình 3 bước Khôi phục Kết nối Facebook (Re-authenticate)

Phần tiêu đề “Quy trình 3 bước Khôi phục Kết nối Facebook (Re-authenticate)”
flowchart LR
  ALERT[Cảnh báo ChannelWarningBanner] --> CLICK[❶ Bấm Xác thực lại]
  CLICK --> OAUTH[❷ Mở Popup Meta OAuth]
  OAUTH --> SELECT[❸ Chọn Fanpage & Cấp quyền]
  SELECT --> READY[❹ Webhook tự đăng ký & Hoạt động]
  1. Bấm nút Xem kênh hoặc Xác thực lại (Reauth) trên dải banner cảnh báo.
  2. Hệ thống chuyển sang trang Cài đặt Kênh (/app/channels?channel_type=facebook_msg).
  3. Bấm Kết nối lại Facebook Messenger → Mở popup đăng nhập Facebook:
    • Đảm bảo bạn đang đăng nhập tài khoản Facebook có quyền Quản trị viên (Admin) của Fanpage.
    • Tick chọn đầy đủ các quyền: pages_messaging, pages_manage_metadata, pages_read_engagement.
  4. Xác nhận → Hệ thống tự động lưu token mới và khôi phục webhook ngay lập tức.

Quyền Admin Fanpage

Nếu bạn chỉ là Biên tập viên (Editor) hoặc Nhân viên tư vấn, Meta sẽ từ chối cấp quyền webhook. Bắt buộc phải dùng tài khoản Quản trị viên (Admin) của Page để kết nối.

Bước tiếp theo

Phần tiêu đề “Bước tiếp theo”