Nút

Hầu hết mẫu tin nhắn cũng như menu cố định đều hỗ trợ các nút để gọi những loại hành động khác nhau. Các nút này cho phép bạn dễ dàng cung cấp cho người nhận tin nhắn các hành động họ có thể thực hiện để phản hồi mẫu, chẳng hạn như mở chế độ xem web của Messenger, bắt đầu quy trình thanh toán, gửi tin nhắn đăng lại tới webhook của bạn và hơn thế nữa.

Đối với mẫu tin nhắn, các nút được xác định theo đối tượng trong mảng buttons. Đối với menu cố định, các nút được xác định theo đối tượng trong mảng call_to_actions.

Nút URL

Nút URL mở ra một trang web trong chế độ xem web của Messenger. Điều này cho phép bạn làm phong phú cuộc trò chuyện với trải nghiệm dựa trên web, trong đó bạn có thể tận dụng hoàn toàn tính linh hoạt phát triển của web. Ví dụ: bạn có thể hiển thị tóm tắt sản phẩm trong cuộc trò chuyện, sau đó sử dụng nút URL để mở trang sản phẩm đầy đủ trên trang web của mình.

Liên kết ứng dụng

Nếu trang web chứa Liên kết ứng dụng, nút này sẽ khởi chạy ứng dụng gốc được chỉ định.

Trình thu thập dữ liệu của Facebook cần đọc các thẻ meta của liên kết ứng dụng thì mới chuyển hướng được. Lưu ý rằng nếu chỉ triển khai các thẻ trên trang web của mình, bạn có thể dùng Công cụ gỡ lỗi chia sẻ để yêu cầu lượt quét mới. Sau khi trình thu thập dữ liệu quét thông tin trên trang web, các nút URL mới đã gửi sẽ thực hiện chuyển hướng.

Cách sử dụng được hỗ trợ

Nút URL được hỗ trợ để sử dụng với các mục sau:

• Menu cố định
• Mẫu chung
• Mẫu danh sách
• Mẫu nút
• Mẫu file phương tiện

SDK tiện ích Messenger - Yêu cầu đưa miền vào danh sách cho phép

Định dạng nút

Để biết danh sách đầy đủ các thuộc tính nút, hãy xem tài liệu tham khảo về nút URL.

{
  "type": "web_url",
  "url": "

Nút đăng lại

Nút đăng lại gửi sự kiện messaging_postbacks đến webhook của bạn bằng loạt chuỗi trong thuộc tính payload. Nhờ đó, bạn có thể thực hiện các hành động tùy ý khi nhấn vào nút này. Ví dụ: bạn có thể hiển thị danh sách các sản phẩm, sau đó gửi ID sản phẩm trong yêu cầu đăng lại tới webhook của mình. Tại đây, ID này có thể được dùng để truy vấn cơ sở dữ liệu của bạn và trả về thông tin chi tiết sản phẩm dưới dạng tin nhắn có cấu trúc.

Cách sử dụng được hỗ trợ

Nút đăng lại được hỗ trợ để sử dụng với các mục sau:

• Menu ổn định
• Mẫu chung
• Mẫu danh sách
• Mẫu nút
• Mẫu file phương tiện

Định dạng nút

Để biết danh sách đầy đủ các thuộc tính nút, hãy xem tài liệu tham khảo về nút đăng lại.

{
  "type": "postback",
  "title": "

Nút Gọi

Nút gọi sẽ quay số điện thoại khi nhấn vào. Số điện thoại phải ở định dạng +<COUNTRY_CODE><PHONE_NUMBER>, ví dụ: +15105559999.

Cách sử dụng được hỗ trợ

Nút gọi được hỗ trợ để sử dụng với các mục sau:

• Mẫu chung
• Mẫu danh sách
• Mẫu nút
• Mẫu file phương tiện

Định dạng nút

Để biết danh sách đầy đủ các thuộc tính nút, hãy xem tài liệu tham khảo về nút gọi.

{
  "type":"phone_number",
  "title":"

Nút Đăng nhập

Nút đăng nhập được sử dụng trong quy trình liên kết tài khoản, cho phép bạn liên kết danh tính của người nhận tin nhắn trên Messenger với tài khoản của họ trên trang web của bạn bằng cách chuyển họ đến quy trình đăng nhập dựa trên web để xác thực.

Để biết thêm thông tin về cách sử dụng nút đăng nhập cho mục đích liên kết tài khoản, hãy xem phần Liên kết tài khoản.

Cách sử dụng được hỗ trợ

Nút đăng nhập được hỗ trợ để sử dụng với các mục sau:

• Mẫu chung
• Mẫu danh sách
• Mẫu nút
• Mẫu file phương tiện

Định dạng nút

Để biết danh sách đầy đủ các thuộc tính nút, hãy xem tài liệu tham khảo về nút đăng nhập.

{
  "type": "account_link",
  "url": "

Nút Đăng xuất

Nút đăng xuất được sử dụng trong quy trình liên kết tài khoản để hủy liên kết danh tính của người nhận tin nhắn trên Messenger khỏi tài khoản của họ trên trang web của bạn.

Để biết thêm thông tin về cách sử dụng nút đăng xuất cho mục đích hủy liên kết tài khoản, hãy xem phần Liên kết tài khoản.

Cách sử dụng được hỗ trợ

Nút đăng xuất được hỗ trợ để sử dụng với các mục sau:

• Mẫu chung
• Mẫu danh sách
• Mẫu nút
• Mẫu file phương tiện

Định dạng nút

Để biết danh sách đầy đủ các thuộc tính nút, hãy xem tài liệu tham khảo về nút đăng xuất.

{
  "type": "account_unlink"
}

Nút Chơi game

Nút chơi game sẽ khởi chạy Trò chơi tức thì được liên kết với Trang Facebook của bạn. Để tùy chỉnh cách mở game, bạn có thể đặt thuộc tính payload trong yêu cầu sẽ được gửi đến game khi khởi chạy, cũng như dưới dạng thuộc tính game_metadata.player_id hoặc game_metadata.context_id không bắt buộc. Thuộc tính này cho phép bot của bạn bắt đầu game trong ngữ cảnh cụ thể dựa theo một người chơi hoặc một nhóm hiện có.

Định dạng nút

Thuộc tính payload phải là JSON được nối tiếp hóa. SDK Trò chơi tức thời sẽ hủy nối tiếp hóa thuộc tính này.

Để biết danh sách đầy đủ các thuộc tính nút, hãy xem Tài liệu tham khảo về nút Chơi game.

{
  "type":"game_play",
  "title":"Play",
  "payload":"{<SERIALIZED_JSON_PAYLOAD>}",
  "game_metadata": { // Only one of the below
    "player_id": "<PLAYER_ID>",
    "context_id": "<CONTEXT_ID>"
  }
}

Hãy tham khảo sự kiện webhook Chơi game để biết sự kiện sẽ được gửi đến bot khi người dùng hoàn tất một vòng chơi.

Cách làm tốt nhất