Chuyển tới nội dung chính

Tích hợp Facebook Messenger

Hướng dẫn toàn diện về cách kết nối, cấu hình và sử dụng Facebook Messenger trong campaign.

Tổng quan​

Facebook Messenger là gì?​

Facebook Messenger là nền tảng nhắn tin của Facebook, cho phép:

  • Giao tiếp với khách hàng qua Facebook Page
  • Nhận tin nhắn từ khách hàng
  • Gửi tin nhắn, hình ảnh, video
  • Tự động hóa với chatbot

Lợi ích khi tích hợp​

1. Tiếp cận khách hàng rộng​

  • 🌍 Hơn 1.3 tỷ người dùng Messenger
  • 📱 Khách hàng đã quen thuộc
  • 💬 Tỷ lệ mở tin nhắn cao (80%+)

2. Tập trung quản lý​

  • 📊 Tất cả tin nhắn ở một nơi
  • 👥 Team cùng trả lời
  • 📈 Theo dõi và báo cáo

3. Tự động hóa​

  • 🤖 Chatbot trả lời tự động
  • ⚡ Phản hồi nhanh 24/7
  • 💰 Giảm chi phí nhân sự

Yêu cầu trước khi kết nối​

1. Tài khoản Facebook​

Bạn cần có:

  • ✅ Tài khoản Facebook cá nhân
  • ✅ Tài khoản đã xác thực (verified)
  • ✅ Không bị khóa hoặc hạn chế

Kiểm tra:

  1. Đăng nhập Facebook
  2. Vào Settings → Security
  3. Kiểm tra account status

2. Facebook Page​

Yêu cầu:

  • ✅ Có Facebook Page
  • ✅ Bạn là Admin hoặc Editor của Page
  • ✅ Page đã được publish (không phải draft)
  • ✅ Page không bị vi phạm chính sách

Kiểm tra quyền:

  1. Vào Page của bạn
  2. Click Settings
  3. Click Page Roles
  4. Kiểm tra role của bạn (phải là Admin hoặc Editor)

3. Messenger được bật​

Kiểm tra:

  1. Vào Page → Settings
  2. Click Messaging
  3. Đảm bảo "Allow people to contact my Page privately" = ON

4. Tuân thủ chính sách​

Facebook Messaging Policy:

  • ✅ Không spam
  • ✅ Không gửi nội dung vi phạm
  • ✅ Tuân thủ 24h messaging window
  • ✅ Có quyền gửi tin nhắn cho khách

Đọc thêm: Facebook Messaging Policy

Quy trình Kết nối​

Bước 1: Truy cập Integration Tab​

  1. Vào Campaign Setup
  2. Click tab "Integration"
  3. Tìm Facebook Messenger Card

Giao diện Facebook Card:

┌─────────────────────────────────┐
│ 📘 Facebook Messenger │
│ │
│ Status: Not Connected │
│ │
│ [Connect Facebook] │
└─────────────────────────────────┘

Bước 2: Click "Connect Facebook"​

  1. Click nút "Connect Facebook"
  2. Popup OAuth sẽ mở ra
  3. Nếu chặn popup, cho phép popup từ domain này

Popup OAuth:

┌─────────────────────────────────┐
│ Đăng nhập Facebook │
│ │
│ Email: ___________________ │
│ Password: ________________ │
│ │
│ [Đăng nhập] │
└─────────────────────────────────┘

Bước 3: Đăng nhập Facebook​

Option 1: Chưa đăng nhập​

  1. Nhập Email/SĐT
  2. Nhập Mật khẩu
  3. Click "Đăng nhập"

Option 2: Đã đăng nhập​

  • Facebook tự động nhận diện
  • Bỏ qua bước đăng nhập
  • Chuyển thẳng sang bước tiếp theo

Lưu ý:

  • Đảm bảo đăng nhập đúng tài khoản có quyền Admin Page
  • Nếu sai tài khoản, đăng xuất và đăng nhập lại

Bước 4: Cấp quyền cho App​

Màn hình xin quyền:

┌─────────────────────────────────────────┐
│ VNBot muốn truy cập tài khoản của bạn │
│ │
│ ✅ Quản lý và truy cập tin nhắn Page │
│ Cho phép đọc và gửi tin nhắn │
│ │
│ ✅ Hiển thị danh sách Pages │
│ Xem Pages bạn quản lý │
│ │
│ ✅ Đọc tương tác trên Page │
│ Xem comments, reactions │
│ │
│ [Hủy] [Tiếp tục] │
└─────────────────────────────────────────┘

