Ir al contenido

Enviar mensajes

Enviar y pedir ubicación

Envía un punto en el mapa o pide al contacto que comparta su ubicación en WhatsApp.

Dos tareas de ubicación, ambas solo en WhatsApp: enviar un punto en el mapa y pedir la ubicación del contacto. Los campos comunes a todos los tipos (to, reply_to, typing, delay_ms, ventana de 24 h) están en Campos comunes.

Usa type: "location" en POST /v1/messages.

Campo Regla
location.latitude Número de -90 a 90
location.longitude Número de -180 a 180
location.name Opcional, hasta 256 caracteres
location.address Opcional, hasta 512 caracteres
Ventana de terminal
curl -X POST https://api.messajo.com/v1/messages \
-H "Authorization: Bearer $MESSAJO_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"connection_id": "con_123",
"to": "5511999990000",
"type": "location",
"location": {
"latitude": -23.5614,
"longitude": -46.6559,
"name": "Tienda Paulista",
"address": "Av. Paulista, 1000, São Paulo"
}
}'

La respuesta es 201 con id (msg_…), status: "queued" y conversation_id. El estado final llega por webhook.

Usa type: "interactive" con interactive.type: "location_request_message". El contacto ve el texto y un botón para compartir su ubicación. body.text tiene hasta 1024 caracteres y action.name es siempre send_location.

Ventana de terminal
curl -X POST https://api.messajo.com/v1/messages \
-H "Authorization: Bearer $MESSAJO_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"connection_id": "con_123",
"to": "5511999990000",
"type": "interactive",
"interactive": {
"type": "location_request_message",
"body": { "text": "¿A dónde enviamos tu pedido?" },
"action": { "name": "send_location" }
}
}'

Cuando el contacto comparte su ubicación, llega un evento message.received con content.type: "location":

{
"type": "location",
"latitude": -23.5614,
"longitude": -46.6559,
"name": null,
"address": null,
"url": null
}

name, address y url vienen null cuando el contacto no los informa. Si ignora la solicitud, no llega nada.

No aceptan location ni interactive: devuelven 422 type_not_supported_by_channel.

Código Estado Cuándo
outside_service_window 422 Mensaje libre fuera de la ventana de 24 h
validation_failed 400 Latitud o longitud fuera de rango, o texto por encima del límite
type_not_supported_by_channel 422 Instagram o Messenger