Hibot WhatsApp Business API: India Address Messages Complete Guide

Bot Automation
Apr 8
5 min read

Address Messages on Hibot WhatsApp Business API allow Indian businesses to collect a customer’s shipping or delivery address directly inside WhatsApp.

Instead of asking customers to type their address manually in chat, businesses can send an interactive address form. The customer simply taps the message, fills out their address, and submits it.

This feature is currently available only for businesses in India and customers with Indian phone numbers.

What Are Address Messages?

Address Messages are interactive WhatsApp messages that open a built-in address form.

Customers can quickly enter:

Full Name
Phone Number
Pin Code
House or Flat Number
Building Name
Landmark
City
State

Once submitted, the address is delivered securely to your business through webhook notifications.

This is useful for:

Ecommerce orders
COD confirmations
Delivery address collection
Food delivery businesses
Logistics companies
Appointment-based businesses

Supported Address Fields

The following fields are supported in India address messages:

Field	Label Shown to User	Notes
name	Name	No limit
phone_number	Phone Number	Must be a valid Indian number
in_pin_code	Pin Code	Maximum 6 digits
house_number	Flat / House Number	Optional
floor_number	Floor Number	Optional
tower_number	Tower Number	Optional
building_name	Building / Apartment Name	Optional
address	Address	Street / Area
landmark_area	Landmark / Area	Optional
city	City	Required
state	State	Required

Basic Address Message Request

Use the following API request to ask a customer for their delivery address.

curl -X POST \
'https://graph.facebook.com/v25.0/<PHONE_NUMBER_ID>/messages' \
-H 'Authorization: Bearer <ACCESS_TOKEN>' \
-H 'Content-Type: application/json' \
-d '
{
  "messaging_product": "whatsapp",
  "recipient_type": "individual",
  "to": "91XXXXXXXXXX",
  "type": "interactive",
  "interactive": {
    "type": "address_message",
    "body": {
      "text": "Thanks for your order! Please share your delivery address."
    },
    "action": {
      "name": "address_message",
      "parameters": {
        "country": "IN"
      }
    }
  }
}'

Important: The country parameter is mandatory. For India, always use:

"country": "IN"

If you do not include the country field, the API will return a validation error.

Address Message with Prefilled Values

You can make the customer experience faster by pre-filling known details such as name and phone number.

curl -X POST \
'https://graph.facebook.com/v25.0/<PHONE_NUMBER_ID>/messages' \
-H 'Authorization: Bearer <ACCESS_TOKEN>' \
-H 'Content-Type: application/json' \
-d '
{
  "messaging_product": "whatsapp",
  "recipient_type": "individual",
  "to": "91XXXXXXXXXX",
  "type": "interactive",
  "interactive": {
    "type": "address_message",
    "body": {
      "text": "Please confirm your delivery address."
    },
    "action": {
      "name": "address_message",
      "parameters": {
        "country": "IN",
        "values": {
          "name": "Rahul Sharma",
          "phone_number": "+919876543210"
        }
      }
    }
  }
}'

With this setup, the user only needs to fill the remaining address details.

Send Saved Addresses

If your business already has a customer’s saved address, you can send it directly in the message.

The customer can:

Select the saved address instantly
Or choose “Add New Address” and enter a different one

"saved_addresses": [
  {
    "id": "address1",
    "value": {
      "name": "Rahul Sharma",
      "phone_number": "+919876543210",
      "in_pin_code": "400063",
      "floor_number": "8",
      "address": "Wing A, Cello Triumph, IB Patel Rd",
      "landmark_area": "Goregaon",
      "city": "Mumbai"
    }
  }
]

Full Example:

curl -X POST \
'https://graph.facebook.com/v25.0/<PHONE_NUMBER_ID>/messages' \
-H 'Authorization: Bearer <ACCESS_TOKEN>' \
-H 'Content-Type: application/json' \
-d '
{
  "messaging_product": "whatsapp",
  "recipient_type": "individual",
  "to": "91XXXXXXXXXX",
  "type": "interactive",
  "interactive": {
    "type": "address_message",
    "body": {
      "text": "Select your saved delivery address or add a new one."
    },
    "action": {
      "name": "address_message",
      "parameters": {
        "country": "IN",
        "saved_addresses": [
          {
            "id": "address1",
            "value": {
              "name": "Rahul Sharma",
              "phone_number": "+919876543210",
              "in_pin_code": "400063",
              "floor_number": "8",
              "address": "Wing A, Cello Triumph, IB Patel Rd",
              "landmark_area": "Goregaon",
              "city": "Mumbai"
            }
          }
        ]
      }
    }
  }
}'

