Respuestas rápidas

Las respuestas rápidas constituyen una nueva forma de mostrar botones al usuario. Aparecen en un lugar destacado encima del editor, con el teclado en un segundo plano. Cuando se toca una respuesta rápida, se envía el mensaje en la conversación con los metadatos que ha definido el desarrollador en la devolución de llamada. Además, se deshabilitan los botones para evitar que los usuarios toquen botones adjuntos a mensajes antiguos de una conversación.

Las respuestas rápidas contienen texto. Si lo deseas, puedes añadir una imagen.

También puedes utilizar las respuestas rápidas para solicitar la ubicación a una persona.

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

• El número de objetos quick_replies está limitado a 11.

Objeto attachment

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

Objeto quick_reply

• El elemento title tiene un límite de 20 caracteres; si se sobrepasa, el texto aparecerá truncado.
• payload tiene un límite de 1000 caracteres.
• Si content_type es location, title y payload no se utilizan.
• La imagen para image_url debe tener una resolución mínima de 24 x 24, y se recortará y 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 de tu webhook. El texto del mensaje corresponderá al título de la respuesta rápida. El objeto "message" también incluirá un campo llamado quick_reply, que contiene los datos de payload sobre 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 presenta 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
                  }
                }
              }
            ]
          }
        }
      ]
    }
  ]
}