Respostas rápidas

As respostas rápidas são uma nova maneira de exibir botões ao usuário. As respostas rápidas são exibidas principalmente acima do composer, com o teclado menos destacado. Quando uma resposta rápida é digitada, a mensagem será enviada na conversa com metadados definidos pelo desenvolvedor no retorno de chamada. Além disso, os botões são desativados para evitar o problema que ocorre quando o usuário toca em botões anexados a mensagens antigas na conversa.

As Respostas rápidas contêm texto. Opcionalmente, você pode adicionar uma imagem.

Você também pode usar as Respostas rápidas para solicitar que uma pessoa compartilhe a sua localização.

Exemplo

Somente 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 imagem

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"    

Localização

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

• As quick_replies são limitadas a 11

Objeto attachment

As Respostas Rápidas funcionam com todos os tipos de mensagens, inclusive mensagens de texto, imagens e anexos de modelos. Consulte a Documentação da API de envio para saber mais informações sobre como usar o objeto attachment.

Objeto quick_reply

• title tem um limite de 20 caracteres e será truncado se passar desse limite
• payload tem um limite de 1000 caracteres
• Se content_type for location, title e payload não são usados
• A imagem para image_url deve ter pelo menos 24x24 e será recortada e redimensionada

Retorno de chamada

Ao tocar em uma resposta rápida, uma mensagem de texto será enviada para o seu webhook Retorno de chamada de mensagem recebida. O texto da mensagem corresponderá ao título da resposta rápida. O objeto da mensagem também conterá um campo chamado quick_reply com os dados de payload na resposta 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"
    }
  }
}    

Quando uma pessoa compartilha sua localização, o retorno de chamada tem a seguinte aparência:

{
  "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
                  }
                }
              }
            ]
          }
        }
      ]
    }
  ]
}