Envio de botões interativos

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

Enviar Botões de Ação

Com este método, você pode enviar mensagens de texto que incluam botões de ação, oferecendo uma maneira interativa para os usuários responderem. O conteúdo dos botões, como por exemplo "SIM" ou "NÃO", pode ser personalizado conforme a necessidade do usuário e será usado como resposta para a mensagem enviada junto com os botões. Essa funcionalidade proporciona uma forma dinâmica e direta de obter interações rápidas e precisas.

:::danger[]
Aviso Importante
📅 Esta documentação foi atualizada em 29/10/2024. Cada atualização do WhatsApp pode alterar o comportamento dos botões, por isso é essencial estar sempre atento às mudanças e ajustes. 🔄
:::

Exemplo do envio com imagem

{
    "messageData": {
        "to": "556195562618@s.whatsapp.net",
        "title": "Titulo",
        "text": "Hello",
        "footer": "Message Footer",
        "type": "image",
        "mediaUrl": "https://mega-api-painel.app.br/arquivos_doc/megaapi.png",
        "buttons": [
            {
                "type": "reply",
                "title": "Botão 1"
            },
            {
                "type": "reply",
                "title": "Botão 2"
            },
            {
                "type": "reply",
                "title": "Botão 3"
            }
        ]
    }
}

Exemplo do envio com video

{
    "messageData": {
        "to": "556195562618@s.whatsapp.net",
        "title": "Message Title",
        "text": "Hello",
        "footer": "Message Footer",
        "type": "video",
        "mediaUrl": "https://mega-api-painel.app.br/arquivos_doc/video.mp4",
        "buttons": [
            {
                "type": "reply",
                "title": "Botão 1"
            },
            {
                "type": "reply",
                "title": "Botão 2"
            },
            {
                "type": "reply",
                "title": "Botão 3"
            }
        ]
    }
}

Exemplo do envio com document

{
    "messageData": {
        "to": "556195562618@s.whatsapp.net",
        "title": "Message Title",
        "text": "Hello",
        "footer": "Message Footer",
        "type": "document",
        "mediaUrl": "https://araucariageneticabovina.com.br/arquivos/servico/pdfServico_57952bf8ca7af_24-07-2016_17-58-32.pdf",
        "buttons": [
            {
                "type": "reply",
                "title": "Botão 1"
            },
            {
                "type": "reply",
                "title": "Botão 2"
            },
            {
                "type": "reply",
                "title": "Botão 3"
            }
        ]
    }
}

Request

Authorization: Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Exemplo

Authorization: Bearer 2f68dbbf-519d-4f01-9636-e2421b68f379

Parâmetros Header

Authorization

string

requerido

Exemplo:

Bearer {{token}}

Content-Type

string

opcional

Exemplo:

application/json

object {0}

{
  "messageData": {
    "to": "556195562618@s.whatsapp.net",
    "title": "megaAPI",
    "text": "Ja testou a api da megaAPI",
    "footer": "Cilque em uma das opções",
    "type": "text",
    "mediaUrl": "",
    "buttons": [
      {
        "type": "reply",
        "title": "Sim"
      },
      {
        "type": "reply",
        "title": "Não"
      },
      {
        "type": "reply",
        "title": "Vou testar"
      }
    ]
  }
}

Request samples

Respostas

Success(200)

Não autorizado(200)

Whatsapp inválido(200)

HTTP Code: 200

Content Type : JSONapplication/json

error

boolean

requerido

message

string

requerido

messageData

object

requerido

key

object

requerido

message

object

requerido

messageTimestamp

string

requerido

status

string

requerido

{
  "error": false,
  "message": "Message sent",
  "messageData": {
    "key": {
      "remoteJid": "5511999999999@s.whatsapp.net",
      "fromMe": true,
      "id": "BAE5403BBB515C2F"
    },
    "message": {
      "listMessage": {
        "title": "TEste",
        "description": "Testanto",
        "buttonText": "Escolha",
        "listType": "SINGLE_SELECT",
        "sections": [
          {
            "title": "PIX",
            "rows": [
              {
                "title": "PIX",
                "description": "pagamento via pix",
                "rowId": "01"
              }
            ]
          }
        ],
        "footerText": "Selecione uma forma de pagamento"
      }
    },
    "messageTimestamp": "1658283308",
    "status": "PENDING"
  }
}