快速回复参考文档

借助快速回复，您可以通过在消息中发送按钮来获取消息接收人输入的信息。轻触快速回复后，系统将在对话中发送按钮的值，同时 Messenger 开放平台会向您的 Webhooks 发送 messages 事件。快速回复消息是一种利用 Send API 发送的消息。有关发送消息的完整详情，请参阅消息。

有关使用方法的完整详情，请参阅快速回复。

请求示例

curl -X POST -H "Content-Type: application/json" -d '{
  "recipient":{
    "id":"<PSID>"
  },
  "messaging_type": "RESPONSE",
  "message":{
    "text": "Pick a color:",
    "quick_replies":[
      {
        "content_type":"text",
        "title":"Red",
        "payload":"<POSTBACK_PAYLOAD>",
        "image_url":"http://example.com/img/red.png"
      },{
        "content_type":"text",
        "title":"Green",
        "payload":"<POSTBACK_PAYLOAD>",
        "image_url":"http://example.com/img/green.png"
      }
    ]
  }
}' "https://graph.facebook.com/v19.0/me/messages?access_token=<PAGE_ACCESS_TOKEN>"

响应示例

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

属性

属性	类型	描述
`text`	字符串	待使用快速回复发送的非空消息文本。必须设置 `text` 或 `attachment`。
`attachment`	对象	待使用快速回复发送的附件。必须设置 `text` 或 `attachment`。
`quick_replies`	Array<`quick_reply`>	描述待发送快速回复按钮的一个对象数组。最多支持 13 条快速回复消息。

`quick_reply`

属性	类型	描述
`content_type`	字符串	必须是以下类型之一 `text`：发送文本按钮 `user_phone_number`：发送一个按钮，让消息接收人可以发送与其帐户绑定的手机号。 `user_email`：发送一个按钮，让消息接收人可以发送与其帐户绑定的邮箱。
`title`	字符串	如果 `content_type` 为“text”，则必须设置此属性。该文本将显示在快速回复按钮上。不得超过 20 个字符。
`payload`	字符串，数值	如果 `content_type` 为“text”，则必须设置此属性。将通过 `messaging_postbacks` Webhooks 事件向您发回的自定义数据。不得超过 1,000 个字符。如果设置了 `image_url`，可将此属性设为一个空字符串。
`image_url`	字符串	*可选。*将在文本快速回复按钮上显示的图片的网址。图片大小不低于 24 X 24 像素。如果图片过大，系统会自动进行裁剪并调整大小。如果 `title` 为空字符串，则必须设置此属性。