Button Types

Send a text and buttons attachment to request input from users. Both response templates as well as the persistent menu support buttons that can perform different kinds of actions:

• URL Button
• Postback Button
• Call Button
• Share Button

---

URL Button

The URL Button can be used to open a web page in the in-app browser. This button can be used with the Buttons Template, Carousel and List. A web view can be rendered in three different ways: compact, tall or full.

{
  type: "web_url",
  title: "some title",
  url: "https://sanuker.com",
  webview_height_ratio: "tall",
  messenger_extensions: true,
  fallback_url: "https://sanuker.com",
  webview_share_button: "hide",
  urlTracking: false,
  style: "default",
  confirm: {
    title: "Are you sure?",
    text: "Wouldn't you prefer a good game of chess?",
    ok_text: "Yes",
    dismiss_text: "No"
  }
}

Property	Description	Required
type	web_url	Y
title	String; Limited to 20 characters	Y
url	URL of the destination; Must be HTTPS if messenger_extensions is "true"	Y
webview_height_ratio	Height of the webview window; Set "compact", "tall" or "full"; Defaults to "full"	N
fallback_url	URL to use on clients that don't support Messenger Extensions; Set only if messenger_extensions is "true"; Defaults to url if not specified	N
webview_share_button	Set "hide" or unset	N
urlTracking	Defaults to "true"	N
style	Slack-specific; Set "default", "primary" or "danger"	N
confirm	Slack-specific	N

confirm Object

Property	Description	Required
title	String	N
text	String; Limited to 30 characters	Y
ok_text	String; Defaults to "Okay"	N
dismiss_text	String; Defaults to "Cancel"	N

---

Postback Button

The Postback Button helps invoke an action in your chatbot. You can set a payload to the button.

{
  type: "postback",
  title: "some title",
  payload: "some payload",
}

Property	Description	Required
type	postback	Y
title	String; Limited to 20 characters	Y
payload	Custom defined payload trigger; Limited to 1,000 characters	Y

---

Call Button

The Call Button can be used to initiate a phone call directly.

{
  type: "phone_number",
  title: "Call us",
  payload: "+85281930208"
}

Property	Description	Required
type	phone_number	Y
title	String; Limited to 20 characters	Y
payload	Format must have "+" prefix followed by the country code, area code and local number without any space	Y

---

Share Button

The Share Button enables users to privately share your content in Messenger to their friends. Friends can tap the heading to learn more about your chatbot on the shared message.

You may allow the users to share the original content that the share button is attached to; or you may send a different message which must be in the format of a Carousel.

{
  type: "element_share",
  share_content: {
    attachment: {
      type: "template",
      payload: {
        template_type: "generic",
        elements: [{
          title: "some title",
          subtitle: "some subtitle",
          image_url: "http://image.url",
          default_action: {
            type: "web_url",
            url: "https://sanuker.com"
          },
          buttons: [{
            type: "web_url",
            url: "<BUTTON_URL>",
            title: "<BUTTON_TITLE>"
          }]
        }]
      }
    }
  }
}

Property	Description	Required
type	element_share	Y
share_content	The message to be shared; Format must be in carousel; Defaults to original message; Maximum of 1 element; Maximum of 1 button	Y