Skip to main content
POST
Enviar mensagem para um número (cria conversa se preciso)

Autorizações

Authorization
string
header
obrigatório

Token criado em API → Tokens no painel. Prefixo wtx_live_ (ou wtx_test_).

Corpo

Pelo menos um entre body, medias (multipart) e templateData é obrigatório.

number
string
obrigatório

E.164 sem + (DDI+DDD+número).

Exemplo:

"5534992341048"

body
string
whatsappId
integer | null

Conexão de saída (id). Tem prioridade sobre whatsappName e sobre a conexão padrão.

whatsappName
string | null

Conexão de saída pelo nome (alternativa ao id).

contactName
string | null

Nome usado se o contato for criado agora.

templateData

Template aprovado do WABA. Aceita um objeto { templateName, templateLanguage, templateParameters } ou, por compatibilidade, a mesma estrutura como string JSON.

saveOnTicket
boolean
padrão:true

false = fire-and-forget: a resposta não traz ticketId/contactId. Em conexões WABA o envio ainda passa por um ticket normal (status: "open"), visível no painel; medias é ignorado nesse modo.

Resposta

Mensagem aceita; conversa criada/reaproveitada.

requestId
string
ticketId
integer | null

null quando saveOnTicket=false.

contactId
integer | null
whatsappId
integer
channel
string
messages
object[]