Skip to main content
POST
https://api.oxenty.api.br
/
api
/
messages
/
location
curl -X POST "https://api.oxenty.api.br/api/messages/location" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "sessionId": "550e8400-e29b-41d4-a716-446655440000",
    "to": "5511999999999",
    "latitude": -23.550520,
    "longitude": -46.633308,
    "name": "MASP - Museu de Arte de São Paulo",
    "address": "Av. Paulista, 1578 - Bela Vista, São Paulo"
  }'
{
  "messageId": "3EB0ABC123DEF456789GHI",
  "status": "sent",
  "to": "5511999999999@s.whatsapp.net",
  "timestamp": "2024-01-15T10:30:00.000Z"
}
Envia uma localização geográfica para um contato ou grupo.

Request Body

sessionId
string
required
ID da sessão que enviará a mensagem.
to
string
required
Destinatário (número com DDI ou JID).
latitude
number
required
Latitude da localização.Exemplo: -23.550520
longitude
number
required
Longitude da localização.Exemplo: -46.633308
name
string
Nome do local.Exemplo: "Av. Paulista, 1578"
address
string
Endereço completo.Exemplo: "Bela Vista, São Paulo - SP, 01310-200"
quoted
object
Responder a uma mensagem específica.
curl -X POST "https://api.oxenty.api.br/api/messages/location" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "sessionId": "550e8400-e29b-41d4-a716-446655440000",
    "to": "5511999999999",
    "latitude": -23.550520,
    "longitude": -46.633308,
    "name": "MASP - Museu de Arte de São Paulo",
    "address": "Av. Paulista, 1578 - Bela Vista, São Paulo"
  }'
{
  "messageId": "3EB0ABC123DEF456789GHI",
  "status": "sent",
  "to": "5511999999999@s.whatsapp.net",
  "timestamp": "2024-01-15T10:30:00.000Z"
}

Como o Destinatário Vê

A mensagem de localização mostra:
  • Preview do mapa com pin
  • Nome do local (se informado)
  • Endereço (se informado)
  • Botão “Abrir no Maps” que redireciona para Google Maps/Apple Maps
Se name e address não forem informados, será exibido apenas o mapa com as coordenadas.