Nền tảng Messenger

Tài liệu tham khảo về plugin web

Nền tảng Messenger cung cấp loạt plugin web thuận tiện giúp bạn dễ dàng bắt đầu cuộc trò chuyện với những người truy cập trang web của bạn. Tất cả plugin đều được triển khai bằng Facebook SDK dành cho Javascript.

Plugin Chat với khách hàng (beta)

Thông qua plugin chat với khách hàng của Nền tảng Messenger, bạn có thể tích hợp trực tiếp bot Messenger vào trang web của mình. Nhờ đó, khách hàng có thể tương tác với doanh nghiệp của bạn bất cứ lúc nào bằng trải nghiệm dành riêng, đa phương tiện giống như trong Messenger.

Để biết thông tin chi tiết về cách sử dụng, hãy xem Plugin Chat với khách hàng.

Bao gồm định dạng

<div class="fb-customerchat"
 page_id="<PAGE_ID>">
</div>

Thuộc tính

Thuộc tính Loại Mô tả

class

String

Giá trị phải là fb-customerchat.

page_id

String

ID trang của bạn

ref

String

Không bắt buộc. Chuỗi tùy chỉnh được chuyển cho webhook của bạn trong các sự kiện messaging_postbacks và messaging_referrals.

theme_color

String

Không bắt buộc. Màu sẽ dùng làm chủ đề cho plugin, bao gồm màu nền của biểu tượng plugin chat với khách hàng và màu nền của mọi tin nhắn do người dùng gửi. Hỗ trợ mọi mã màu thập lục phân có ký hiệu số đứng đầu (ví dụ: #0084FF), trừ màu trắng. Bạn nên chọn màu có độ tương phản cao với màu trắng.

logged_in_greeting

String

Không bắt buộc. Nội dung lời chào sẽ hiển thị nếu người dùng hiện đã đăng nhập Facebook. Tối đa 80 ký tự.

logged_out_greeting

String

Không bắt buộc. Nội dung lời chào sẽ hiển thị nếu người dùng hiện không đăng nhập Facebook. Tối đa 80 ký tự.

greeting_dialog_display

String

Không bắt buộc. Đặt cách hiển thị hộp thoại lời chào. Dưới đây là các giá trị được hỗ trợ:


  • show: Hộp thoại lời chào sẽ luôn hiển thị khi tải plugin.
  • fade: Hộp thoại lời chào của plugin sẽ hiển thị rồi mờ dần và ở trạng thái ẩn sau đó.
  • hide: Hộp thoại lời chào của plugin sẽ luôn ẩn cho đến khi người dùng nhấp vào plugin này.

Giá trị mặc định là show trên máy tính và hide trên di động.

greeting_dialog_delay

String

Không bắt buộc. Đặt số giây trì hoãn trước khi hộp thoại lời chào hiển thị sau khi tải plugin. Thuộc tính này có thể được dùng để tùy chỉnh thời điểm bạn muốn hiển thị hộp thoại lời chào.

minimized

Boolean

Thông báo ngừng hoạt động

Thuộc tính này hiện đã ngừng hoạt động. Vui lòng sử dụng greeting_dialog_display để tùy chỉnh plugin của bạn. Thuộc tính greeting_dialog_delay sẽ được ưu tiên hơn so với thuộc tính minimized.

Không bắt buộc.

  • true Khi đặt thành true, thuộc tính này sẽ có hiệu ứng giống như khi đặt greeting_dialog_delay = "fade".
  • false Khi đặt thành false, thuộc tính này sẽ có hiệu ứng giống như khi đặt greeting_dialog_delay = "show".

Plugin Nhắn tin cho chúng tôi

Đưa người dùng vào thẳng cuộc trò chuyện trên Messenger.

Để biết thông tin chi tiết về cách sử dụng, hãy xem Plugin Nhắn tin cho chúng tôi.

Bao gồm định dạng

<div class="fb-messengermessageus" 
  messenger_app_id="<APP_ID>" 
  page_id="<PAGE_ID>"
  color="<blue | white>"
  size="<standard | large | xlarge>">
</div>

Thuộc tính

Thuộc tính Thuộc tính HTML5 Loại Mô tả

class

String

Giá trị phải là fb-messengermessageus.

page_id

String

ID trang của bạn

messenger_app_id

Số

ID ứng dụng của bạn trên Facebook.

color

data-color

String

Màu nút: blue hoặc white.


Giá trị mặc định là blue.

size

data-size

String

Kích thước nút: standard, large hoặc xlarge.


Giá trị mặc định là large.

ref

String

Không bắt buộc. Chuỗi tùy chỉnh được chuyển cho webhook của bạn trong các sự kiện messaging_postbacks và messaging_referrals.

Plugin Gửi đến Messenger

Gửi tin nhắn cho một người từ bot Messenger trong nền và cho họ chọn tham gia.

Để biết thông tin chi tiết về cách sử dụng, hãy xem Plugin Gửi đến Messenger.

Bao gồm định dạng

<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>

Thuộc tính

Thuộc tính Loại Mô tả

class

String

Giá trị phải là fb-send-to-messenger.

page_id

String

ID trang của bạn

messenger_app_id

Số

ID ứng dụng của bạn trên Facebook.

color

String

Không bắt buộc. Màu nút: blue hoặc white.


Giá trị mặc định là blue.

size

String

Không bắt buộc. Kích thước nút: standard, large hoặc xlarge.


Giá trị mặc định là large.

ref

String

Không bắt buộc. Thông số trạng thái tùy chỉnh. Tối đa 250 ký tự.


Các ký tự hợp lệ là a-z A-Z 0-9 +/=-._


Bạn cần lập mã và mã hóa thông số này vì mục đích bảo mật.

enforce_login

Boolean

Không bắt buộc. Nếu true, người dùng đã đăng nhập phải đăng nhập lại khi nhấp vào nút. Giá trị mặc định là false.

Sử dụng thông số ref để chuyển trạng thái bằng cách xác thực. Nếu đặt plugin ở nhiều vị trí, bạn nên sửa đổi trạng thái dựa theo vị trí hiển thị plugin.

Plugin Ô để đánh dấu

Plugin ô để đánh dấu đăng ký người dùng với bot Messenger như một phần trong mẫu, chẳng hạn như thanh toán hoặc đăng ký.

Để biết thông tin chi tiết về cách sử dụng, hãy xem Plugin Ô để đánh dấu.

Bao gồm định dạng

<div class="fb-messenger-checkbox"  
  origin=<PAGE_DOMAIN>
  page_id=<PAGE_ID>
  messenger_app_id=<APP_ID>
  user_ref="<UNIQUE_REF_PARAM>"
  allow_login="<true>"
  size="<small | medium | large | standard | xlarge>"
  skin="<light|dark>"
  center_align="<true|false>">
</div>

Thuộc tính

Thuộc tính Loại Mô tả

class

String

Giá trị phải là fb-messenger-checkbox

page_id

Số

ID Trang Facebook được liên kết với bot của bạn.

messenger_app_id

Số

ID ứng dụng của bạn trên Facebook.

user_ref

String

Thông số duy nhất để tham chiếu người dùng. Tối đa 250 ký tự.


Các ký tự hợp lệ là a-z A-Z 0-9 +/=-._

allow_login

Boolean

Không bắt buộc. Cho phép mọi người đăng nhập nếu không có phiên hiện tại nào. Giá trị mặc định là true.

size

String

Không bắt buộc. Kích thước plugin: small, medium, large, standard, xlarge.


Giá trị mặc định là large.

skin

String

Không bắt buộc. Đặt chủ đề màu cho nội dung plugin. Hỗ trợ các tùy chọn sau:

  • light: Plugin hiển thị có văn bản tối màu.
  • dark: Plugin hiển thị có văn bản màu trắng, biểu tượng Messenger trong suốt và tia chớp màu trắng.

Giá trị mặc định là light.

center_align

Boolean

Không bắt buộc. Đặt xem có cần căn giữa nội dung plugin hay không.


Giá trị mặc định là false.