Respuestas rápidas

Las respuestas rápidas permiten presentar un conjunto de hasta 13 botones en la conversación. Contienen un título y una imagen opcional, y aparecen en un lugar destacado encima del editor. También puedes usar las respuestas rápidas para solicitar la ubicación, la dirección de correo electrónico o el número de teléfono de una persona.

Cuando se toca una respuesta rápida, los botones desaparecen y el título del botón que se ha tocado se publica en la conversación como un mensaje. Se enviará un evento messages al webhook que contiene el título del botón y una carga útil opcional.

Enviar respuestas rápidas

Para enviar una respuesta rápida, añade la matriz quick_replies a un mensaje de texto e incluye objetos que definan hasta 13 botones de respuesta rápida.

A continuación te mostramos los tipos de respuesta rápida compatibles:

• Texto
• Número de teléfono
• Correo electrónico

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>"    

Respuestas rápidas de texto

También se pueden enviar respuestas rápidas de texto con una imagen opcional que aparece como un icono junto al título. Si se especifica el valor de content_type de una respuesta rápida como text, es necesario especificar algún valor en title.

Sintaxis

{
  "content_type":"text",
  "title":"<BUTTON_TEXT>",
  "image_url":"http://example.com/img/red.png",
  "payload":"<DEVELOPER_DEFINED_PAYLOAD>"
}

Evento de webhook

Cuando se toque una respuesta rápida, se enviará un mensaje de texto a la devolución de llamada de mensaje recibido de tu webhook.

La propiedad text del evento corresponderá al título de la respuesta rápida. El objeto “message” también incluirá un campo llamado quick_reply que contendrá los datos de payload sobre la respuesta rápida.

{
  "object": "page",
  "entry": [
    {
      "id": "<PAGE_ID>",
      "time": 1502905976963,
      "messaging": [
        {
          "sender": {
            "id": "1254459154682919"
          },
          "recipient": {
            "id": "682498171943165"
          },
          "timestamp": 1502905976377,
          "message": {
            "quick_reply": {
              "payload": "DEVELOPER_DEFINED_PAYLOAD_FOR_PICKING_GREEN"
            },
            "mid": "m_AG5Hz2Uq7tuwNEhXfYYKj8mJEM_QPpz5jdCK48PnKAjSdjfipqxqMvK8ma6AC8fplwlqLP_5cgXIbu7I3rBN0P",
            "text": "Green"
          }
        }
      ]
    }
  ]
}

Respuestas rápidas de número de teléfono del usuario

Con las respuestas rápidas de número de teléfono del usuario, puedes pedir a un usuario su número de teléfono. Cuando se envíe la respuesta rápida de número de teléfono, la plataforma de Messenger rellenará automáticamente la respuesta rápida mostrada con el número de teléfono que figura en la información del perfil del usuario.

Si el perfil del usuario no tiene ningún número de teléfono, no se mostrará la respuesta rápida.

El bot no recibirá el número de teléfono hasta que el usuario haga clic en la respuesta rápida.

Si se elige la respuesta rápida, se transmite la información una vez, lo que no constituye un permiso de acceso a la información en el futuro.

Sintaxis

{
  "content_type":"user_phone_number"
}

Evento de webhook

Cuando el usuario toque la respuesta rápida, se pasará el número de teléfono en el atributo payload del evento messages del webhook.

{
  "object": "page",
  "entry": [
    {
      "id": "

Respuestas rápidas de correo electrónico del usuario

Con las respuestas rápidas de correo electrónico del usuario, puedes pedir a un usuario su correo electrónico. Cuando se envíe la respuesta rápida de correo electrónico, la plataforma de Messenger rellenará automáticamente la respuesta rápida mostrada con el correo electrónico que figura en la información del perfil del usuario.

Si el perfil del usuario no tiene ninguna dirección de correo electrónico, no se mostrará la respuesta rápida.

El bot no recibirá el correo electrónico hasta que el usuario haga clic en la respuesta rápida.

Si se elige la respuesta rápida, se transmite la información una vez, lo que no constituye un permiso de acceso a la información en el futuro.

Sintaxis

{
  "content_type":"user_email"
}

Evento de webhook

Cuando el usuario toque la respuesta rápida, se pasará la dirección de correo electrónico en el atributo payload del evento messages del webhook.

{
  "object": "page",
  "entry": [
    {
      "id": "

Prácticas recomendadas