Tạo ứng dụng Facebook và kết nối Trang vào ChatHub
Tạo ứng dụng Meta đúng loại, nối Trang Facebook, lấy App ID, App Secret và token quản trị rồi khai vào ChatHub để nhận tin nhắn Messenger.
Bài này giải quyết việc gì#
Để ChatHub nhận và trả lời tin nhắn Messenger của một Trang Facebook, bạn cần một ứng dụng Meta của chính mình. ChatHub không dùng ứng dụng chung: mỗi hệ thống tự khai ứng dụng riêng, nên bạn không phải chờ Meta xét duyệt và một Trang gặp sự cố cũng không kéo theo hệ thống khác.
Bạn khai ứng dụng một lần cho cả hệ thống, sau đó thêm bao nhiêu Trang cũng được. App Secret dùng chung vì nó thuộc về ứng dụng; riêng token của từng Trang thì ChatHub tự hỏi Meta, bạn không phải đi lấy thủ công.
1. Tạo ứng dụng trên Meta for Developers#
- 1
Mở developers.facebook.com, đăng nhập bằng tài khoản Facebook đang quản trị Trang.
- 2
Vào mục Ứng dụng của tôi rồi bấm Tạo ứng dụng.
- 3
Ở bước Chi tiết ứng dụng, đặt Tên ứng dụng theo thương hiệu của bạn. Tên này hiện ra khi người dùng cấp quyền, nên tránh đặt tên thử nghiệm.
- 4
Kiểm tra Email liên hệ: Meta gửi cảnh báo vi phạm và thông báo chính sách về địa chỉ này.
2. Chọn đúng trường hợp sử dụng Messenger#
Đây là bước quyết định. Meta cấp quyền theo trường hợp sử dụng bạn khai lúc tạo, và một ứng dụng đã tạo cho việc khác thì không thêm Messenger vào sau được.
- 1
Sang bước Trường hợp sử dụng, ở cột Lọc theo chọn nhóm Nhắn tin doanh nghiệp.
- 2
Tích vào Tương tác với khách hàng trên Messenger from Meta, rồi bấm Tiếp.
- 3
Bước Doanh nghiệp có thể bỏ qua nếu danh sách trống; bạn nối hồ sơ doanh nghiệp sau cũng được.
- 4
Ở bước Tổng quan, đọc lại rồi bấm Tạo ứng dụng. Meta sẽ hỏi lại mật khẩu Facebook của bạn trước khi tạo.
3. Lấy App ID và App Secret#
- 1
Trong ứng dụng vừa tạo, mở Cài đặt ứng dụng rồi chọn Thông tin cơ bản.
- 2
Chép ID ứng dụng. Đây là giá trị công khai, không phải bí mật.
- 3
Ở ô Khóa bí mật của ứng dụng, bấm Hiển thị rồi chép giá trị. Meta sẽ hỏi lại mật khẩu.
4. Nối Trang Facebook vào ứng dụng#
Trang phải được nối vào ứng dụng thì ChatHub mới nhìn thấy và mới nhận được webhook của Trang đó.
- 1
Trong ứng dụng, mở Trường hợp sử dụng rồi bấm Tùy chỉnh ở dòng Messenger.
- 2
Chọn Cài đặt API Messenger ở cột trái.
- 3
Kéo tới mục Tạo mã truy cập rồi bấm Kết nối, hoặc Thêm trang nếu đã có Trang trong danh sách.
- 4
Đăng nhập Facebook trong cửa sổ vừa mở, chọn các Trang muốn dùng và xác nhận cấp quyền.
5. Lấy token của tài khoản quản trị#
ChatHub dùng token này đúng một việc: hỏi Meta xem bạn quản lý những Trang nào và lấy token riêng của từng Trang. Token của Trang lấy theo đường này không hết hạn, nên token quản trị hết hạn sau đó cũng không làm rụng kênh nào đang chạy.
- 1
Mở Công cụ rồi chọn Trình khám phá API Đồ thị; ở ô Ứng dụng trên Meta, chọn đúng ứng dụng vừa tạo.
- 2
Trong phần Quyền, thêm ba quyền: pages_show_list, pages_messaging và pages_manage_metadata.
- 3
Bấm Generate Access Token, xác nhận cấp quyền cho các Trang, rồi chép mã truy cập vừa sinh ra.
6. Khai ứng dụng vào ChatHub#
- 1
Trong ChatHub, mở Cài đặt rồi chọn nhóm Kênh.
- 2
Tìm thẻ Ứng dụng Facebook, điền App ID, App Secret và Token người quản trị.
- 3
Bấm Lưu. Nhãn ở góc phải thẻ chuyển sang Đã cấu hình.
- 4
Ngay dưới ba ô đó là mục Khai webhook sang Meta, mang sẵn Callback URL và Verify Token kèm nút Chép. Hai giá trị này dùng chung cho cả hệ thống nên không nằm trong từng kênh.
7. Thêm Trang thành kênh và khai webhook#
- 1
Trong Cài đặt → Kênh, chép Callback URL và Verify Token ở mục Khai webhook sang Meta.
- 2
Sang Cài đặt API Messenger của ứng dụng, dán hai giá trị vào ô URL gọi lại và Xác minh mã rồi bấm Xác minh và lưu. Bước này chỉ làm một lần cho cả ứng dụng.
- 3
Trong bảng Trường webhook ngay dưới ô vừa lưu, gạt công tắc Đăng ký cho đúng ba trường messages, messaging_postbacks và message_echoes. Bỏ bước này là Meta không gửi tin nào về, dù mọi thứ khác đều xanh.
- 4
Về ChatHub, mở trang Kênh, bấm Thêm tài khoản rồi chọn loại Facebook.
- 5
Danh sách Trang bạn quản lý hiện ra sẵn; chọn Trang muốn kết nối rồi bấm Tạo tài khoản.
- 6
Bấm Kết nối trên kênh vừa tạo. Thêm Trang thứ hai chỉ cần lặp lại hai bước cuối, không phải khai lại webhook.
8. Khai URL chính sách và bật chế độ Live#
Xong bảy bước trên, ChatHub và Meta đã nối đúng nhau, nhưng ứng dụng mới tạo luôn nằm ở chế độ Phát triển. Ở chế độ đó Meta chỉ gửi webhook cho người có vai trò trong ứng dụng: bạn nhắn thử bằng tài khoản quản trị thì tin về bình thường, còn khách thật nhắn tới Trang lại không sinh sự kiện nào — kênh vẫn hiện Đã kết nối mà hộp thư vẫn trống.
- 1
Trong ChatHub, vào Cài đặt → Kênh, kéo xuống mục Khai webhook sang Meta và bấm Chép ở dòng URL chính sách quyền riêng tư. ChatHub tự phục vụ trang này tại đường dẫn /privacy của hệ thống, mở được khi chưa đăng nhập nên trình thu thập của Meta đọc được.
- 2
Sang ứng dụng Meta, mở Cài đặt ứng dụng → Thông tin cơ bản, dán địa chỉ vừa chép vào ô URL chính sách quyền riêng tư rồi bấm Lưu thay đổi. Ô này còn trống thì Meta vô hiệu hoá nút Đăng.
- 3
Trong menu bên trái của ứng dụng, mở Đăng, xem lại các trường hợp sử dụng rồi bấm Đăng ở góc dưới bên phải. Khi phát hành thành công, dòng Đăng hiện nhãn Đã đăng; không bấm Hủy đăng sau đó.
- 4
Mở Xét duyệt ứng dụng → Quyền và tính năng, kiểm tra pages_messaging đang ở mức Quyền truy cập nâng cao. Còn ở mức Chuẩn thì hoàn tất Xác minh doanh nghiệp cho Danh mục doanh nghiệp chứa ứng dụng, hoặc nộp hồ sơ xét duyệt cho quyền này.
- 5
Nhờ một tài khoản không có vai trò nào trong ứng dụng nhắn thử vào Trang. Tin phải hiện trong hộp thư ChatHub sau vài giây.
Những giới hạn cần biết trước#
Messenger chỉ cho trả lời tự do trong 24 giờ kể từ tin nhắn cuối của khách. Quá hạn, Facebook từ chối tin gửi đi cho tới khi khách nhắn lại. ChatHub hiện cảnh báo ngay trên ô nhập khi sắp hết và khi đã hết giờ, còn ghi chú nội bộ thì vẫn lưu được bình thường.
Vài điểm khác của nền tảng: Messenger không có trích dẫn khi gửi đi, không gửi được nhãn dán tuỳ ý, và nút bấm phải đi kèm một tin có chữ nên tệp gửi trần không kèm chú thích sẽ không có chỗ gắn nút.