Referência do botão de postback

Quando o botão de postback é pressionado, a Plataforma do Messenger envia um evento para o webhook de postback. Isso é útil quando você deseja invocar uma ação em seu bot. Esse botão pode ser usado com o Modelo de botão e com o Modelo genérico.

Para obter mais informações sobre o uso do botão de postback, acesse Botão de postback.

Sumário

Sintaxe do botão

{
  "type":"postback",
  "title":"<BUTTON_TEXT>",
  "payload":"<DEVELOPER_DEFINED_PAYLOAD>"
}

Exemplo de uso

curl -X POST -H "Content-Type: application/json" -d '{
  "recipient":{
    "id":"<PSID>"
  },
  "message":{
    "attachment":{
      "type":"template",
      "payload":{
        "template_type":"button",
        "text":"Try the postback button!",
        "buttons":[
          {
            "type":"postback",
            "title":"Postback Button",
            "payload":"DEVELOPER_DEFINED_PAYLOAD"
          }
        ]
      }
    }
  }
}' "https://graph.facebook.com/v2.6/me/messages?access_token=<PAGE_ACCESS_TOKEN>"

Exemplo de resposta

{
  "recipient_id": "1254477777772919",
  "message_id": "AG5Hz2Uq7tuwNEhXfYYKj8mJEM_QPpz5jdCK48PnKAjSdjfipqxqMvK8ma6AC8fplwlqLP_5cgXIbu7I3rBN0P"
}  

Propriedades

PropriedadeTipoDescrição

type

Cadeia de caracteres

Tipo de botão. Deve ser postback.

title

Cadeia de caracteres

Título do botão. Limite de 20 caracteres.

payload

Cadeia de caracteres

Esses dados serão enviados de volta para seu webhook. Limite de 1.000 caracteres.