Mensagens

Enviar mídia

Imagem, vídeo, áudio (PTT ou normal) ou documento por URL pública ou base64.

Quando usar

Envie `mediaUrl` (a Wagzap baixa o arquivo) ou `mediaBase64`. Um dos dois é obrigatório.

`mediaType`: `image`, `video`, `audio` ou `document`.

`isVoice: true` envia áudio como nota de voz (PTT).

URLs precisam ser públicas e acessíveis pelo servidor da API. Para PDF use mediaType document e fileName.

POST/api/message/media/{instance}

Enviar mídia

Imagem, vídeo, áudio ou documento.

Auth: TokenInstance

Body

Campo	Tipo		Descrição
`number`	string	obrigatório	destino
`mediaType`	string	obrigatório	image \| video \| audio \| document
`mediaUrl`	string		URL pública
`mediaBase64`	string		alternativa à URL
`caption`	string		legenda (alias: message)
`fileName`	string		arquivo.pdf
`mimeType`	string		opcional se a URL já tiver extensão
`isVoice`	boolean		áudio PTT

cURL

curl -X POST https://api.wagzap.com.br/api/message/media/vendas \
  -H "token: $TOKEN_INSTANCE" \
  -H "Content-Type: application/json" \
  -d '{
  "number": "5511999999999",
  "mediaType": "image",
  "mediaUrl": "https://picsum.photos/800",
  "caption": "Foto de teste"
}'

JavaScript

await fetch(`https://api.wagzap.com.br/api/message/media/${instance}`, {
  method: "POST",
  headers: { token: process.env.TOKEN_INSTANCE, "Content-Type": "application/json" },
  body: JSON.stringify({
    "number": "5511999999999",
    "mediaType": "image",
    "mediaUrl": "https://picsum.photos/800",
    "caption": "Foto de teste"
  })
});

Resposta

{
  "success": true,
  "messageId": "3EB08FCF27E532F1F5F5",
  "data": { "messageId": "3EB08FCF27E532F1F5F5" }
}

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