Câu hỏi thường gặp

Tài liệu này cung cấp câu trả lời cho các câu hỏi thường gặp.

Chung

Bạn có thể cài đặt ứng dụng từ trang web của ứng dụng bằng cách dùng tính năng Đăng nhập bằng Facebook và cấp quyền pages_messaging cho một Trang cụ thể. Ứng dụng được ủy quyền sẽ hiển thị trong phần Cài đặt Trang ở mục Nhắn tin nâng cao.

Có, một ứng dụng Facebook có thể đăng ký nhiều trang. Khi xem xét ứng dụng, như quyền pages_messaging, ứng dụng có thể đăng ký để nhận webhook trên nhiều trang. Bạn tự quyết định việc nhận ngữ cảnh của mỗi webhook dựa theo phần tải dữ liệu.

Được, bạn có thể đăng ký nhiều ứng dụng cho một trang. Khi nhiều ứng dụng xử lý cùng một cuộc trò chuyện, cách tốt nhất là dùng Giao thức chuyển giao để xử lý việc bot nào làm chủ chuỗi trò chuyện tại một thời điểm nhất định.

Quy định chung về bảo vệ dữ liệu (GDPR)

Điểm bắt đầu

Khi sử dụng plugin “Gửi đến Messenger”, bạn có thể sử dụng thông số data-ref dưới dạng thông số chuyển qua để gửi qua bất kỳ thông tin nào liên quan đến ngữ cảnh của lần nhấp.

Mọi người cũng có thể khám phá trang của bạn thông qua tìm kiếm trong Messenger. Trong các trường hợp này, bạn sẽ không có thông số chuyển qua. Bạn có thể sử dụng tính năng liên kết tài khoản để liên kết cuộc trò chuyện với tài khoản người dùng trên trang web của mình.

Khi ứng dụng ở chế độ phát triển, chỉ quản trị viên, nhà phát triển và người thử nghiệm ứng dụng mới có thể xem plugin. Sau khi ứng dụng được xét duyệt và phê duyệt, bạn làm cho ứng dụng hiển thị công khai trong tab Xét duyệt ứng dụng trong Bảng điều khiển ứng dụng.

API Thông báo một lần

No. Unlike subscriptions where a business can send multiple messages to people on a recurring basis, the one-time notification API limits the business to a single message per user request. If the person engages with the message, the standard messaging window will reopen.

Yes. Pages interested in using the One-time Notification API need to apply for permission. Go to the Advanced Messaging section of your Page Settings and consent to the terms. A Page will be granted permission if the Page meets our criteria.

Common uses of the API include various promotional and non-promotional use cases where the User explicitly requested a follow-up. Examples include:

  • Back in stock alerts
  • Collection launches
  • Concert tickets going on sale
  • Price drop alerts
  • Train tickets available for purchase
  • CSAT surveys

Your Page is not allowed to send a notification on a topic for which the User has not agreed to receive a notification. Please see the Usage and Restrictions and Limitations sections of the One-time Notification guide for more information.

A Page can send multiple requests however, the 24-hour policy will be applied to all the requests being sent. We also have controls in place to prevent spamming users with multiple requests.

The 24 hour standard messaging window will open only if the user interacts with the opt-in message. The behavior is consistent with interactions with other elements in the Messenger experience.

Once a person asks to be notified, the Page will receive a token which is equivalent to a permission to send a single message to the person. The token can be used to send a message to the person outside the 24 hour window. The token can only be used once and unused tokens will expire within 1 year of creation.

Yes. However, while it is possible to send another notification request using an existing token, there is no clear benefit for the business to send these type of requests.

No. The app does not need to specify any message tags when sending a message outside the 24-hour standard messaging window using this API.

API Gửi/Nhận

Có nhiều lý do khiến điều này có thể xảy ra:

  • Bạn đang sử dụng ID từ Đăng nhập Facebook. ID người dùng từ Đăng nhập Facebook không được dùng để hoạt động với API Gửi/Nhận. Chỉ những ID người dùng có được thông qua quá trình xác thực với Nền tảng Messenger mới hoạt động với Nền tảng Messenger.
  • Bạn đang sử dụng ID với mã truy cập trang không chính xác. ID người dùng cho Nền tảng Messenger nằm trong một trang và do đó dành riêng cho trang. Nếu bạn sử dụng ID người dùng hợp lệ nhưng với mã truy cập trang được liên kết với trang khác, lệnh gọi sẽ không hoạt động. Hãy nhớ sử dụng ID người dùng và mã truy cập trang được liên kết với cùng trang.
  • Bạn đang gửi tới số điện thoại chưa được xác minh gần đây. Khi sử dụng API Gửi với số điện thoại, chúng tôi sẽ chỉ gửi tin nhắn nếu số điện thoại đã được xác minh gần đây. Ngay cả khi số điện thoại được hiển thị là đã xác minh nhưng chưa được xác minh gần đây, thì có thể không gửi được tin nhắn. Hãy xác minh lại số điện thoại và chờ 24 giờ rồi thử lại.

