curl -X POST https://api.whaapy.com/messages/v1 \
-H "Authorization: Bearer wha_TU_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"to": "+5215512345678",
"type": "location",
"location": {
"latitude": 19.4326,
"longitude": -99.1332,
"name": "Oficina Central Whaapy",
"address": "Av. Paseo de la Reforma 123, Col. Centro, CDMX"
}
}'
const response = await fetch('https://api.whaapy.com/messages/v1', {
method: 'POST',
headers: {
'Authorization': 'Bearer wha_TU_API_KEY',
'Content-Type': 'application/json'
},
body: JSON.stringify({
to: '+5215512345678',
type: 'location',
location: {
latitude: 19.4326,
longitude: -99.1332,
name: 'Oficina Central Whaapy',
address: 'Av. Paseo de la Reforma 123, Col. Centro, CDMX'
}
})
});
import requests
response = requests.post(
'https://api.whaapy.com/messages/v1',
headers={
'Authorization': 'Bearer wha_TU_API_KEY',
'Content-Type': 'application/json'
},
json={
'to': '+5215512345678',
'type': 'location',
'location': {
'latitude': 19.4326,
'longitude': -99.1332,
'name': 'Oficina Central Whaapy',
'address': 'Av. Paseo de la Reforma 123, Col. Centro, CDMX'
}
}
)
{
"messaging_product": "whatsapp",
"contacts": [
{ "input": "+5215512345678", "wa_id": "5215512345678" }
],
"messages": [
{ "id": "550e8400-e29b-41d4-a716-446655440000", "wamid": "wamid.HBgLNTIxNTUx..." }
],
"data": {
"id": "550e8400-e29b-41d4-a716-446655440000",
"conversationId": "660e8400-e29b-41d4-a716-446655440001",
"messageType": "location",
"direction": "outbound",
"status": "sent",
"createdAt": "2026-01-22T10:30:00Z"
}
}
Mensajes
Enviar Ubicación
Envía ubicaciones y coordenadas GPS por WhatsApp
POST
/
messages
/
v1
curl -X POST https://api.whaapy.com/messages/v1 \
-H "Authorization: Bearer wha_TU_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"to": "+5215512345678",
"type": "location",
"location": {
"latitude": 19.4326,
"longitude": -99.1332,
"name": "Oficina Central Whaapy",
"address": "Av. Paseo de la Reforma 123, Col. Centro, CDMX"
}
}'
const response = await fetch('https://api.whaapy.com/messages/v1', {
method: 'POST',
headers: {
'Authorization': 'Bearer wha_TU_API_KEY',
'Content-Type': 'application/json'
},
body: JSON.stringify({
to: '+5215512345678',
type: 'location',
location: {
latitude: 19.4326,
longitude: -99.1332,
name: 'Oficina Central Whaapy',
address: 'Av. Paseo de la Reforma 123, Col. Centro, CDMX'
}
})
});
import requests
response = requests.post(
'https://api.whaapy.com/messages/v1',
headers={
'Authorization': 'Bearer wha_TU_API_KEY',
'Content-Type': 'application/json'
},
json={
'to': '+5215512345678',
'type': 'location',
'location': {
'latitude': 19.4326,
'longitude': -99.1332,
'name': 'Oficina Central Whaapy',
'address': 'Av. Paseo de la Reforma 123, Col. Centro, CDMX'
}
}
)
{
"messaging_product": "whatsapp",
"contacts": [
{ "input": "+5215512345678", "wa_id": "5215512345678" }
],
"messages": [
{ "id": "550e8400-e29b-41d4-a716-446655440000", "wamid": "wamid.HBgLNTIxNTUx..." }
],
"data": {
"id": "550e8400-e29b-41d4-a716-446655440000",
"conversationId": "660e8400-e29b-41d4-a716-446655440001",
"messageType": "location",
"direction": "outbound",
"status": "sent",
"createdAt": "2026-01-22T10:30:00Z"
}
}
Comparte ubicaciones con coordenadas GPS, nombre del lugar y dirección. El usuario verá un mapa interactivo que puede abrir en su app de mapas preferida.
Las ubicaciones solo pueden enviarse dentro de la ventana de 24 horas. Fuera de la ventana, usa templates.
Ejemplo Básico
curl -X POST https://api.whaapy.com/messages/v1 \
-H "Authorization: Bearer wha_TU_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"to": "+5215512345678",
"type": "location",
"location": {
"latitude": 19.4326,
"longitude": -99.1332,
"name": "Oficina Central Whaapy",
"address": "Av. Paseo de la Reforma 123, Col. Centro, CDMX"
}
}'
const response = await fetch('https://api.whaapy.com/messages/v1', {
method: 'POST',
headers: {
'Authorization': 'Bearer wha_TU_API_KEY',
'Content-Type': 'application/json'
},
body: JSON.stringify({
to: '+5215512345678',
type: 'location',
location: {
latitude: 19.4326,
longitude: -99.1332,
name: 'Oficina Central Whaapy',
address: 'Av. Paseo de la Reforma 123, Col. Centro, CDMX'
}
})
});
import requests
response = requests.post(
'https://api.whaapy.com/messages/v1',
headers={
'Authorization': 'Bearer wha_TU_API_KEY',
'Content-Type': 'application/json'
},
json={
'to': '+5215512345678',
'type': 'location',
'location': {
'latitude': 19.4326,
'longitude': -99.1332,
'name': 'Oficina Central Whaapy',
'address': 'Av. Paseo de la Reforma 123, Col. Centro, CDMX'
}
}
)
Solo Coordenadas
Si solo tienes las coordenadas, puedes omitirname y address:
{
"to": "+5215512345678",
"type": "location",
"location": {
"latitude": 19.4326,
"longitude": -99.1332
}
}
Siempre incluye
name y address para una mejor experiencia de usuario. Sin estos campos, el usuario solo verá un pin en el mapa.Campos
number
required
Latitud de la ubicación. Valor entre -90 y 90.
number
required
Longitud de la ubicación. Valor entre -180 y 180.
string
Nombre del lugar (ej: “Oficina Central”, “Restaurante La Parrilla”). Máximo 1000 caracteres.
string
Dirección completa. Máximo 1000 caracteres.
Respuesta Exitosa
{
"messaging_product": "whatsapp",
"contacts": [
{ "input": "+5215512345678", "wa_id": "5215512345678" }
],
"messages": [
{ "id": "550e8400-e29b-41d4-a716-446655440000", "wamid": "wamid.HBgLNTIxNTUx..." }
],
"data": {
"id": "550e8400-e29b-41d4-a716-446655440000",
"conversationId": "660e8400-e29b-41d4-a716-446655440001",
"messageType": "location",
"direction": "outbound",
"status": "sent",
"createdAt": "2026-01-22T10:30:00Z"
}
}
Casos de Uso
Ubicación de tienda
Ubicación de tienda
{
"to": "+5215512345678",
"type": "location",
"location": {
"latitude": 19.4326,
"longitude": -99.1332,
"name": "Whaapy Store - Sucursal Centro",
"address": "Av. Reforma 123, Piso 5, Col. Centro, CDMX, CP 06600"
}
}
Punto de entrega
Punto de entrega
{
"to": "+5215512345678",
"type": "location",
"location": {
"latitude": 19.4126,
"longitude": -99.1632,
"name": "Punto de Entrega - Pedido #12345",
"address": "Tu pedido será entregado aquí"
}
}
Ubicación del repartidor
Ubicación del repartidor
{
"to": "+5215512345678",
"type": "location",
"location": {
"latitude": 19.4226,
"longitude": -99.1432,
"name": "Tu repartidor está aquí",
"address": "A 5 minutos de tu ubicación"
}
}
Obtener Coordenadas
Puedes obtener coordenadas de varias formas:- Google Maps: Click derecho en el mapa → “¿Qué hay aquí?” → Copia las coordenadas
- API de Geocoding: Convierte direcciones a coordenadas con Google Maps API, Mapbox, etc.
- GPS del dispositivo: Si tu app tiene acceso a la ubicación del usuario
Ejemplo con Google Geocoding API
// Convertir dirección a coordenadas
async function getCoordinates(address) {
const response = await fetch(
`https://maps.googleapis.com/maps/api/geocode/json?address=${encodeURIComponent(address)}&key=TU_API_KEY`
);
const data = await response.json();
if (data.results[0]) {
const { lat, lng } = data.results[0].geometry.location;
return { latitude: lat, longitude: lng };
}
throw new Error('Dirección no encontrada');
}
Próximos Pasos
Enviar Contactos
Comparte tarjetas vCard
Enviar Reacciones
Reacciona a mensajes con emojis
Was this page helpful?