Respuestas rápidas

Las respuestas rápidas ofrecen una manera de mostrar un conjunto de hasta 13 botones en la conversación, que contienen un título y una imagen opcional, y que aparecen en un lugar destacado por encima del editor. También puedes usar las respuestas rápidas para solicitar a una persona su ubicación, dirección de correo electrónico y número de teléfono.

Cuando se toca una respuesta rápida, se descartan los botones y el título del botón que se tocó se publica en la conversación como mensaje. Se envía un evento messages a tu webhook, que contiene el título del botón y una carga opcional.

Enviar respuestas rápidas

Para enviar una respuesta rápida, agrega la matriz quick_replies al mensaje de texto e incluye objetos que definan hasta 13 botones de respuesta rápida.

Se admiten los siguientes tipos de respuestas rápidas:

• 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 el valor de content_type de una respuesta rápida se define en text, es obligatorio especificar un title que no esté vacío.

Sintaxis

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

Evento de webhook

Si se toca una respuesta rápida, se enviará un mensaje de texto a la devolución de llamada de mensaje recibido del webhook.

La propiedad text del evento corresponderá al título de la respuesta rápida. El objeto del mensaje también contendrá un campo denominado quick_reply, que contiene los datos de payload en 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

La respuesta rápida de número de teléfono del usuario te permite solicitar el número de teléfono a un usuario. Cuando se envíe la respuesta rápida de número de teléfono, la plataforma de Messenger completará con anterioridad y de manera automática la respuesta rápida que se muestra con el número de teléfono de 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 otorga 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 de webhook messages.

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

Respuestas rápidas de correo electrónico del usuario

La respuesta rápida de correo electrónico del usuario te permite solicitar el correo electrónico a un usuario. Cuando se envíe la respuesta rápida de correo electrónico, la plataforma de Messenger completará con anterioridad y de manera automática la respuesta rápida que se muestra con el correo electrónico incluido en la información del perfil del usuario.

Si el perfil del usuario no tiene una 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 otorga 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 de webhook messages.

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

Prácticas recomendadas