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

# Mensajes de solicitud de ubicación

Los mensajes de solicitud de ubicación muestran el texto del cuerpo y un botón de envío de ubicación. Cuando un usuario de WhatsApp toca el botón, se muestra una pantalla que el usuario puede usar para compartir la ubicación.

> Una vez que el usuario comparte su ubicación, se activa un webhook de mensajes que contiene los detalles de la ubicación del usuario.

<img src="https://mintcdn.com/heybot/V-xiw4Dp5VkEstVO/images/request-location.png?fit=max&auto=format&n=V-xiw4Dp5VkEstVO&q=85&s=1507493d02aa48acda834823c7719f4a" width="2037" height="1276" data-path="images/request-location.png" />

<ParamField body="to" type="string" required>
  The recipient's phone number or WhatsApp ID.
</ParamField>

<ParamField body="type" type="string" required default="interactive">
  The overall type of message being sent.
</ParamField>

<ParamField body="interactive" type="object" required>
  The interactive message payload configuration.

  <Expandable title="interactive properties" defaultOpen={true}>
    <ParamField body="type" type="string" required default="location_request_message">
      The specific type of interactive message you are sending.
    </ParamField>

    <ParamField body="body" type="object" required>
      The main content of the message.

      <Expandable title="body properties">
        <ParamField body="text" type="string" required>
          The primary text content that explains why you are asking for their location. Supports URLs (Maximum 1024 characters).
        </ParamField>
      </Expandable>
    </ParamField>

    <ParamField body="action" type="object" required>
      The configuration for the location request button.

      <Expandable title="action properties">
        <ParamField body="name" type="string" required default="send_location">
          The name of the action being performed. Must be set to `send_location`.
        </ParamField>
      </Expandable>
    </ParamField>
  </Expandable>
</ParamField>

## Ejemplo

```json theme={null}
{
  "to": 5219876543210,
  "type": "interactive",
  "interactive": {
    "type": "location_request_message",
    "body": {
      "text": "<BODY_TEXT>"
    },
    "action": {
      "name": "send_location"
    }
  }
}
```
