# 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](/es/send/text/#campos-comunes).

## Enviar una ubicación

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 |

  **cURL**

```bash
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"
  }
}'
```

  **TypeScript**

```ts
import { Messajo } from "@messajo/sdk";

const messajo = new Messajo({ apiKey: process.env.MESSAJO_API_KEY! });

const message = await messajo.messages.send({
  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",
  },
});
console.log(message.id, message.status);
```

  **n8n**
n8n HTTP Request: POST https://api.messajo.com/v1/messages

```json
{
  "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.

## Pedir la ubicación del contacto

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`.

  **cURL**

```bash
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" }
  }
}'
```

  **TypeScript**

```ts
await messajo.messages.send({
  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" },
  },
});
```

  **n8n**
n8n HTTP Request: POST https://api.messajo.com/v1/messages

```json
{
  "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" }
  }
}
```

### Recibir la respuesta

Cuando el contacto comparte su ubicación, llega un evento [`message.received`](/es/webhooks/events/) con `content.type: "location"`:

```json
{
  "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.

## Instagram y Messenger

No aceptan `location` ni `interactive`: devuelven `422 type_not_supported_by_channel`.

## Errores

| 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 |
