BỞI: DPS.MEDIA

Cấu hình tích hợp Facebook Messenger cho Chatwoot

Để sử dụng kênh Facebook, bạn cần tạo một ứng dụng Facebook trong cổng nhà phát triển. Dưới đây là các bước thiết lập chi tiết cho bản Self-hosted.


1. Điều kiện tiên quyết

  • Tài khoản Facebook hợp lệ.
  • Trang (Page) Facebook đang hoạt động.

2. Đăng ký ứng dụng Facebook

Truy cập Facebook Developer Portal và bấm nút “Create App”.

Tạo ứng dụng Facebook

Các bước thiết lập loại ứng dụng:

    • Chọn tùy chọn “Other”.
Chọn loại Other

 

    • Ở loại ứng dụng (app type), chọn “Business”.
Chọn Business App

 

    • Nhập các thông tin cơ bản như tên ứng dụng và email liên hệ.
Nhập thông tin ứng dụng

 

Sau khi đăng ký, hãy lưu lại App IdApp Secret trong phần cài đặt để sử dụng cho Chatwoot.

Lấy App ID và Secret

 

3. Cấu hình biến môi trường trong Chatwoot

Cập nhật các giá trị sau vào file cấu hình của bạn. FB_VERIFY_TOKEN nên là một chuỗi ký tự ngẫu nhiên và bảo mật.

FB_VERIFY_TOKEN=your_secure_token
FB_APP_SECRET=your_facebook_app_secret
FB_APP_ID=your_facebook_app_id

* Đừng quên khởi động lại máy chủ Chatwoot sau khi cập nhật.

4. Cấu hình Facebook Login

Thêm sản phẩm Facebook Login trong bảng điều khiển ứng dụng.

Thêm Facebook Login

 

Bật Web OAuth Login, Login with Javascript SDK và điền tên miền của bạn vào ô Allowed Domains.

Cấu hình SDK Login

 

5. Thiết lập Messenger và Webhook

Thêm tên miền cài đặt Chatwoot vào App Domain trong phần cài đặt chung.

Cấu hình App Domain

 

Thêm sản phẩm Messenger và cấu hình Callback URL.

Thêm Messenger Product

 

Điền Callback URL theo dạng: {domain_cua_ban}/bot và nhập Verify token tương ứng.

Cấu hình Callback URL

 

Cảnh báo: Đảm bảo phiên bản subscription của ứng dụng Facebook là 17.0. Hãy cập nhật trong tùy chọn Webhooks nếu cần thiết.

6. Đưa vào Production

Trước khi hoạt động chính thức, bạn cần yêu cầu Quyền truy cập nâng cao cho các mục sau:

  • pages_messaging (Nhắn tin thay mặt trang)
  • pages_show_list (Liệt kê các trang)
  • pages_manage_metadata (Đăng ký webhook)
  • business_management
  • pages_read_engagement (Đọc dữ liệu hồ sơ người dùng)
Phiên bản API

 

DPS.MEDIA