# Ask Address

{% embed url="<https://app.supademo.com/demo/cmmaez14r7w3vdtfhmnqq5u6l?utm_source=link>" %}

The **Ask Address** action allows the chatbot to collect a **complete address from users** during a conversation.

Unlike simple text input, this action captures **structured address details** such as the user's name, phone number, house number, city, state, and postal code. This ensures accurate and organized address collection for services such as deliveries, bookings, or service requests.

The collected address information is stored in variables and can be used later in the chatbot workflow for order processing, delivery management, or customer records.

### **When to Use Ask Address**

Use the **Ask Address** action when the chatbot needs to collect **detailed delivery or contact address information** from users.

**Common Use Cases**

* Delivery address collection
* Shipping address for e-commerce orders
* Service location for home services
* Customer registration forms
* Appointment service addresses

Example interaction:

Bot: To ensure your order reaches you perfectly, please provide your full delivery address.\
\
User: Provides name, phone number, house number, city, and postal code.

The chatbot collects and stores the address details for further workflow processing.

### **How to Add Ask Address**

Follow these steps to add the Ask Address action to your bot workflow.

* Open **Bot Builder**
* Click **Add Node**
* Select the **Ask** tab
* Choose **Ask Address**
* Configure the required fields
* Click **Create**

Once added, the chatbot prompts users to provide their full address details.

### **Ask Address Configuration**

When creating an Ask Address action, several configuration fields must be completed.

#### **Action Name**

The **Action Name** identifies the address collection step inside the workflow.

Example:

Shipping Address Collection\
Delivery Address Input\
Customer Address Form

The walkthrough example uses **"Shipping Address Collection"** as the action name.

#### **Message**

The **Message** field contains the prompt displayed to the user requesting their address.

Example:

To ensure your order reaches you perfectly, please provide your full delivery address below.\
\
Include your house/apartment number, street name, city, and zip code.

This message guides users to provide complete address details.

The message supports:

* Dynamic variables
* Text formatting
* Emojis

Variables can be inserted using the **Add Variable** option.

#### **Fill Predefined Values**

The **Fill Predefined Values** option allows the chatbot to **automatically populate address fields using existing customer data**.

When enabled, fields such as name or phone number can be pre-filled using stored customer variables.

Example:

Name → {{customer.name}}\
Phone → {{customer.phoneNo}}

This helps reduce manual input and improves user experience.

#### **Address Fields**

The Ask Address action collects multiple structured fields.

Common fields include:

**Name**

Customer name.

**Phone Number**

Customer contact number.

**Pin Code**

Postal code or zip code.

**House Number**

House or apartment number.

**Floor Number**

Apartment or building floor number.

**Tower Number**

Building or tower identifier.

**Building Name**

Name of the building or apartment complex.

**City**

City of the delivery address.

**State**

State or region.

These fields help capture complete address information for delivery or service purposes.

### **Adding Variables to Address Fields**

Each address field can be connected to a variable using the **Add Variable** option.

Example:

Name → {{customer.name}}\
Phone Number → {{customer.phoneNo}}\
Pin Code → {{customer.pincode}}

Variables allow the chatbot to store and reuse address data later in the workflow.

#### **Error Attempt**

The **Error Attempt** field defines the number of invalid attempts allowed.

Example:

Error Attempt: 3

If the user enters incorrect or incomplete address information multiple times, the chatbot triggers the configured fallback behavior.

#### **Error Message**

The **Error Message** is displayed when the address entered is invalid or incomplete.

Example:

Oops! That address doesn't seem quite right.\
Please make sure to include your complete address details.

This helps guide users to provide correct information.

#### **Action on Invalid**

This setting determines what happens when the user exceeds the allowed number of invalid attempts.

Available options include:

**End the Flow**

Stops the chatbot conversation.

**Skip the Question**

Allows the workflow to continue without collecting the address.

**Fall Back Flow**

Redirects the user to another chatbot flow.

### **Store Response in Variable**

The **Store Response in Variable** option saves the collected address details.

Example variable:

Address

The walkthrough shows creating a variable named **Address** to store the collected address information.

#### **Creating a New Variable**

If a variable does not already exist:

* Click **Create New Variable**.
* Enter a variable name.

Example:

Address

* Select the variable in the **Store Response** field.
* Click **Create** to finalize the configuration.

### **Example Ask Address Interaction**

Example chatbot conversation:

Bot: Please provide your full delivery address.\
\
User:\
Name: John\
Phone: 9876543210\
House No: 21A\
City: Chennai\
Pin Code: 600001

The chatbot stores the address details in the variable:

Address

and continues the workflow.

### **Best Practices**

Follow these recommendations when using Ask Address.

**Request complete address details**

Ensure users provide all required information.

**Use predefined values when possible**

Auto-fill known user information to simplify the process.

**Provide clear instructions**

Explain what address details the user must enter.

**Store address data correctly**

Save address responses in variables for later automation.

**Validate address inputs**

Use error messages to guide users when incorrect information is entered.

### **Summary**

The **Ask Address** action enables chatbots to collect **structured address information from users**.

With Ask Address, you can:

* Collect detailed delivery or service addresses
* Capture multiple address fields
* Use predefined values to autofill customer data
* Validate address inputs
* Store address details for workflow automation

This feature helps businesses **capture accurate address data and streamline delivery or service processes through chatbot automation**.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.ownchat.app/bot/ask-action/ask-address.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
