Hướng dẫn sử dụng Cấu hình Facebook Messenger

Tài liệu này hướng dẫn ADMIN và HEAD cấu hình Facebook Messenger để tích hợp với hệ thống CRM.

Tổng quan

Chức năng này cho phép:

• Tự động gửi sự kiện chuyển đổi về Facebook khi có khách hàng mới hoặc khách hàng chuyển trạng thái HOT/SUPERHOT

• Tự động tạo khách hàng từ tin nhắn Facebook Messenger

• Tracking chính xác hiệu quả quảng cáo Facebook Ads

• Mỗi team có thể cấu hình riêng Facebook Page và Access Token của mình

Yêu cầu trước khi cấu hình

Trước khi bắt đầu, bạn cần có:

1. Facebook Page ID: ID của Facebook Page mà team bạn sử dụng

2. Facebook Page Access Token: Token để truy cập Facebook Page API

Cách lấy Facebook Page ID

Cách 1: Từ Facebook Page Settings

1. Đăng nhập vào Facebook và truy cập Facebook Page của bạn

2. Click vào "Settings" (Cài đặt) ở menu bên trái

3. Click vào "Page Info" (Thông tin trang)

4. Scroll xuống tìm "Page ID" - đây là ID bạn cần

Cách 2: Từ URL Facebook Page

1. Truy cập Facebook Page của bạn

2. Click vào "About" (Giới thiệu)

3. Scroll xuống phần "Page Info"

4. Tìm "Page ID" - đây là một dãy số (ví dụ: 123456789012345)

Cách 3: Sử dụng Graph API Explorer

1. Truy cập Graph API Explorer

2. Chọn app của bạn (nếu có)

3. Nhập query: me?fields=id,name

4. Click "Submit"

5. Kết quả sẽ hiển thị id - đây là Page ID

Cách lấy Facebook Page Access Token

Bước 1: Truy cập Facebook Developer App

1. Truy cập Facebook Developers

2. Chọn app đã được ADMIN tạo (hoặc liên hệ ADMIN để tạo app)

3. Vào "Messenger" → "Settings"

Bước 2: Lấy Page Access Token

Có 2 cách để lấy Access Token:

Cách 1: Page Access Token (Tạm thời, hết hạn sau 60 ngày)

1. Trong phần "Access Tokens", tìm Facebook Page của bạn

2. Click "Generate Token" (nếu chưa có) hoặc copy token hiện có

3. Lưu token này an toàn - bạn sẽ cần nó để cấu hình trong CRM

Lưu ý:

• Token có thể hết hạn sau một thời gian (thường 60 ngày)

• Nếu token hết hạn, bạn cần tạo token mới và cập nhật lại trong CRM

• Khuyến nghị: Sử dụng System User Token (Cách 2) để token không hết hạn

Cách 2: System User Token (Khuyến nghị - Không hết hạn)

System User Token là loại token không hết hạn, an toàn hơn và phù hợp cho production.

Bước 1: Tạo System User

1. Truy cập Facebook Business Settings

2. Vào "System Users" (Người dùng hệ thống) ở menu bên trái

3. Click "Add" (Thêm) → "Create New System User"

4. Điền thông tin:

   • System User Name: Tên mô tả (ví dụ: "CRM Integration - Team A")

   • System User Role: Chọn "Admin" hoặc "Employee"

5. Click "Create System User"

Bước 2: Assign Permissions cho System User

1. Sau khi tạo System User, click vào System User vừa tạo

2. Click "Assign Assets" (Gán tài sản)

3. Chọn "Pages" → Chọn Facebook Page của bạn

4. Chọn quyền:

   • ✅ "Manage Page" (Quản lý trang)

   • ✅ "View Page Insights" (Xem thông tin trang)

5. Click "Save Changes"

Bước 3: Generate Token cho System User

1. Vẫn trong trang System User, click tab "Generate New Token"

2. Chọn App mà ADMIN đã tạo (hoặc app của bạn)

