Mensagens
Enviar texto
Mensagem de texto simples para um número ou grupo.
Quando usar
Notificações, confirmações, respostas de bot e qualquer conteúdo sem mídia ou botões.
Aliases aceitos: `message` ou `text`.
POST
/api/message/text/{instance}Enviar texto
Envia uma mensagem de texto. A instância precisa estar connected.
Auth: TokenInstance · Rate-limit: 100/min
Body
| Campo | Tipo | Descrição | |
|---|---|---|---|
number | string | obrigatório | 5511999999999 ou JID de grupo |
message | string | obrigatório | corpo (alias: text) |
cURL
curl -X POST https://api.wagzap.com.br/api/message/text/vendas \
-H "token: $TOKEN_INSTANCE" \
-H "Content-Type: application/json" \
-d '{
"number": "5511999999999",
"message": "Olá da Wagzap"
}'JavaScript
await fetch(`https://api.wagzap.com.br/api/message/text/${instance}`, {
method: "POST",
headers: { token: process.env.TOKEN_INSTANCE, "Content-Type": "application/json" },
body: JSON.stringify({
"number": "5511999999999",
"message": "Olá da Wagzap"
})
});Resposta
{
"success": true,
"messageId": "3EB08FCF27E532F1F5F5",
"data": { "messageId": "3EB08FCF27E532F1F5F5" }
}- Número sem +, espaços ou hífens.
- Para grupo, use o JID retornado em /api/group/list.
Erros
| HTTP | Mensagem |
|---|---|
| 400 | number and message required / payload inválido |
| 401 | missing token / invalid token |
| 403 | token does not match instance |
| 404 | instance not found |
| 429 | rate limit exceeded (padrão 100/min) |
| 502 | Falha no WhatsApp / instância desconectada |