> ## Documentation Index
> Fetch the complete documentation index at: https://docs.jelou.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Solicitud de Ubicación

> Envía un mensaje con un botón para solicitar la ubicación del usuario

Disponible solo en WhatsApp

```bash cURL theme={null}
curl --request POST \
  --url https://api.jelou.ai/v1/bots/BOT_ID/messages \
  --header 'Authorization: Basic <Base64Encoded clientId:clientSecret>' \
  --header 'Content-Type: application/json' \
  --data '{
    "type": "location_request",
    "text": "Por favor comparte tu ubicación para encontrar tiendas cercanas",
    "userId": "USER_ID"
  }'
```

```json 200 theme={null}
{
  "success": true,
  "messageId": "msg_123456789"
}
```

## Parámetros de ruta

**botId** `string` *required*

Identificador único del bot que envía el mensaje.

## Parámetros del cuerpo

**type** `string` *required*

Tipo de mensaje. Debe ser `"location_request"`.

**userId** `string` *required*

Destinatario del mensaje. Acepta un número de teléfono en formato E.164 sin el signo `+` (ej: `593999999999`) o un BSUID (ej: `US.13491208655302741918`) para usuarios con protección de número activada en WhatsApp. Consulta [Identificación del destinatario](https://docs.jelou.ai/api/envia-mensajes/Envio-de-mensajes.md#identificación-del-destinatario).

**text** `string` *required*

Texto que acompaña al botón para compartir ubicación.

## Respuesta

**success** `boolean`

`true` si el mensaje se envió correctamente.

**messageId** `string`

Identificador del mensaje enviado.

## Mejores Prácticas

> [!WARNING]
>
> **Privacidad:** Siempre explica por qué necesitas la ubicación del usuario. Sé transparente sobre cómo se usará la información de ubicación y respeta la privacidad del usuario.

## Casos de Uso

* Encontrar tiendas o servicios cercanos
* Solicitar ubicación de entrega
* Proporcionar direcciones personalizadas
* Servicios basados en ubicación


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.