Respostas rápidas

As respostas rápidas oferecem uma forma de apresentar um conjunto de até 13 botões na conversa, com título e imagem opcional, e aparecem de modo destacado acima do editor. O recurso também pode ser usado para solicitar a localização, o endereço de email e o número de telefone de uma pessoa.

Quando um usuário toca em uma resposta rápida, os botões são ignorados e o título do botão tocado é publicado na conversa como uma mensagem. Além disso, um evento messages é enviado para o webhook que tem o título desse botão e uma carga opcional.

Como enviar respostas rápidas

Para enviar uma resposta rápida, adicione a matriz quick_replies à mensagem de texto e inclua objetos que definam até 13 botões de resposta rápida.

Permitimos os seguintes tipos de respostas rápidas:

• Texto
• Número de telefone
• Email

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/v19.0/me/messages?access_token=<PAGE_ACCESS_TOKEN>"    

Resposta rápida de texto

As respostas rápidas de texto também podem ser enviadas com uma imagem opcional que aparece como um ícone ao lado do título. Se o content_type da resposta rápida for especificado como text, title não poderá ficar vazio.

Sintaxe

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

Evento de webhook

Quando o usuário tocar na resposta rápida, uma mensagem de texto será enviada ao retorno de chamada do webhook de mensagem recebida.

A propriedade text do evento corresponderá ao título da resposta rápida. O objeto de mensagem incluirá um campo quick_reply com os dados de payload.

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

Resposta rápida de número de telefone de usuário

A resposta rápida de número de telefone de usuário permite que você solicite esse dado ao usuário. Quando a resposta rápida de número de telefone é enviada, a plataforma do Messenger preenche automaticamente a resposta rápida exibida com o dado extraído das informações do perfil do usuário.

Se o usuário não tiver um número de telefone, a resposta rápida não será mostrada.

O bot não receberá o número de telefone sem que o usuário clique na resposta rápida.

Escolher a resposta rápida transmite a informação uma vez, não constituindo permissão para acesso futuro.

Sintaxe

{
  "content_type":"user_phone_number"
}

Evento de webhook

Quando o usuário tocar na resposta rápida, o número de telefone será transmitido no atributo payload do evento de webhook messages.

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

Resposta rápida de email de usuário

A resposta rápida de email de usuário permite que você solicite esse dado ao usuário. Quando a resposta rápida de email é enviada, a plataforma do Messenger preenche automaticamente a resposta rápida exibida com o dado extraído das informações do perfil do usuário.

Se o usuário não tiver um email, a resposta rápida não será mostrada.

O bot não receberá o email sem que o usuário clique na resposta rápida.

Escolher a resposta rápida transmite a informação uma vez, não constituindo permissão para acesso futuro.

Sintaxe

{
  "content_type":"user_email"
}

Evento de webhook

Quando o usuário tocar na resposta rápida, o email será transmitido no atributo payload do evento de webhook messages.

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

Boas práticas