Các quyền được yêu cầu:

1. pages_messaging​

  • Mục đích: Gửi và nhận tin nhắn
  • Bắt buộc: Có
  • Nếu không cấp: Không thể nhắn tin

2. pages_show_list​

  • Mục đích: Hiển thị danh sách Pages
  • Bắt buộc: Có
  • Nếu không cấp: Không chọn được Page

3. pages_read_engagement​

  • Mục đích: Đọc tương tác (comments, reactions)
  • Bắt buộc: Không
  • Nếu không cấp: Không xem được engagement

4. pages_manage_metadata​

  • Mục đích: Quản lý metadata của Page
  • Bắt buộc: Có
  • Nếu không cấp: Webhook không hoạt động

Thao tác:

  1. Review các quyền
  2. Click "Tiếp tục" hoặc "Continue"
Quan trọng

Phải cấp TẤT CẢ quyền được yêu cầu. Nếu bỏ qua quyền nào, kết nối sẽ thất bại.

Bước 5: Chọn Facebook Page​

Màn hình chọn Page:

┌─────────────────────────────────────────┐
│ Chọn Page để kết nối │
│ │
│ ☐ Shop Thời Trang ABC │
│ ID: 123456789 │
│ Followers: 10,000 │
│ │
│ ☐ Nhà Hàng XYZ │
│ ID: 987654321 │
│ Followers: 5,000 │
│ │
│ [Hủy] [Tiếp theo] │
└─────────────────────────────────────────┘

Thông tin mỗi Page:

  • Avatar: Ảnh đại diện Page
  • Name: Tên Page
  • Page ID: ID của Page
  • Followers: Số lượng followers
  • Checkbox: Chọn Page

Thao tác:

  1. Chọn Page muốn kết nối (có thể chọn nhiều)
  2. Click "Tiếp theo" hoặc "Next"

Lưu ý:

  • Chỉ hiển thị Pages bạn là Admin/Editor
  • Nếu không thấy Page, kiểm tra quyền
  • Có thể chọn nhiều Pages cùng lúc
Không thấy Page?

Nguyên nhân:

  • Bạn không phải Admin/Editor
  • Page chưa được publish
  • Đăng nhập sai tài khoản

Giải pháp:

  1. Kiểm tra role trên Page
  2. Publish Page nếu đang draft
  3. Đăng xuất và đăng nhập lại

Bước 6: Xác nhận kết nối​

Màn hình xác nhận:

┌─────────────────────────────────────────┐
│ Xác nhận kết nối │
│ │
│ Pages được chọn: │
│ • Shop Thời Trang ABC │
│ │
│ Campaign: Campaign Tết 2024 │
│ │
│ Quyền được cấp: │
│ ✅ Gửi và nhận tin nhắn │
│ ✅ Xem danh sách Pages │
│ ✅ Đọc tương tác │
│ ✅ Quản lý metadata │
│ │
│ [Quay lại] [Kết nối] │
└─────────────────────────────────────────┘

Thao tác:

  1. Review thông tin
  2. Click "Kết nối" hoặc "Connect"

Hệ thống thực hiện:

  1. ⏳ Lưu access token
  2. ⏳ Đăng ký webhook với Facebook
  3. ⏳ Kiểm tra kết nối
  4. ⏳ Subscribe các events
  5. ✅ Hoàn thành

Thời gian: 5-10 giây

Bước 7: Kiểm tra kết nối thành công​

Dấu hiệu thành công:

┌─────────────────────────────────────────┐
│ ✅ Kết nối thành công! │
│ │
│ Page "Shop Thời Trang ABC" đã được │
│ kết nối với campaign. │
│ │
│ Bạn có thể bắt đầu nhận tin nhắn từ │
│ khách hàng ngay bây giờ. │
│ │
│ [Đóng] [Xem chi tiết] │
└─────────────────────────────────────────┘

Kiểm tra trong Integration Tab:

┌─────────────────────────────────────────┐
│ 📘 Facebook Messenger │
│ │
│ Status: 🟢 Connected │
│ │
│ Connected Pages: │
│ • Shop Thời Trang ABC │
│ Status: Active │
│ Webhook: Active │
│ │
│ [Manage] [Disconnect] │
└─────────────────────────────────────────┘

Kiểm tra Webhook:

  1. Scroll xuống Webhook Status Panel
  2. Kiểm tra:
    • Webhook URL: Hiển thị
    • Status: 🟢 Active
    • Last Received: (sẽ có sau khi nhận tin nhắn đầu tiên)