Handling Invalid Addresses

Sometimes a customer may enter an invalid pin code or incomplete address.

You can resend the address message with validation errors so the customer knows exactly what needs to be corrected.

Example:

curl -X POST \
'https://graph.facebook.com/v25.0/<PHONE_NUMBER_ID>/messages' \
-H 'Authorization: Bearer <ACCESS_TOKEN>' \
-H 'Content-Type: application/json' \
-d '
{
  "messaging_product": "whatsapp",
  "recipient_type": "individual",
  "to": "91XXXXXXXXXX",
  "type": "interactive",
  "interactive": {
    "type": "address_message",
    "body": {
      "text": "Please correct the address details below."
    },
    "action": {
      "name": "address_message",
      "parameters": {
        "country": "IN",
        "values": {
          "name": "Rahul Sharma",
          "phone_number": "+919876543210",
          "in_pin_code": "666666",
          "address": "Some Other Location",
          "city": "Delhi"
        },
        "validation_errors": {
          "in_pin_code": "We could not locate this pin code."
        }
      }
    }
  }
}'

The customer will see the error message directly inside the address form and will not be able to submit until the problem is fixed.

Successful API Response

When the address message is sent successfully, WhatsApp returns a message ID.

{
  "messaging_product": "whatsapp",
  "contacts": [
    {
      "input": "91XXXXXXXXXX",
      "wa_id": "91XXXXXXXXXX"
    }
  ],
  "messages": [
    {
      "id": "wamid.ID"
    }
  ]
}

You can store this message ID to track delivery and customer response.

How Address Message Flow Works

Business sends an address message
Customer taps the CTA button
WhatsApp opens the address form
Customer fills in or selects a saved address
Customer submits the form
Hibot receives the completed address through webhook notifications

Webhook Response for Submitted Address

After the customer submits the form, your webhook will receive the full address data.

Example webhook:

{
  "messages": [
    {
      "type": "interactive",
      "interactive": {
        "type": "nfm_reply",
        "nfm_reply": {
          "name": "address_message",
          "body": "Rahul Sharma\n+919876543210\n400063, Goregaon, Wing A, Cello Triumph, Mumbai",
          "response_json": "{\"saved_address_id\":\"address1\",\"values\":{\"in_pin_code\":\"400063\",\"city\":\"Mumbai\",\"name\":\"Rahul Sharma\"}}"
        }
      }
    }
  ]
}

The response_json field contains the complete address details entered by the customer.

Important Error: Receiver Incapable

If the customer’s WhatsApp version or device does not support address messages, the message may fail.

Example webhook error:

{
  "statuses": [
    {
      "status": "failed",
      "errors": [
        {
          "code": 1026,
          "title": "Receiver Incapable"
        }
      ]
    }
  ]
}

Error Code 1026 means the recipient’s device does not support address messages.

In this case, you should fall back to a normal text message asking the customer to manually type their address.

Important Rules for India Address Messages

Available only for India businesses and India customers
Customer number must begin with +91
Country parameter must always be IN
Pin code supports maximum 6 digits
Address data is returned only through webhooks
Businesses should always validate submitted addresses before processing orders

Best Practices

To get the best results with Hibot Address Messages:

Prefill name and phone number whenever possible
Save previously used addresses for repeat customers
Use validation errors for wrong pin codes or missing address fields
Always verify city and pin code before dispatching an order
Keep the message short and clear
Use address messages immediately after order confirmation

Example customer-friendly message:

Thanks for your order! Please share your delivery address so we can dispatch your package quickly.

Why Use Hibot Address Messages?

With Hibot WhatsApp Business API, Address Messages help businesses:

Reduce delivery errors
Collect accurate shipping details faster
Improve order completion rate
Give customers a smoother checkout experience
Eliminate manual address typing in chat

For ecommerce brands, restaurants, pharmacies, and delivery businesses in India, Address Messages are one of the fastest ways to collect customer shipping information directly inside WhatsApp.