---
title: "Send an interactive button message to an WhatsApp User"
method: POST
path: "/rest/sendMessage/{instance_key}/buttonMessage"
tags: ["SendMessageController"]
---

# Send an interactive button message to an WhatsApp User

`POST /rest/sendMessage/{instance_key}/buttonMessage`

The buttonMessage is a message that allows <br />
    you to send a message with buttons. <br />
    <br>
    <strong>How to send buttonMessage?</strong> <br />
    <br>
    The messageData object requires you to specify the name of button you <br />
    want to send to the user. <br /> The type of button you can send are: <br />
    <br>
    <code>reply</code><br><br>
    <br>
    <strong>Example of buttonMessage? </strong> <br />
    <br>
    <code><br>
{<br>
   "messageData":{<br>
      "to": "918788889688@s.whatsapp.net",<br>
      "title": "Message Title",<br>
      "text": "Message Text",<br>
      "footer": "Message Footer",<br>
      "type": "image", // ("text" | "image" | "video" | "document")<br>
      "mediaUrl": "https://www.example.com/imagem.jpg",<br>
      "buttons":[<br>
         {<br>
            "type": "reply",<br>
            "title":"Yes"<br>
         },<br>
         {<br>
            "type": "reply",<br>
            "title":"No"<br>
         }<br>
      ]<br>
   }<br>
}<br>
    </code>
    <br>
    <strong>NOTE: </strong>
    <i>Due to certain limitations of WhatsApp, the number of buttons is limited to 3 on mobile, <br>
    but on Whatsapp Web it shows several.<br>
    </i>

## Path parameters

- `instance_key` string, required

## Request body

- object
  - `messageData` ButtonMessage
    - `to` string
    - `title` string
    - `text` string
    - `footer` string
    - `type` string
    - `mediaUrl` string
    - `buttons` TypeButton[]
      - `type` string
      - `title` string
      - `id` string

## Response `200`

Success

---

[API](https://skmtc.net/megaapi/apis/documentation-megaapi.md) · [All operations](https://skmtc.net/megaapi/apis/documentation-megaapi/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/megaapi/documentation-megaapi/versions/09ca1205343e/schema)