3. Chọn Permissions (Quyền):

   • ✅ pages_messaging - Để nhận tin nhắn từ Messenger

   • ✅ pages_events - Để gửi conversion events

   • ✅ pages_read_engagement - Để đọc thông tin trang

4. Click "Generate Token"

5. Copy token ngay lập tức - Token chỉ hiển thị một lần duy nhất!

6. Lưu token này an toàn - Đây là token không hết hạn

⚠️ QUAN TRỌNG:

• System User Token KHÔNG HẾT HẠN - Bạn chỉ cần tạo một lần

• Token chỉ hiển thị một lần khi tạo - Hãy copy và lưu ngay

• Nếu mất token, bạn cần tạo lại System User Token mới

• System User Token an toàn hơn vì không liên kết với tài khoản cá nhân

Bước 4: Verify Token (Tùy chọn)

Để kiểm tra token có hoạt động không:

1. Truy cập Graph API Explorer

2. Chọn app của bạn

3. Paste System User Token vào "Access Token"

4. Nhập query: me?fields=id,name

5. Click "Submit"

6. Nếu thấy thông tin Page, nghĩa là token hoạt động đúng

So sánh 2 loại token:

Tính năng	Page Access Token	System User Token
Thời hạn	60 ngày	Không hết hạn ✅
Bảo mật	Trung bình	Cao ✅
Dễ tạo	Dễ	Phức tạp hơn
Khuyến nghị	Development/Test	Production ✅

Bước 3: Kiểm tra quyền của Token

Token cần có các quyền sau:

• pages_messaging: Để nhận tin nhắn từ Messenger

• page_events: Để gửi conversion events

Nếu token thiếu quyền, liên hệ ADMIN để yêu cầu thêm quyền.

Cách cấu hình trong CRM

Bước 1: Truy cập trang cấu hình

1. Đăng nhập vào CRM với tài khoản HEAD hoặc ADMIN

2. Vào menu "Cài đặt Facebook" (hoặc truy cập /dashboard/settings/facebook)

3. Nếu bạn là HEAD, trang sẽ tự động hiển thị team của bạn

Bước 2: Điền thông tin cấu hình

Facebook Page ID (Bắt buộc)

1. Nhập Facebook Page ID mà bạn đã lấy ở bước trên

2. Ví dụ: 123456789012345

3. Click vào "?" để xem hướng dẫn tìm Page ID

Facebook Access Token (Bắt buộc)

1. Nhập Facebook Page Access Token mà bạn đã lấy ở bước trên

2. Token sẽ được mã hóa và lưu an toàn trong database

3. Token không được hiển thị lại sau khi lưu (vì lý do bảo mật)

Facebook Dataset ID (Tùy chọn)

1. Để trống - Hệ thống sẽ tự động tạo Dataset ID khi bạn click "Kiểm tra kết nối"

2. Hoặc nhập Dataset ID nếu bạn đã tạo sẵn trong Events Manager

Webhook Verify Token (Tùy chọn)

1. Chỉ cần nếu bạn muốn nhận tin nhắn từ Messenger

2. Tạo một token ngẫu nhiên (ví dụ: my-verify-token-123)

3. Token này sẽ được dùng để verify webhook từ Facebook

Bước 3: Kiểm tra kết nối

1. Sau khi điền thông tin, click "Kiểm tra kết nối"

2. Hệ thống sẽ:

   • Kiểm tra Access Token có hợp lệ không

   • Lấy thông tin Facebook Page (tên, ID)

   • Tự động tạo Dataset ID nếu chưa có

   • Cập nhật thời gian xác minh cuối cùng

3. Nếu thành công, bạn sẽ thấy:

   • ✅ Thông báo "Đã xác minh kết nối"

   • Tên Facebook Page

   • Dataset ID (nếu được tạo tự động)

4. Nếu thất bại, kiểm tra:

   • Access Token có đúng không

   • Token có hết hạn không

   • Page ID có đúng không

   • Token có đủ quyền không

