NODAPI

Enviar Mensagem

Enviar mensagem de texto

POST/send/text
  • Conta no limite de envio da conexão. Ao passar do limite, a resposta é 429.

Autenticação: envie a chave da conexão no header token ou em Authorization: Bearer.

Envia uma mensagem de texto para um contato, grupo ou canal/newsletter.

Recursos Específicos

  • Preview de links com suporte a personalização automática ou customizada
  • Formatação básica do texto
  • Substituição automática de placeholders dinâmicos

Envio para Newsletter

Para enviar texto para um canal, use o mesmo campo number, mas informe o JID completo do canal:

  • Exemplo: 120363123456789012@newsletter
{
  "number": "120363123456789012@newsletter",
  "text": "Post publicado no canal"
}

Campos Comuns

Este endpoint suporta todos os campos opcionais comuns documentados na tag "Enviar Mensagem", incluindo: delay, readchat, readmessages, replyid, mentions, forward, track_source, track_id, placeholders e envio para grupos.

Preview de Links

Preview Automático

{
  "number": "5511999999999",
  "text": "Confira: https://exemplo.com",
  "linkPreview": true
}

Preview Personalizado

{
  "number": "5511999999999",
  "text": "Confira nosso site! https://exemplo.com",
  "linkPreview": true,
  "linkPreviewTitle": "Título Personalizado",
  "linkPreviewDescription": "Uma descrição personalizada do link",
  "linkPreviewImage": "https://exemplo.com/imagem.jpg",
  "linkPreviewLarge": true
}

Corpo da requisição (JSON)

CampoTipoDescrição
number*string

ID do chat para o qual a mensagem será enviada. Pode ser um número de telefone em formato internacional, um ID de grupo (@g.us), um ID de usuário (com @s.whatsapp.net ou @lid) ou um ID de canal/newsletter (@newsletter).

Exemplo: 5511999999999

text*string

Texto da mensagem (aceita placeholders)

Exemplo: Olá {{name}}! Como posso ajudar?

linkPreviewboolean

Ativa/desativa preview de links. Se true, procura automaticamente um link no texto para gerar preview.

Comportamento:

  • Se apenas linkPreview=true: gera preview automático do primeiro link encontrado no texto
  • Se fornecidos campos personalizados (title, description, image): usa os valores fornecidos
  • Se campos personalizados parciais: combina com dados automáticos do link como fallback

Exemplo: true

linkPreviewTitlestring

Define um título personalizado para o preview do link

Exemplo: Título Personalizado

linkPreviewDescriptionstring

Define uma descrição personalizada para o preview do link

Exemplo: Descrição personalizada do link

linkPreviewImagestring

URL ou Base64 da imagem para usar no preview do link

Exemplo: https://exemplo.com/imagem.jpg

linkPreviewLargeboolean

Se true, gera um preview grande com upload da imagem. Se false, gera um preview pequeno sem upload

Exemplo: true

replyidstring

ID da mensagem para responder

Exemplo: 3EB0538DA65A59F6D8A251

mentionsstring

Números para mencionar (separados por vírgula)

Exemplo: 5511999999999,5511888888888

readchatboolean

Marca conversa como lida após envio

Exemplo: true

readmessagesboolean

Marca últimas mensagens recebidas como lidas

Exemplo: true

delayinteger

Atraso em milissegundos antes do envio, durante o atraso apacerá 'Digitando...'

Exemplo: 1000

forwardboolean

Marca a mensagem como encaminhada no WhatsApp

Exemplo: true

track_sourcestring

Origem do rastreamento da mensagem

Exemplo: chatwoot

track_idstring

ID para rastreamento da mensagem (aceita valores duplicados)

Exemplo: msg_123456789

asyncboolean

Se true, envia a mensagem de forma assíncrona via fila interna. Útil para alto volume de mensagens.

Exemplo: false

* obrigatório

Exemplos de corpo

Mensagem básica

{
  "number": "5511999999999",
  "text": "Olá! Como posso ajudar?"
}

Com preview automático

{
  "number": "5511999999999",
  "text": "Confira: https://exemplo.com",
  "linkPreview": true
}

Preview personalizado

{
  "number": "5511999999999",
  "text": "Confira nosso site! https://exemplo.com",
  "linkPreview": true,
  "linkPreviewTitle": "Título Personalizado",
  "linkPreviewDescription": "Uma descrição personalizada do link",
  "linkPreviewImage": "https://exemplo.com/imagem.jpg",
  "linkPreviewLarge": true
}

Com placeholders

{
  "number": "5511999999999",
  "text": "Olá {{name}}! Sua empresa {{company}} está cadastrada."
}

Envio para newsletter

{
  "number": "120363123456789012@newsletter",
  "text": "Post publicado no canal"
}

Respostas

  • 200Mensagem enviada com sucesso
  • 400Requisição inválida
  • 401Não autorizado
  • 429Limite de requisições excedido
  • 500Erro interno do servidor

Experimente

Atenção: a chamada é real. Ela roda na sua conexão e pode enviar mensagem de verdade. A chave fica só nesta tela e some ao sair dela; nunca é guardada.

Cole a chave gerada no painel.