# Request the user's location — Whatsapp Business Cloud API

Botize method — `whatsapp_cloud_api.ask_location` (action).

Send a message, an image/video/document or both to a specific chat and wait for the user's response by sending a location.

- The following tags are currently supported in the messages: b, strong , i, em, u, ins, s, strike, del, a, code, pre.

This is an action: it runs as a step of a task. Several can be chained.

## Fields you set

The field's internal name, its type and the values it accepts. These fields accept `{{...}}` tags from earlier steps.

- `mb_switch` *(boolean)* — Rules
- `message` *(string)* — Question
- `specific_chat` *(boolean)* — Send the question to a different chat
- `to_phone_number` *(string)* — To Phone Number or User Id
- `mb_outputvars_switch` *(boolean)* — Customize tags

It also accepts repeatable field groups, with these prefixes: `mb_filters_*`. These are composite components (buttons, filters, keyboards); the trailing number is set by the user as they are added.

## Output variables

Data this step makes available. Reference them in later steps with the double-brace tag.

- `{{from_number}}` *(text)* — From Phone Number or User Id. Phone number or User Id (BSUID) of the user who responded.
For example: 34691000000 or US.13491208655302741918
- `{{from_name}}` *(text)* — From User Name. Name of the user who responded.
For example: Mark
- `{{message_id}}` *(int)* — Message Id. Id of the message that WhatsApp has assigned to the user's response.
For example: wamid.HBgLMzQ2BMENBNzI3NAA=
- `{{latitude}}` *(int)* — Latitude. Location latitude.
For example: 35.6895
- `{{longitude}}` *(int)* — Longitude. Location longitude.
For example: 139.69171
- `{{name}}` *(text)* — Location Name. Location name.
- `{{address}}` *(text)* — Address. Location address.
- `{{url}}` *(url)* — URL. Location URL.
- `{{user_id}}` *(text)* — User Id. Business-Scoped User Id (BSUID) that uniquely identifies the user. Always present even when the phone number is not available.
For example: US.13491208655302741918
- `{{phone_number}}` *(text)* — Phone Number (empty if not available). Phone number of the user who responded. It is empty when WhatsApp does not provide it (users with a username or with the phone number hidden), and in that case the User Id is the only identifier available.
For example: 34691000000

## Account

Needs a connected Whatsapp Business Cloud API account in Botize: https://botize.com/en/app/whatsapp_cloud_api/authenticate

## This app

Every trigger and action for Whatsapp Business Cloud API: https://botize.com/en/app/whatsapp_cloud_api.md

## How to build this

An AI assistant (Claude, ChatGPT, Cursor…) can create and edit these tasks in the user's account through the Botize MCP connector, included in every plan:

    https://webhook.botize.es/mcp

- Connection guide: https://botize.com/en/mcp
- Agent map: https://botize.com/llms.txt
- New account: https://botize.com/en/join (500 free operations, no card)

---
Machine-readable summary for AI assistants. Human version: https://botize.com/en/method/whatsapp_cloud_api/ask_location