WhatsApp Address Message API: Setup Guide for India
To send a WhatsApp Address Message, use the address_message interactive type. Make a POST request to your API endpoint. You must include the country parameter. Users can then fill out their shipping details. The data returns via an nfm_reply webhook.
Collecting shipping details is hard. External links break. Users drop off. The WhatsApp Address Message API fixes this. It keeps buyers in the chat. It acts like a native app form.
The API has strict rules. If you forget to include the country code in your call, it fails instantly. Always hardcode 'IN' for the country parameter. This simple step saves you hours of debugging.
Key Concepts Covered in This Guide
- Core Topic Entity: WhatsApp Address Message API
- Primary Problem Entity: Manual Address Collection
- Core Solution Entity: Interactive Address Message
- Supporting Sub-Entities: Native Flow Response, Error 1026
- Platform Mentioned: WhatsApp Cloud API
- Desired Outcome: Automated Shipping Data
What is the WhatsApp Address Message?
It is a smart interactive form. It lives inside WhatsApp.
You no longer need messy text replies. Before you build this form, you must understand how interactive chat experiences work. Reading WhatsApp Flows in 2025: What They Are and 12 High Converting Use Cases will help you design native checkout flows that convert.
WhatsApp Address Message API works with the India WhatsApp address format to solve manual data entry and achieve fast checkout flows.
The form collects vital data. It asks for the name and phone_number. It asks for the in_pin_code (max 6 digits). It also gathers the flat number, building name, and city. Right now, this feature is strictly for businesses and users in India.
How to Send an Address Message
You must send a POST request. Target your messages endpoint.
Use the interactive message type. Set the action name to address_message.
Your JSON payload must have the country parameter. If you miss this, you get a validation error. Do not send an India request to a +65 phone number. The area code must match the country.
You can also pass saved_addresses. This is a great feature. It lets returning users pick an old address. It makes their checkout much faster.
Prefilling Data & Handling Errors
Do not make users type everything twice. Pre-fill the form.
You can pass a values parameter. This prefills fields like the city or state. It saves the user time.
What if they type a bad pin code? Use WhatsApp API validation errors. You can send errors back to the app. The app will stop them from submitting. It forces them to fix the typo first.
Receiving the Webhook Data
When a user hits submit, Meta pings your server.
You get a webhook notification. Look for the nfm_reply object. This stands for WhatsApp native flow response.
Inside this object, you will find response_json. This holds the clean, structured address data. Parse this JSON. Save it to your database.
If the user has an old app version, the form will not load. You will see error code 1026 WhatsApp. This means "Receiver Incapable." If this happens, fall back to a normal text question.
Conclusion
This feature is a game changer for e-commerce. It speeds up sales. It stops shipping errors. It keeps users happy. Build this native form into your bot flow today.
Automate your WhatsApp sales with WUSeller. We handle complex API payloads so you can focus on growth. Start for free today's.
Frequently Asked Questions
How to send an address message on WhatsApp API?
Send a POST request with the interactive type. You must use the address_message action name. You must also include the country parameter (like "IN" for India) in your JSON payload.
Why is my WhatsApp address message failing?
Check your country and area codes. If your user has a non-India phone number, the request will fail. The area code must match the specified country parameter perfectly.
What fields are in the WhatsApp address message?
It includes name, phone, pin code, and street details. The India WhatsApp address format includes specific fields like in_pin_code, house_number, building_name, landmark_area, city, and state.
How to prefill WhatsApp address fields?
Pass the values object in your API call. You can inject known data. Include the values parameter inside your action payload. This prefills the form, saving the user time.
How to fix WhatsApp error code 1026 receiver incapable?
The user needs to update their app. Error code 1026 WhatsApp means the user's phone software cannot render the interactive form. You should set up a fallback to ask for the address via plain text.