Respuestas rápidas

Las respuestas rápidas ofrecen una nueva forma de presentarle botones al usuario. Aparecen en un lugar destacado encima del editor, con el teclado menos destacado. Cuando se toca una respuesta rápida, el mensaje se envía en la conversación con metadatos definidos por el desarrollador en la devolución de llamada. Además, los botones se retiran y así se evita el problema de que los usuarios podían tocar botones adjuntos en mensajes antiguos de una conversación.

Las respuestas rápidas contienen texto, pero también puedes agregar una imagen.

También puedes usar las respuestas rápidas para preguntarle a una persona por su ubicación.

Ejemplo

Solo texto

curl -X POST -H "Content-Type: application/json" -d '{
  "recipient":{
    "id":"USER_ID"
  },
  "message":{
    "text":"Pick a color:",
    "quick_replies":[
      {
        "content_type":"text",
        "title":"Red",
        "payload":"DEVELOPER_DEFINED_PAYLOAD_FOR_PICKING_RED"
      },
      {
        "content_type":"text",
        "title":"Green",
        "payload":"DEVELOPER_DEFINED_PAYLOAD_FOR_PICKING_GREEN"
      }
    ]
  }
}' "https://graph.facebook.com/v2.6/me/messages?access_token=PAGE_ACCESS_TOKEN"    

Texto e imagen

curl -X POST -H "Content-Type: application/json" -d '{
  "recipient":{
    "id":"USER_ID"
  },
  "message":{
    "text":"Pick a color:",
    "quick_replies":[
      {
        "content_type":"text",
        "title":"Red",
        "payload":"DEVELOPER_DEFINED_PAYLOAD_FOR_PICKING_RED",
        "image_url":"http://petersfantastichats.com/img/red.png"
      },
      {
        "content_type":"text",
        "title":"Green",
        "payload":"DEVELOPER_DEFINED_PAYLOAD_FOR_PICKING_GREEN",
        "image_url":"http://petersfantastichats.com/img/green.png"
      }
    ]
  }
}' "https://graph.facebook.com/v2.6/me/messages?access_token=PAGE_ACCESS_TOKEN"    

Ubicación

curl -X POST -H "Content-Type: application/json" -d '{
  "recipient":{
    "id":"USER_ID"
  },
  "message":{
    "text":"Please share your location:",
    "quick_replies":[
      {
        "content_type":"location",
      }
    ]
  }
}' "https://graph.facebook.com/v2.6/me/messages?access_token=PAGE_ACCESS_TOKEN"

Campos

Objeto message

• quick_replies tiene un límite de 11.

Objeto attachment

Las respuestas rápidas funcionan con todos los tipos de mensajes, incluidos los mensajes de texto, y los archivos adjuntos de imágenes y plantillas. Consulta la documentación de la API de envío para obtener más información sobre cómo usar el objeto attachment.

Objeto quick_reply

• title tiene un límite de 20 caracteres y, si se excede este número, se trunca.
• payload tiene un límite de 1.000 caracteres.
• Si content_type es location, no se utilizan title ni payload.
• La imagen para image_url debe tener al menos 24 x 24 píxeles. Se recortará y se cambiará su tamaño.

Devolución de llamada

Cuando se toque una respuesta rápida, se enviará un mensaje de texto a la devolución de llamada de mensaje recibido del webhook. El texto del mensaje 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.

{
  "sender": {
    "id": "USER_ID"
  },
  "recipient": {
    "id": "PAGE_ID"
  },
  "timestamp": 1464990849275,
  "message": {
    "mid": "mid.1464990849238:b9a22a2bcb1de31773",
    "seq": 69,
    "text": "Red",
    "quick_reply": {
      "payload": "DEVELOPER_DEFINED_PAYLOAD_FOR_PICKING_RED"
    }
  }
}    

Cuando una persona comparte su ubicación, la devolución de llamada tiene este aspecto:

{
  "object": "page",
  "entry": [
    {
      "id": "PAGE_ID",
      "time": 1472672934319,
      "messaging": [
        {
          "sender": {
            "id": "USER_ID"
          },
          "recipient": {
            "id": "PAGE_ID"
          },
          "timestamp": 1472672934259,
          "message": {
            "mid": "mid.1472672934017:db566db5104b5b5c08",
            "seq": 297,
            "attachments": [
              {
                "title": "Facebook HQ",
                "url": "https://www.facebook.com/l.php?u=https%....5-7Ocxrmg",
                "type": "location",
                "payload": {
                  "coordinates": {
                    "lat": 37.483872693672,
                    "long": -122.14900441942
                  }
                }
              }
            ]
          }
        }
      ]
    }
  ]
}