megaAPI Plan Code
HomemegaAPI
Painel de Acesso
  • Entrar
HomemegaAPI
Painel de Acesso
  • Entrar
  1. SendMessageController
  • Introdução à megaAPI
  • Componente n8n megaAPI
  • InstanceController
    • Instâncias
    • Status da Conexão
      GET
    • Download arquivos
      POST
    • Número com whatsapp?
      GET
    • Qrcode Imagem
      GET
    • Qrcode Base64
      GET
    • Conexão via código
      GET
    • Desconectar Whatsapp
      DELETE
    • Reiniciar uma Conexão
      DELETE
  • WebhookController
    • Exemplos dos retorno do webhook megaAPI
    • Dados do webhook
      GET
    • Configurar Webhook
      POST
  • SendMessageController
    • Envio de Mensagens de Texto
      POST
    • Envio de arquivos (URL)
      POST
    • Envio de arquivos (BASE64)
      POST
    • Envio de localização
      POST
    • Envio link com pré vizualização
      POST
    • Envio de lista de opções
      POST
    • Envio de botões interativos
      POST
    • Envio de templates interativos
      POST
    • Reencaminhar mensagem
      POST
    • Responder mensagem
      POST
  • ConfigController
    • Detalhes de configurações
      GET
    • Alterar token
      POST
    • Bloquear eventos
      POST
    • Adicionar Evento Webhook
      POST
    • Adicionar Evento Status
      POST
  • ChatController
    • Digitando - Gravando Áudio - Online
    • Deletar mensagem
    • deleteMessageFromMe
  • GroupController
    • Listar todos os grupos
    • Detalhe do grupo
    • Criar grupo
    • Enviar mensagem de texto para grupo
    • Enviar arquivo para grupo (URL)
    • Enviar arquivo para grupo (BASE64)
    • Adicionar participantes no grupo
    • Remover participantes do grupo
    • Sair do Grupo
  1. SendMessageController

Envio de botões interativos

POST
https://apinocode01.megaapi.com.br/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.
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. 🔄

botoes.jpg

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"
            }
        ]
    }
}

Requisição

Authorization
Forneça seu token bearer no cabeçalho
Authorization
ao fazer requisições para recursos protegidos.
Exemplo:
Authorization: Bearer ********************
Parâmetros Header
Authorization
string 
requerido
Exemplo:
Bearer {{token}}
Content-Type
string 
opcional
Exemplo:
application/json
Parâmetros Bodyapplication/json
object {0}
Exemplo
{
  "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"
      }
    ]
  }
}

Exemplos de Requisição

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location -g --request POST 'https://apinocode01.megaapi.com.br/rest/sendMessage/sua instance_key/buttonMessage' \
--header 'Authorization: Bearer seu token' \
--header 'Content-Type: application/json' \
--data-raw '{
    "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"
            }
        ]
    }
}'

Respostas

🟢200Success
application/json
Body
error
boolean 
requerido
message
string 
requerido
messageData
object 
requerido
key
object 
requerido
message
object 
requerido
messageTimestamp
string 
requerido
status
string 
requerido
Exemplo
{
  "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"
  }
}
🟢200Não autorizado
🟢200Whatsapp inválido
Página anterior
Envio de lista de opções
Próxima página
Envio de templates interativos
Built with