Referência do botão de postback

Quando o botão de postback é tocado, a plataforma do Messenger envia um evento ao webhook de postback. Isso é útil quando você quer invocar uma ação do seu bot. É possível escolher o modelo de botão e o modelo genérico.

Para saber mais sobre o uso do botão de postback, acesse Botão de postback.

Visão geral do postback

Quando o botão de postback é tocado, a plataforma do Messenger envia um evento ao webhook de postback. Isso é útil quando você quer invocar uma ação do seu bot. É possível escolher o modelo de botão e o modelo genérico.

Para saber mais sobre o uso do botão de postback, acesse Botão de postback.

Sintaxe do botão de postback

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

Exemplo de uso de postback

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

c:curl>

Exemplo de resposta de postback

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

Propriedades do postback

Propriedade Tipo Descrição

type

String

Tipo de botão. Precisa ser postback.

title

String

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

payload

String

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