How to Send WhatsApp Location Messages Using the Official API

Location Messages in the WhatsApp Official API make it easy for businesses to share a physical address directly inside a WhatsApp conversation.

Instead of typing a long address manually, businesses can send a location pin with coordinates, business name, and address. Customers can then tap the message to open the location in their preferred map application.

With Hibot, location messages are perfect for helping customers find stores, offices, delivery points, event venues, and service locations.

What Are WhatsApp Location Messages?

A WhatsApp Location Message lets businesses send:

• Latitude

• Longitude

• Optional location name

• Optional address

When the customer receives the message, WhatsApp displays it as an interactive map card.

Users can tap the location to:

• Open it in Google Maps or Apple Maps

• Get directions

• Save the location

• Share it with others

Why Businesses Use Location Messages

Typing an address into WhatsApp can often create confusion, especially if:

• The address is long

• The customer is unfamiliar with the area

• There are multiple store branches

• The location is difficult to find

Location messages solve this problem by sending an exact map pin.

Benefits include:

• Faster navigation for customers

• Fewer missed appointments

• Better customer experience

• Easier delivery coordination

• More accurate directions

• 
  

Common Use Cases

Businesses commonly use WhatsApp location messages for:

• Sending store or office locations

• Sharing restaurant directions

• Showing event venues

• Guiding delivery drivers

• Helping customers find pickup points

• Sharing technician or service visit locations

For example:

• A restaurant can send its branch location.

• A clinic can share the hospital address before an appointment.

• A real estate company can send the property location.

• A delivery company can share the pickup point.

• 
  

API Endpoint

To send a location message, use:

POST /<WHATSAPP_BUSINESS_PHONE_NUMBER_ID>/messages

Basic request structure:

curl 'https://graph.facebook.com/v25.0/<WHATSAPP_BUSINESS_PHONE_NUMBER_ID>/messages' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
-d '
{
  "messaging_product": "whatsapp",
  "recipient_type": "individual",
  "to": "<CUSTOMER_PHONE_NUMBER>",
  "type": "location",
  "location": {
    "latitude": "37.44216251868683",
    "longitude": "-122.16153582049394"
  }
}'

The latitude and longitude fields are required.

Required and Optional Fields

Field	Required	Description
latitude	Yes	Latitude coordinate in decimal format
longitude	Yes	Longitude coordinate in decimal format
name	No	Location or business name
address	No	Full location address

Example values:

Field	Example
Latitude	37.44216251868683
Longitude	-122.16153582049394
Name	Philz Coffee
Address	101 Forest Ave, Palo Alto, CA 94301

Example Request

This example sends a business location with coordinates, name, and address.

curl 'https://graph.facebook.com/v25.0/106540352242922/messages' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
-d '
{
  "messaging_product": "whatsapp",
  "recipient_type": "individual",
  "to": "+16505551234",
  "type": "location",
  "location": {
    "latitude": "37.44216251868683",
    "longitude": "-122.16153582049394",
    "name": "Philz Coffee",
    "address": "101 Forest Ave, Palo Alto, CA 94301"
  }
}'

When the customer receives this message, they will see a location pin card titled “Philz Coffee” with the provided address.

Example Response

After the API request is successful, WhatsApp returns a message ID.

{
  "messaging_product": "whatsapp",
  "contacts": [
    {
      "input": "+16505551234",
      "wa_id": "16505551234"
    }
  ],
  "messages": [
    {
      "id": "wamid.HBgLMTY0NjcwNDM1OTUVAgARGBI1RjQyNUE3NEYxMzAzMzQ5MkEA"
    }
  ]
}

You can use this message ID for tracking, logging, or debugging inside Hibot.

Best Practices for WhatsApp Location Messages

1. Always include both coordinates and a readable name.Coordinates help WhatsApp locate the place precisely, while the name makes it easier for users to recognize.

2. Add the full address whenever possible.This provides additional context and helps customers confirm they are going to the correct place.

3. Use accurate coordinates.Even a small coordinate error can direct customers to the wrong location.

4. Send the location at the right moment.Good examples include:

   • After booking an appointment

   • Before an event starts

   • After confirming a pickup order

   • During delivery updates

5. Combine location messages with text messages.For example:

“Your appointment is tomorrow at 10:00 AM. Here is the clinic location.”

Then send the location message immediately afterward.

Business Examples

Retail Stores

Send the nearest branch location to customers.

Restaurants

Help customers find your restaurant or pickup counter.

Healthcare

Share the clinic or hospital address before appointments.

Logistics and Delivery

Send warehouse, pickup, or delivery meeting point locations.

Real Estate

Share property coordinates with potential buyers.

Events and Training

Guide attendees to the correct venue.

Why Use Hibot for WhatsApp Location Messages?

Hibot helps businesses automate location sharing inside customer journeys.

With Hibot, you can:

• Automatically send store locations after a customer asks for directions

• Share appointment locations instantly

• Send pickup points after an order is placed

• Include locations inside automated WhatsApp flows

• Improve customer convenience and reduce confusion

Whether you run a retail store, clinic, restaurant, logistics business, or event company, WhatsApp location messages make it easier for customers to reach you.

Start using Hibot to send smart location messages and guide customers exactly where they need to go.