Plugin Gửi đến Messenger

Khi ứng dụng của bạn trên Facebook ở Chế độ phát triển, chỉ quản trị viên, nhà phát triển và người dùng thử của ứng dụng có phiên hợp lệ mới có thể dùng chức năng plugin và API. Sau khi ứng dụng của bạn được phê duyệt và ở chế độ công khai, mọi người đều có thể dùng ứng dụng này.

Plugin "Gửi đến Messenger" được dùng để kích hoạt sự kiện xác thực cho webhook của bạn. Bạn có thể chuyển dữ liệu vào để biết người dùng và giao dịch nào được liên kết với sự kiện xác thực rồi liên kết người dùng đó trên chương trình phụ trợ của mình.

Khi một người nhấp vào nút này lần đầu tiên, cửa sổ bật lên để xác nhận sẽ được hiển thị.

Yêu cầu

Facebook Javascript SDK

Để sử dụng plugin gửi đến Messenger, bạn phải thêm Facebook SDK dành cho Javascript vào trang sẽ hiển thị plugin đó.

Để biết hướng dẫn về cách thêm SDK này, hãy xem hướng dẫn Bắt đầu nhanh Facebook SDK dành cho Javascript.

Thiết lập

<div class="fb-send-to-messenger" 
  messenger_app_id="<APP_ID>" 
  page_id="PAGE_ID" 
  data-ref="<PASS_THROUGH_PARAM>" 
  color="<blue | white>" 
  size="<standard | large | xlarge>">
</div>

Để biết mô tả đầy đủ về các thuộc tính hiện có, hãy xem tài liệu tham khảo về plugin gửi đến Messenger.

Đăng ký sự kiện

Đăng ký sự kiện plugin.

<script>

      FB.Event.subscribe('send_to_messenger', function(e) {
      // callback for events triggered by the plugin

      });

      </script>

Trường sự kiện

Tên trường	Loại	Mô tả
`event`	Enum	Tên sự kiện. Các giá trị có thể: `rendered`, `clicked`, `not_you`, `opt_in`.
`ref`	Chuỗi	Chứa tập hợp giá trị trên thông số `data-ref` của plugin. Chỉ hỗ trợ các ký tự chữ và số, cũng như "-", "_" và "=".
`is_after_optin`	Boolean	Cho biết liệu sự kiện có diễn ra sau khi cửa sổ bật lên để xác nhận được xác nhận hay không.
`pluginID`	không xác định	Trường này không được sử dụng.

Sự kiện webhook

Plugin gửi đến Messenger sẽ kích hoạt sự kiện webhook messaging_optins.

Tùy chỉnh hành vi đăng nhập

Nếu không có người dùng Facebook nào đã đăng nhập, plugin này sẽ hiển thị mà không hiện danh tính người dùng. Khi nhấp vào nút này, hệ thống sẽ nhắc người dùng đăng nhập.

Nếu bạn đặt allow_login là false thì plugin sẽ không hiển thị với người dùng chưa đăng nhập.

Lưu ý rằng plugin này sẽ hiển thị mà không cần phiên Facebook chỉ khi ứng dụng được phê duyệt và công khai.

Tùy chọn văn bản CTA

Plugin Gửi đến Messenger cũng hỗ trợ thuộc tính cta_text. Với thuộc tính này, bạn có thể chọn văn bản nút cho plugin từ danh sách các chuỗi được xác định trước. Khi sử dụng thuộc tính cta_text, hầu hết người dùng đã đăng nhập sẽ chỉ phải nhấp vào nút plugin này để chọn tham gia, mà không cần xác nhận lại với cửa sổ bật lên và sự kiện messaging_optins sẽ được phân phối ngay lập tức.

Các giá trị sau đây được hỗ trợ cho thuộc tính cta_text:

GET_THIS_IN_MESSENGER
RECEIVE_THIS_IN_MESSENGER
SEND_THIS_TO_ME
GET_CUSTOMER_ASSISTANCE
GET_CUSTOMER_SERVICE
GET_SUPPORT
LET_US_CHAT
SEND_ME_MESSAGES
ALERT_ME_IN_MESSENGER
SEND_ME_UPDATES
MESSAGE_ME
LET_ME_KNOW
KEEP_ME_UPDATED
TELL_ME_MORE
SUBSCRIBE_IN_MESSENGER
SUBSCRIBE_TO_UPDATES
GET_MESSAGES
SUBSCRIBE
GET_STARTED_IN_MESSENGER
LEARN_MORE_IN_MESSENGER
GET_STARTED