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

# WhatsApp Location Messages

> Learn how to configure and send interactive location messages on WhatsApp using ChatbotX Flow Builder for seamless map navigation.

When interacting with customers on WhatsApp, sending a plain text address often forces them to manually copy, switch apps, and paste it into a navigation service. With **WhatsApp Location Messages** powered by the WhatsApp Business API on ChatbotX, you can send an interactive map card with precise GPS coordinates.

Recipients can tap the map card directly in WhatsApp to open Google Maps or Apple Maps and get turn-by-turn driving or walking directions instantly.

![WhatsApp Location Message Phone Preview](https://mintcdn.com/chatbotx/NZTW5lLyvthzKBU1/images/whatsapp_location_message_phone_view.png?fit=max\&auto=format\&n=NZTW5lLyvthzKBU1\&q=85\&s=6101fa511ae881a47a42a3449cbcb2c0)

> [!NOTE]
>
> The dedicated Location Message content block is a native capability of the **WhatsApp Business API** and is specifically available for the **WhatsApp** channel inside the Flow Builder.

## Location Message Structure

A WhatsApp location message consists of four primary properties:

| Property | Required | Character Limit | Function & Display |
| :- | :- | :- | :- |
| **Name** | Optional | Up to 1,000 characters | The venue or business name, highlighted in bold green text on the WhatsApp card (e.g., Company HQ, Store Branch). Supports dynamic variables via the `{}` icon. |
| **Address** | Optional | Up to 1,000 characters | Detailed street address displayed beneath the venue name. Supports dynamic variables via the `{}` icon. |
| **Latitude** | **Required** | Decimal format | Decimal GPS latitude coordinate of the location (e.g., `37.4220656` or `1.2833754`). |
| **Longitude** | **Required** | Decimal format | Decimal GPS longitude coordinate of the location (e.g., `-122.0840897` or `103.8607255`). |

> [!TIP]
>
> While **Name** and **Address** are optional, it is recommended to populate both so customers have clear context before launching their map app.

## Step-by-Step Flow Builder Setup

Follow these steps to add a Location Message block to your WhatsApp automated flows:

**1. Select WhatsApp Channel in Send Message Block**

In the Flow Builder, open the **Send Message** node you want to configure. Under **Choose Channel** at the top, select **Whatsapp**.

**2. Add the Location Block**

Click the **+ Add** button beneath your message content. The list of supported WhatsApp message types will appear. Scroll to the bottom and click **Location**.

![Select Location from WhatsApp Content Menu](https://mintcdn.com/chatbotx/NZTW5lLyvthzKBU1/images/whatsapp_location_block_menu.png?fit=max\&auto=format\&n=NZTW5lLyvthzKBU1\&q=85\&s=871dd137d08bca3a0d99ede74050690f)

**3. Enter Venue Details and GPS Coordinates**

The **Location** configuration modal will pop up:

![Location Message Configuration Modal](https://mintcdn.com/chatbotx/NZTW5lLyvthzKBU1/images/whatsapp_location_modal_settings.png?fit=max\&auto=format\&n=NZTW5lLyvthzKBU1\&q=85\&s=41e2c3c3f4146830eb090d51750ca9fb)

1. **Name (optional):** Enter the place name or click the `</>` icon to insert a Custom Field if you are dynamically personalizing store locations for each contact.
2. **Address (optional):** Enter the detailed physical address.
3. **Latitude:** Enter the decimal latitude coordinate.
4. **Longitude:** Enter the decimal longitude coordinate.

Click **Continue** to save the location block.

**4. Publish Your Flow**

Connect subsequent actions or conditions if needed, then click **Publish** in the top-right corner to deploy your flow live.

## How to Get Exact GPS Coordinates from Google Maps

To retrieve precise latitude and longitude values:

1. Open [Google Maps](https://www.google.com/maps) in your desktop browser.
2. Search for your business, office, or event venue.
3. Right-click directly on the red location marker.
4. Click on the first row showing coordinate numbers (for example: `37.4220656, -122.0840897`) to copy them to your clipboard:
   * The first number is **Latitude**: `37.4220656`
   * The second number is **Longitude**: `-122.0840897`
5. Paste each value into its respective field inside ChatbotX.

> [!NOTE]
>
> Do not paste both numbers with a comma into a single input field. Latitude and Longitude must be entered separately.

## Common Use Cases

### Retail Stores and Franchise Branches

When customers ask for the nearest outlet, your bot can evaluate their preferred region or custom field attributes and automatically deliver the exact branch location card.

### Restaurant Reservations

Following a successful table reservation confirmation, send the venue location card so diners can effortlessly navigate to the restaurant upon departure.

### In-Person Workshops and Events

Send location reminder alerts 2 to 3 hours prior to event commencement to guide attendees smoothly to the venue entrance.

### Curbside Pickup and Logistics

Provide direct location coordinates for distribution hubs or self-service pickup counters for Click & Collect orders.


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