Giao diện
Kết nối Fanpage
Trang này để làm gì
Đưa Fanpage vào CNV CDP, theo dõi trạng thái kết nối, xử lý khi token hết hiệu lực hoặc webhook rớt, và xem chi tiết một Fanpage. Đây là việc bắt buộc trước khi dựng bất kỳ kịch bản Facebook nào.
Đường dẫn: → (/application/facebook-channel/list)
Vì sao đây là việc cần làm đầu tiên
Chưa kết nối Fanpage thì:
- Ô Fanpage trong trigger Messenger và trigger bình luận trống, kèm dòng cảnh báo "Chưa có Fanpage nào - kết nối trong menu Facebook trước"
- Meta không gửi tin nhắn và bình luận về CNV CDP, nên không kịch bản nào chạy được
- Không đặt được nút Bắt đầu, lời chào, menu cố định cho Messenger
Màn hình Quản lý kết nối
- Kết nối Fanpage - mở cửa sổ đăng nhập Facebook để thêm Page mới, hoặc kết nối lại Page đã có để làm mới token.
- Kiểm tra webhook - hỏi Meta xem từng Fanpage còn đăng ký nhận tin về CNV CDP không, tự đăng ký lại nếu rớt. Hệ thống cũng tự đối soát định kỳ; nút này để kiểm tra ngay khi nghi ngờ.
- Trạng thái - Hoạt động là bình thường; Hết hiệu lực hoặc Đã thu hồi là token không còn dùng được, cần kết nối lại.
- Webhook - Đã đăng ký nghĩa là Meta đang gửi tin nhắn và bình luận về. Dòng chữ nhỏ bên dưới là kết quả đối soát gần nhất.
- Chi tiết - mở trang chi tiết Fanpage: quyền của token, cấu hình Messenger, số liệu, danh sách khách.
- Messenger - mở hộp thoại cấu hình nút Bắt đầu, lời chào, menu cố định, câu gợi ý mở đầu. Hiện thêm "Bắt đầu: bật" khi Page đã bật nút Bắt đầu.
- Gỡ kết nối - ngắt Page khỏi cửa hàng. Mọi kịch bản dùng Page này ngừng chạy.
Kết nối Fanpage
- Bấm Kết nối Fanpage Nút màu xanh ở góc phải. Lần đầu dùng, màn hình trống cũng có nút này ở giữa trang.
- Đăng nhập Facebook trong cửa sổ popup Dùng tài khoản Facebook có vai trò quản trị trên Fanpage. Nếu máy đã đăng nhập sẵn, Facebook bỏ qua bước này.
- Chọn Page và cấp quyền trên trang của Meta Meta hỏi bạn muốn cho CNV CDP làm việc với Page nào, rồi liệt kê các quyền. Giữ nguyên toàn bộ quyền Meta đề nghị. Bỏ bớt quyền ở bước này là nguyên nhân phổ biến nhất khiến kịch bản không chạy, xem bảng quyền bên dưới.
- Tick Fanpage muốn kết nối Popup đóng lại, CNV CDP hiện hộp thoại Chọn Fanpage muốn kết nối liệt kê các Page bạn vừa cấp quyền, kèm loại Page và ID. Tick những Page cần dùng rồi bấm Kết nối N Page.
- Nhãn Shop khác đang dùng: Page đã kết nối với cửa hàng CNV CDP khác, không chọn được. Cửa hàng kia phải gỡ trước.
- Nhãn Sẽ cập nhật lại token: Page đã có trong danh sách, chọn lại để làm mới token và quyền.
- Kiểm tra kết quả Dòng mới trong bảng phải có trạng thái Hoạt động và webhook Đã đăng ký. Bấm Chi tiết để xem token có đủ quyền không.
Mỗi Fanpage chỉ thuộc về một cửa hàng
Một Page không thể cùng lúc chạy kịch bản của hai cửa hàng CNV CDP. Doanh nghiệp có nhiều cửa hàng trên CNV CDP cần quyết định Page nào thuộc cửa hàng nào trước khi kết nối.
Bốn thao tác trên một Fanpage
| Thao tác | Khi nào dùng | Điều gì xảy ra |
|---|---|---|
| Chi tiết | Muốn xem quyền token, cấu hình Messenger, số liệu, khách đã nhắn | Mở trang chi tiết Fanpage |
| Đăng ký webhook lại | Chỉ hiện khi cột Webhook là Chưa đăng ký | CNV CDP đăng ký lại với Meta để nhận tin nhắn và bình luận |
| Kết nối lại | Chỉ hiện khi trạng thái Hết hiệu lực; cũng dùng khi thiếu quyền | Mở lại cửa sổ Facebook, cấp quyền lại, token mới thay token cũ. Giữ nguyên menu, lời chào, kịch bản |
| Gỡ kết nối | Không dùng Page này trong CNV CDP nữa | Ngắt Page khỏi cửa hàng. Kịch bản dùng Page này ngừng chạy và node trigger báo đỏ "Page đã gỡ kết nối" |
Token hết hiệu lực thì bấm Kết nối lại, đừng Gỡ kết nối
Token Page mất hiệu lực khi người kết nối đổi mật khẩu Facebook, bị Facebook yêu cầu đăng nhập lại, hoặc bị gỡ khỏi vai trò quản trị Page. Lúc đó chỉ cần Kết nối lại bằng tài khoản quản trị Page. Gỡ kết nối rồi kết nối mới sẽ phải cấu hình lại Messenger và chọn lại Page trong mọi kịch bản.
Kiểm tra webhook
Webhook là đường Meta gửi tin nhắn, bình luận về CNV CDP. Thỉnh thoảng nó bị gỡ từ phía Meta, ví dụ khi một ứng dụng khác cũng đăng ký trên Page đó hoặc khi token đổi. CNV CDP tự đối soát định kỳ và tự đăng ký lại; nút Kiểm tra webhook làm việc đó ngay lập tức cho mọi Page trong danh sách.
Dòng kết quả dưới cột Webhook:
| Dòng chữ | Nghĩa | Việc cần làm |
|---|---|---|
| Meta xác nhận lúc … | Bình thường | Không |
| Bị gỡ từ ngoài, đã đăng ký lại lúc … | Webhook từng rớt, CNV CDP đã tự sửa | Tìm xem ứng dụng nào khác đang dùng Page |
| Đang rớt, chưa đăng ký lại được | Đăng ký lại thất bại | Bấm Kết nối lại rồi kiểm tra lại |
| Token hết hiệu lực | Không hỏi được Meta vì token hỏng | Bấm Kết nối lại |
| Chưa đối soát được với Meta | Meta không trả lời | Thử lại sau vài phút |
Trang chi tiết Fanpage
Bấm tên Page hoặc nút Chi tiết để mở. Trang có ba tab: Tổng quan, Số liệu, Lead. Hai tab sau được hướng dẫn ở Khách Facebook và số liệu.
- Đầu trang - tên Page, nhãn trạng thái, nhãn webhook, ID Page, ai kết nối và lúc nào.
- Dải tab - Tổng quan, Số liệu, Lead.
- Messenger profile - tóm tắt nút Bắt đầu, lời chào, số mục menu cố định, số câu gợi ý. Nút Cấu hình mở hộp thoại chỉnh sửa.
- Quyền của token - CNV CDP soi token qua Meta và cho biết token hợp lệ không, thiếu quyền nào, hết hạn khi nào.
Đọc khối Quyền của token
| Thông báo | Nghĩa | Việc cần làm |
|---|---|---|
| Token hợp lệ, đủ quyền nhắn tin và quyền bình luận | Mọi loại kịch bản chạy được | Không |
| Thiếu quyền nhắn tin, kịch bản Messenger không chạy: … | Lúc cấp quyền đã bỏ bớt quyền nhắn tin | Quản lý kết nối → Kết nối lại, giữ nguyên mọi quyền |
| Thiếu quyền bình luận, node bình luận không chạy với page này: … | Token chưa có quyền đọc và trả lời bình luận | Kết nối lại bằng tài khoản quản trị Page |
| Token không còn hiệu lực | Facebook đã vô hiệu token | Kết nối lại, không Gỡ kết nối |
| Chưa soi được token qua Meta | Meta không trả lời lúc này | Tải lại trang sau ít phút |
Bên dưới là hạn của token (thường "Token không có hạn" với token Page) và danh sách quyền đang có.
Các quyền Meta cấp cho CNV CDP
| Quyền | Để làm gì | Thiếu thì mất gì |
|---|---|---|
Xem danh sách Page (pages_show_list) | Liệt kê Page bạn quản trị khi kết nối | Không kết nối được |
Đăng ký webhook (pages_manage_metadata) | Nhận tin nhắn, bình luận về CNV CDP | Không kịch bản nào chạy |
Nhắn tin Messenger (pages_messaging) | Bot gửi tin trong Messenger | Kịch bản Messenger không gửi được tin |
Đọc tương tác Page (pages_read_engagement) | Đọc bài viết, tương tác của Page | Không chọn được bài viết cho trigger bình luận |
Quản lý tài sản doanh nghiệp (business_management) | Làm việc với Page thuộc Business Manager | Page trong Business không hiện khi kết nối |
Đọc bình luận của khách (pages_read_user_content) | Nhận bình luận của khách dưới bài viết | Trigger bình luận im lặng |
Trả lời, thích, ẩn bình luận (pages_manage_engagement) | Fanpage trả lời, thích, ẩn bình luận | Bốn hành động bình luận thất bại |
Lỗi thường gặp
| Hiện tượng | Nguyên nhân | Cách xử lý |
|---|---|---|
| Bấm Kết nối Fanpage không thấy gì xảy ra | Trình duyệt chặn popup | Cho phép popup cho hub.cnvcdp.com rồi bấm lại |
| Cửa sổ Facebook mở nhưng không thấy Page của mình | Tài khoản đăng nhập không có vai trò quản trị Page, hoặc đã bỏ tick Page ở bước chọn Page của Meta | Đăng nhập đúng tài khoản admin; bấm Kết nối Fanpage lại và chọn Page trong cửa sổ Meta |
| Page hiện nhãn "Shop khác đang dùng" | Page đã kết nối với cửa hàng CNV CDP khác | Gỡ ở cửa hàng kia trước |
| Trạng thái Hoạt động nhưng khách nhắn bot không trả lời | Webhook chưa đăng ký, hoặc chưa có kịch bản đang chạy | Bấm Kiểm tra webhook; xem Xử lý sự cố |
| Trạng thái chuyển sang Hết hiệu lực | Người kết nối đổi mật khẩu, bị gỡ quyền admin, hoặc Facebook thu hồi | Bấm Kết nối lại |
| Khối Quyền của token báo thiếu quyền bình luận | Lúc cấp quyền đã bỏ hai quyền về bình luận | Kết nối lại, giữ nguyên mọi quyền Meta hỏi |