Enviar Mensagem
Enviar mensagem de texto
/send/textConta 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)
| Campo | Tipo | Descriçã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 ( Exemplo: 5511999999999 |
| text* | string | Texto da mensagem (aceita placeholders) Exemplo: Olá {{name}}! Como posso ajudar? |
| linkPreview | boolean | Ativa/desativa preview de links. Se true, procura automaticamente um link no texto para gerar preview. Comportamento:
Exemplo: true |
| linkPreviewTitle | string | Define um título personalizado para o preview do link Exemplo: Título Personalizado |
| linkPreviewDescription | string | Define uma descrição personalizada para o preview do link Exemplo: Descrição personalizada do link |
| linkPreviewImage | string | URL ou Base64 da imagem para usar no preview do link Exemplo: https://exemplo.com/imagem.jpg |
| linkPreviewLarge | boolean | Se true, gera um preview grande com upload da imagem. Se false, gera um preview pequeno sem upload Exemplo: true |
| replyid | string | ID da mensagem para responder Exemplo: 3EB0538DA65A59F6D8A251 |
| mentions | string | Números para mencionar (separados por vírgula) Exemplo: 5511999999999,5511888888888 |
| readchat | boolean | Marca conversa como lida após envio Exemplo: true |
| readmessages | boolean | Marca últimas mensagens recebidas como lidas Exemplo: true |
| delay | integer | Atraso em milissegundos antes do envio, durante o atraso apacerá 'Digitando...' Exemplo: 1000 |
| forward | boolean | Marca a mensagem como encaminhada no WhatsApp Exemplo: true |
| track_source | string | Origem do rastreamento da mensagem Exemplo: chatwoot |
| track_id | string | ID para rastreamento da mensagem (aceita valores duplicados) Exemplo: msg_123456789 |
| async | boolean | 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.