Bước 4: Lưu cấu hình

1. Click "Lưu" hoặc "Cập nhật" (nếu đã có cấu hình trước đó)

2. Hệ thống sẽ lưu cấu hình và mã hóa Access Token

3. Bạn sẽ thấy thông báo "Đã lưu cấu hình Facebook"

Bước 5: Kích hoạt cấu hình

1. Bật toggle "Kích hoạt" để bật/tắt gửi events đến Facebook

2. Khi bật, hệ thống sẽ tự động:

   • Gửi LeadSubmitted event khi có khách hàng mới từ quảng cáo

   • Gửi QualifiedLead event khi khách hàng chuyển sang HOT/SUPERHOT

   • Gửi QualifiedLead event khi có hợp đồng được chốt

Các sự kiện tự động gửi về Facebook

1. LeadSubmitted Event

Khi nào gửi:

• Khi tạo khách hàng mới với source = 'AD' (từ quảng cáo)

• Khi khách hàng có facebookClickId hoặc facebookPsid

Thông tin gửi:

• Page ID

• PSID (nếu có)

• Click ID (nếu có)

2. QualifiedLead Event

Khi nào gửi:

• Khi khách hàng chuyển trạng thái sang HOT hoặc SUPERHOT

• Khi có hợp đồng được chốt thành công (status = 'COMPLETED')

Thông tin gửi:

• Page ID

• PSID (nếu có)

• Click ID (nếu có)

• Giá trị hợp đồng (nếu có)

3. Tự động tạo khách hàng từ Messenger

Khi nào:

• Khi có tin nhắn từ Facebook Messenger

• Tin nhắn có chứa số điện thoại

Hệ thống sẽ:

• Tự động extract số điện thoại từ tin nhắn

• Tạo khách hàng mới nếu chưa có

• Tự động assign cho user trong team (ưu tiên HEAD)

• Gửi LeadSubmitted event

Quản lý cấu hình

Xem cấu hình hiện tại

1. Vào trang "Cài đặt Facebook"

2. Nếu đã có cấu hình, bạn sẽ thấy:

   • Trạng thái: Đã kích hoạt / Chưa kích hoạt

   • Thời gian xác minh cuối cùng

   • Người cấu hình

   • Thời gian cấu hình

Cập nhật cấu hình

1. Vào trang "Cài đặt Facebook"

2. Điền thông tin mới (Access Token, Page ID, etc.)

3. Click "Cập nhật"

4. Hệ thống sẽ cập nhật cấu hình mới

Lưu ý: Access Token không được hiển thị lại sau khi lưu. Nếu muốn cập nhật, bạn cần nhập lại token mới.

Xóa cấu hình

1. Vào trang "Cài đặt Facebook"

2. Click "Xóa" (nút màu đỏ)

3. Xác nhận xóa

4. Hệ thống sẽ xóa cấu hình và không gửi events nữa

Kiểm tra events trong Facebook Events Manager

Sau khi cấu hình, bạn có thể kiểm tra events trong Facebook Events Manager:

1. Truy cập Events Manager

2. Chọn "Data Sources" → Chọn dataset của bạn

3. Vào tab "Test Events" để xem events real-time

4. Vào tab "Overview" để xem thống kê events

Test Events

Để test xem events có được gửi không:

1. Tạo một khách hàng mới với source = 'AD'

2. Hoặc thay đổi trạng thái khách hàng sang HOT

3. Kiểm tra trong "Test Events" tab

4. Nếu thấy event, nghĩa là cấu hình đã hoạt động!

Xử lý lỗi thường gặp

Lỗi: "Invalid access token"

Nguyên nhân:

• Access Token không đúng

• Token đã hết hạn

• Token không có quyền page_events

Cách khắc phục:

1. Tạo lại Access Token trong Facebook Developer App

2. Cập nhật token mới trong CRM

