Referencia sobre respuestas rápidas

Con las respuestas rápidas puedes incluir botones en un mensaje, lo que te permite obtener información del destinatario. Cuando se toca una respuesta rápida, el valor del botón se envía en 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 mediante la Send API. Consulta Mensajes para obtener más información sobre el envío de mensajes.

Consulta Respuestas rápidas para obtener más información sobre su uso.

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/v19.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 del mensaje con contenido que se envía con las respuestas rápidas. Debe especificarse text o attachment.

attachment

Objeto

Archivo adjunto que se envía con las respuestas rápidas. Debe especificarse text o attachment.

quick_replies

Matriz<quick_reply>

Matriz de objetos que describe los botones de respuesta rápida que se envían. Se admite un máximo de 13 respuestas rápidas.

quick_reply

Propiedad Tipo Descripción

content_type

Cadena

Debe ser una de las opciones siguientes:

  • text: envía un botón de 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 la dirección de correo electrónico asociada a su cuenta.

title

Cadena

Obligatoria si el valor de content_type es “text”. Texto que se muestra en el botón de respuesta rápida. Límite de 20 caracteres.

payload

Cadena, número

Obligatoria si el valor de content_type es “text”. Datos personalizados que se te devolverán mediante el evento messaging_postbacks del webhook. Límite de 1000 caracteres.


Si se establece image_url, puede definirse como una cadena vacía.

image_url

Cadena

Opcional. URL de la imagen que se muestra en el botón de respuesta rápida para respuestas rápidas de texto. La imagen debe ser de 24 x 24 px como mínimo. Las imágenes que excedan dicho tamaño se recortarán y ajustarán automáticamente.


Obligatoria si title es una cadena vacía.