Referencia de respuestas rápidas

Las respuestas rápidas te permiten obtener información del destinatario si envías botones en los mensajes. Cuando alguien toca una respuesta rápida, el valor del botón se envía a la conversación y la plataforma de Messenger envía un evento messages a tu webhook. Las respuestas rápidas son un tipo de mensaje que se envía a través de la API de envío. Para obtener detalles completos sobre cómo enviar mensajes, consulta Mensajes.

Para obtener detalles completos sobre el uso, consulta Respuestas rápidas.

Ejemplo de solicitud

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/v21.0/me/messages?access_token=<PAGE_ACCESS_TOKEN>"

Ejemplo de respuesta

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

Propiedades

Propiedad	Tipo	Descripción
`text`	Cadena	Texto de mensaje no vacío que se enviará con las respuestas rápidas. Se debe configurar `text` o `attachment`.
`attachment`	Objeto	Un adjunto que se enviará con las respuestas rápidas. Se debe configurar `text` o `attachment`.
`quick_replies`	Matriz<`quick_reply`>	Una matriz de objetos que describe los botones de respuesta rápida que se enviarán. Se permite un máximo de 13 respuestas rápidas.

`quick_reply`

Propiedad	Tipo	Descripción
`content_type`	Cadena	Debe ser alguna de las siguientes opciones: `text`: envía un botón con texto. `user_phone_number`: envía un botón que permite al destinatario enviar el número de teléfono asociado a su cuenta. `user_email`: envía un botón que permite al destinatario enviar el correo electrónico asociado a su cuenta.
`title`	Cadena	Es obligatoria si `content_type` es "text". El texto que se muestra en el botón de respuesta rápida. Tiene un límite de 20 caracteres.
`payload`	Cadena, número	Es obligatoria si `content_type` es "text". Datos personalizados que se devolverán mediante el evento de webhook `messaging_postbacks`. Tiene un límite de 1.000 caracteres. Se puede configurar una cadena vacía si se configuró `image_url`.
`image_url`	Cadena	*Opcional.* La URL de la imagen que se mostrará en el botón de respuesta rápida en el caso de las respuestas rápidas de texto. El tamaño mínimo de la imagen es de 24 x 24 píxeles. Las imágenes más grandes se recortarán y redimensionarán de manera automática. Se requiere si `title` es una cadena vacía.