Sau đây là cách sử dụng người dùng thử nghiệm nền tảng để tích hợp nền tảng Messenger:

  1. Từ trang Vai trò của ứng dụng, hãy tạo người dùng thử nghiệm mới bằng cách nhấp vào nút Thêm.
  2. Chuyển đổi tùy chọn Cho phép người dùng thử nghiệm của ứng dụng này? đồng thời cấp quyền "manage_pages""page_messaging".
  3. Sử dụng nút Chỉnh sửa và nhận mã truy cập cho người dùng này (dùng phiên bản 2.6). Hãy lưu để sử dụng sau.
  4. Sử dụng nút Chỉnh sửa để đăng nhập với tư cách người dùng thử nghiệm.
  5. Sau khi đăng nhập, hãy tạo một trang với tư cách người dùng thử nghiệm.
  6. Sử dụng mã truy cập người dùng cho người dùng thử nghiệm để nhận mã truy cập trang cho người dùng này. Bạn có thể thực hiện việc này bằng lệnh gọi sau:
    https://graph.facebook.com/v2.6/me/accounts?access_token=[TEST_USER_ACCESS_TOKEN]
    (Tài liệu)
  7. Sử dụng mã truy cập trang này để liên kết ứng dụng Facebook với Trang của bạn:
    https://graph.facebook.com/v2.6/me/subscribed_apps?method=POST&access_token=[TEST_USER_PAGE_ACCESS_TOKEN]
            
    (Tài liệu)
  8. Sau khi đã làm theo các bước này, bạn sẽ nhận được cập nhật RTU cho Trang thử nghiệm của mình và sẽ có thể nhắn tin cho người dùng thử nghiệm từ Trang thử nghiệm. Ngoài ra, bạn có thể thay thế mã truy cập bằng mã dài hạn nếu chúng hết hạn quá sớm khiến bạn không thể thử nghiệm. Vui lòng làm theo tài liệu tại đây:
    GET /oauth/access_token?  
        grant_type=fb_exchange_token&           
        client_id={app-id}&
        client_secret={app-secret}&
        fb_exchange_token={short-lived-token} 
            

Có, bot có thể bao gồm cả hai loại nhắn tin. Một người phải kích hoạt tính năng nhắn tin nền tảng tiêu chuẩn thông qua một trong các trình kích hoạt đủ điều kiện và cần chọn nhận nhắn tin đăng ký.

Về mặt kỹ thuật, Bot sẽ không thể nhắn tin cho người dùng nhiều lần trong thời gian 24 giờ (tin nhắn sẽ không được gửi). Trong thời gian chuyển tiếp cho bot hiện tại, những tin nhắn này sẽ chuyển qua nhưng sẽ bị gắn cờ nếu được tìm thấy.

Không, Nền tảng Messenger không cung cấp API trả về danh sách PSID gồm tất cả những người đã chọn nhận tin nhắn từ bot của bạn.

Webhooks

Có 2 bước để nhận được hồi đáp. Thứ nhất, hãy đảm bảo webhook của bạn được thiết lập đúng cách (https://developers.facebook.com/docs/messenger-platform/webhook-reference#setup). Chỉ báo sẽ xuất hiện khi webhook được thiết lập đúng cách.

Thứ hai, bạn phải đăng ký từng trang. Mọi trang được đăng ký đều sẽ được liệt kê.

Nếu lệnh gọi tới webhook của bạn không thực hiện được trong thời gian dài, ứng dụng của bạn sẽ bị hủy đăng ký và bạn sẽ phải thêm lại webhook cũng như đăng ký lại trang của mình.

Lệnh gọi đến webhook chứa một trường trong tiêu đề có tên là Chữ ký X-Hub. Trường này có thể được dùng để xác thực rằng lệnh gọi đến từ Facebook.

Đảm bảo webhook của bạn đang phản hồi với mã trạng thái 200. Điều này cho chúng tôi biết rằng bạn đã nhận thành công webhook. Nếu bạn không trả về mã 200, chúng tôi sẽ thử lại lệnh gọi cho đến khi thành công. Đồng thời, nếu webhook không trả về mã 200 trong thời gian dài, chúng tôi sẽ hiển thị cảnh báo nhà phát triển.

Ngoài ra, hãy lưu ý rằng mã trạng thái thành công được trả về kịp thời. Lệnh gọi webhook sẽ hết thời gian chờ sau 20 giây. Hãy nhớ cấu trúc mã sao cho webhook được xử lý không đồng bộ để mã trạng thái thành công có thể được trả về ngay lập tức và xử lý riêng biệt.

Có một công cụ cho biết các lỗi gần đây xảy ra với webhook. Nếu webhook không phân phối được, các máy chủ của Facebook sẽ hủy đăng ký URL của bạn. Để tìm công cụ này, hãy vào Bảng điều khiển ứng dụng > Messenger > Cài đặt, bên trong thẻ Webhooks, có một nút tên là Hiển thị lỗi gần đây

Xem thêm