Tài liệu tham khảo về mẫu nút

Mẫu nút cho phép bạn gửi một tin nhắn có cấu trúc bao gồm văn bản và nút. Để biết chi tiết triển khai đầy đủ, hãy xem Mẫu nút.

URI yêu cầu

https://graph.facebook.com/v21.0/me/messages?access_token=<PAGE_ACCESS_TOKEN>

Yêu cầu mẫu

curl -X POST -H "Content-Type: application/json" -d '{
  "recipient":{
    "id":"<PSID>"
  },
  "message":{
    "attachment":{
      "type":"template",
      "payload":{
        "template_type":"button",
        "text":"What do you want to do next?",
        "buttons":[
          {
            "type":"web_url",
            "url":"https://www.messenger.com",
            "title":"Visit Messenger"
          },
          {
            ...
          },
          {...}
        ]
      }
    }
  }
}' "https://graph.facebook.com/v2.6/me/messages?access_token=<PAGE_ACCESS_TOKEN>"

Phản hồi mẫu

{
  "recipient_id": "1254477777772919",
  "message_id": "AG5Hz2Uq7tuwNEhXfYYKj8mJEM_QPpz5jdCK48PnKAjSdjfipqxqMvK8ma6AC8fplwlqLP_5cgXIbu7I3rBN0P"
}

Thuộc tính

`recipient`

Mô tả về người nhận tin nhắn. Tất cả yêu cầu phải bao gồm một trong các id, phone_number hoặc user_ref.

Thuộc tính	Loại	Mô tả
`recipient.id`	Chuỗi	`PSID`, `phone_number` hoặc `user_ref` của người nhận tin nhắn.
`recipient.phone_number`	Chuỗi	*Tùy chọn.* Số điện thoại của người nhận có định dạng +1(212)555-2368. Bot của bạn phải được phê duyệt cho tính năng Khớp khách hàng để gửi tin nhắn theo cách này.
`recipient.user_ref`	Chuỗi	*Tùy chọn.*`user_ref` từ plugin hộp kiểm.
`recipient.name`	Đối tượng	*Tùy chọn.* Chỉ sử dụng nếu đặt `phone_number`. Chỉ định tên của người dùng theo định dạng: `{"first_name":"John", "last_name":"Doe"}` Cung cấp tên sẽ giúp tăng tỷ lệ khớp thành công.

`message`

Description of the message to be sent.

Property	Type	Description
`message.attachment`	Object	An object describing attachments to the message.

`message.attachment`

Property	Type	Description
`type`	String	Value must be `template`
`payload`	Object	`payload` của mẫu.

`message.attachment.payload`

Thuộc tính	Loại	Mô tả
`template_type`	Chuỗi	Giá trị phải là `button`
`text`	Chuỗi	Văn bản được mã hóa UTF-8 chứa tối đa 640 ký tự. Văn bản sẽ xuất hiện phía trên nút.
`buttons`	Mảng<button>	Nhóm gồm 1-3 nút hiển thị dưới dạng nút kêu gọi hành động.