buttons block

This canonical lookup describes the published buttons interaction shape, the present renderer support, its return path, and the trust boundary that applies when it is shown to a person.

Type	Contract	Agent may send	Platform may produce	Web renderer	Mobile renderer
buttons	Published	Allowed	No documented platform producer.	ButtonsBlock	ButtonsBlockView

buttons

Allowed

One to five quick-reply actions.

Return path

Selecting a button sends its payload back as an ordinary user message.

Trust and visibility

The selected payload is agent-defined application content, not a platform authorization.

Stability

Available end to end; two actions may not share a label with differing payloads.

Field	Required	Published constraint
type	Yes	literal "buttons"
buttons	Yes	array · 1–5 items · items: object { label: string · 1–60 characters, payload: string · 1–200 characters }

JSON

{
  "type": "buttons",
  "buttons": [
    {
      "label": "Yes, book it",
      "payload": "confirm_booking"
    },
    {
      "label": "Show other flights",
      "payload": "show_alternatives"
    }
  ]
}

Web preview