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"
}'
const message = await client.messages.sendLocation(sessionId, {
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',
});
message = client.messages.send_location(
session_id,
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"
}
{
"statusCode": 400,
"error": "VALIDATION_ERROR",
"message": "Coordenadas inválidas"
}
Mensagens
Enviar Localização
Envia uma localização no mapa
POST
/
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"
}'
const message = await client.messages.sendLocation(sessionId, {
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',
});
message = client.messages.send_location(
session_id,
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"
}
{
"statusCode": 400,
"error": "VALIDATION_ERROR",
"message": "Coordenadas inválidas"
}
Envia uma localização geográfica para um contato ou grupo.
Request Body
string
required
ID da sessão que enviará a mensagem.
string
required
Destinatário (número com DDI ou JID).
number
required
Latitude da localização.Exemplo:
-23.550520number
required
Longitude da localização.Exemplo:
-46.633308string
Nome do local.Exemplo:
"Av. Paulista, 1578"string
Endereço completo.Exemplo:
"Bela Vista, São Paulo - SP, 01310-200"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"
}'
const message = await client.messages.sendLocation(sessionId, {
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',
});
message = client.messages.send_location(
session_id,
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"
}
{
"statusCode": 400,
"error": "VALIDATION_ERROR",
"message": "Coordenadas inválidas"
}
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.