API/Mensagens/Enviar botões

Enviar mensagem com botões

Envia uma mensagem interativa com até 3 botões. Compatível com Android e iPhone. A API utiliza internamente InteractiveMessage com NativeFlowMessage e biz node, garantindo renderização correta em todos os dispositivos.

POST/message/:instance/button

Path Parameters

instancestringrequired

Nome da instância que enviará a mensagem

Body Parameters

tostringrequired

Número do destinatário com código do país (ex: 5511999999999)

textstringrequired

Texto principal da mensagem (corpo)

footerstring

Texto do rodapé da mensagem

buttonsarrayrequired

Array com 1 a 3 botões interativos

buttons[].buttonIdstringrequired

ID único do botão (usado para identificar a resposta)

buttons[].buttonTextobjectrequired

Objeto contendo o texto do botão

buttons[].buttonText.displayTextstringrequired

Texto exibido no botão (máx. 20 caracteres)

buttons[].typestringrequired

Tipo do botão: reply, url ou phone

buttons[].urlstring

URL para botões do tipo url

buttons[].phonestring

Número de telefone para botões do tipo phone

headerobject

Cabeçalho da mensagem (text, image, video ou document)

header.typestring

Tipo do cabeçalho: text, image, video ou document

header.textstring

Texto do cabeçalho (quando type=text)

header.media_urlstring

URL da mídia (quando type=image, video ou document)

Response

200Mensagem com botões enviada com sucesso

200 - application/json

{
  "success": true,
  "data": {
    "message_id": "3EB0A1B2C3D4E5F6",
    "status": "sent",
    "timestamp": "2024-01-15T10:35:00.000Z"
  }
}

POST/message/:instance/button

Example Response

200

{
  "success": true,
  "data": {
    "message_id": "3EB0A1B2C3D4E5F6",
    "status": "sent",
    "timestamp": "2024-01-15T10:35:00.000Z"
  }
}