Mensagens
Enviar localização
Pin no mapa com latitude, longitude, nome e endereço opcionais.
Quando usar
Loja física, ponto de retirada, endereço de visita. Coordenadas em decimal (WGS84).
POST
/api/message/location/{instance}Enviar localização
Pin geográfico.
Auth: TokenInstance
Body
| Campo | Tipo | Descrição | |
|---|---|---|---|
number | string | obrigatório | destino |
latitude | number | obrigatório | -23.5505 |
longitude | number | obrigatório | -46.6333 |
name | string | rótulo no pin | |
address | string | endereço exibido |
cURL
curl -X POST https://api.wagzap.com.br/api/message/location/vendas \
-H "token: $TOKEN_INSTANCE" \
-H "Content-Type: application/json" \
-d '{
"number": "5511999999999",
"latitude": -23.5505,
"longitude": -46.6333,
"name": "São Paulo",
"address": "Av. Paulista"
}'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 |