3. Kiểm tra token có đủ quyền không

Lỗi: "Page not found"

Nguyên nhân:

• Page ID không đúng

• Page không tồn tại hoặc đã bị xóa

Cách khắc phục:

1. Kiểm tra lại Page ID

2. Đảm bảo Page vẫn tồn tại và bạn có quyền truy cập

Lỗi: "Permission denied"

Nguyên nhân:

• Token không có quyền page_events

• App chưa được approve quyền page_events

Cách khắc phục:

1. Liên hệ ADMIN để yêu cầu approve quyền page_events

2. Hoặc sử dụng token có đủ quyền

Events không hiển thị trong Events Manager

Nguyên nhân:

• Dataset ID chưa được tạo

• Events không được gửi đúng format

• Events bị duplicate (cùng event_id)

Cách khắc phục:

1. Click "Kiểm tra kết nối" để tự động tạo Dataset ID

2. Kiểm tra logs trong console để xem lỗi chi tiết

3. Đảm bảo events có event_id unique

Webhook không nhận được tin nhắn

Nguyên nhân:

• Webhook chưa được cấu hình trong Facebook Developer App

• Verify Token không đúng

• Page chưa được subscribe events

Cách khắc phục:

1. Liên hệ ADMIN để cấu hình webhook trong Facebook Developer App

2. Đảm bảo Verify Token trong CRM khớp với token trong Facebook App

3. Đảm bảo Page đã được subscribe events: messages, messaging_postbacks

Best Practices

1. Bảo mật Access Token:

   • Không chia sẻ Access Token với người khác

   • Rotate token định kỳ (khuyến nghị 60 ngày)

   • Sử dụng System User Token cho production (liên hệ ADMIN)

2. Kiểm tra định kỳ:

   • Kiểm tra kết nối mỗi tuần

   • Kiểm tra events trong Events Manager

   • Kiểm tra token có hết hạn không

3. Xử lý lỗi:

   • Kiểm tra logs khi có lỗi

   • Liên hệ ADMIN nếu không thể tự khắc phục

   • Backup cấu hình trước khi thay đổi

4. Tối ưu hóa:

   • Chỉ bật cấu hình khi thực sự cần

   • Tắt cấu hình khi không sử dụng để tránh gửi events không cần thiết

Hỗ trợ

Nếu gặp vấn đề:

1. Kiểm tra tài liệu này trước

2. Kiểm tra logs trong console (F12 → Console)

3. Liên hệ ADMIN nếu không thể tự khắc phục

FAQ

Q: Tôi có thể cấu hình nhiều Facebook Page cho một team không?

A: Không, mỗi team chỉ có thể cấu hình một Facebook Page. Nếu cần nhiều Page, bạn có thể tạo nhiều team.

Q: Access Token hết hạn sau bao lâu?

A:

• Page Access Token: Hết hạn sau 60 ngày

• System User Token: KHÔNG HẾT HẠN ✅

Khuyến nghị: Sử dụng System User Token để tránh phải cập nhật token định kỳ. Xem hướng dẫn tạo System User Token ở phần "Cách 2: System User Token" trong tài liệu này.

Q: Tôi có thể xem lại Access Token sau khi lưu không?

A: Không, vì lý do bảo mật, token được mã hóa và không hiển thị lại. Nếu cần cập nhật, bạn cần nhập token mới.

Q: Events có được gửi ngay lập tức không?

A: Có, events được gửi ngay khi có sự kiện (tạo khách hàng, thay đổi trạng thái, chốt hợp đồng).

Q: Tôi có thể tắt gửi events mà không xóa cấu hình không?

A: Có, bạn có thể tắt toggle "Kích hoạt" để tạm thời dừng gửi events.

Q: Dataset ID là gì và tại sao cần?

A: Dataset ID là ID của dataset trong Facebook Events Manager, nơi lưu trữ conversion events. Hệ thống sẽ tự động tạo nếu bạn để trống.