> For the complete documentation index, see [llms.txt](https://docs.whatstool.business/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.whatstool.business/bots/ask-questions/ask-number.md).

# Ask Number

### Understanding "Ask Number" <a href="#understanding-ask-number" id="understanding-ask-number"></a>

"Ask Number" is specifically designed to collect numeric input. Asking users for numeric input is a common and valuable tool of WhatsTool Business Bots. This user input can be stored in a designated variable, allowing you to use that data in your BotFlow.

You can ask the customer a question as a **Text** or as a **Voice**.

### **Ask as Text Essentials:** <a href="#ask-as-text-essentials" id="ask-as-text-essentials"></a>

#### **Question Text** <a href="#question-text" id="question-text"></a>

This is the question you want to ask users. Make it clear and short so users know what you're asking.

The **Question text** can be made **Bold**, *Italic*, or ~~strikethrough~~ using the options provided. The text will add the asterisk(\*) for **Bold**, Underscore(\_) for **Italic text**, and Tilde(\~) for **Strikethrough** around the text.

### **Implementation Example:** <a href="#implementation-example" id="implementation-example"></a>

Imagine you are asking your customers to rate your services out of 10. The Ask Number question type with validation settings will make sure users give helpful responses within a specific character limit.

For the **Question Text** you can enter: *On the range of 1 - 10, how would you rate our service? (1 being the worst).*

You have the option to **store the user response** in the variable. You can create a variable - `user_feedback` for example to store the user response.

Now for the **validation settings**, you could provide the **attempt** limit as 1, Validation Error Message is optional. Provide the **Action on Invalid Response**, and turn on the Additional Validation Settings.

In the additional validation settings, provide the **Minimum character, Maximum character, Regex.** The feedback we are looking is on a scale of 1-10, so the minimum character would be 1 and the maximum character would be 2. For regex, we could use - **^\[1-9]\d?$** to make sure that the user enters a rating must between 1 and 9.

#### Publish & Test the Card <a href="#publish-and-test-the-card" id="publish-and-test-the-card"></a>

To publish the flow, connect the card with the starting button and then click on Publish Button. To test the flow, click on Test Bot button to test on a WhatsApp Web Application or on your device.

#### In WhatsApp: <a href="#in-whatsapp" id="in-whatsapp"></a>

This is how "Ask Number" card would be on the WhatsApp Platform.

The above sample flow is for you to understand how "**Ask Number**" Card works and it's usage. It is not a representation of what can be achieved with WhatsTool Business.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://docs.whatstool.business/bots/ask-questions/ask-number.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.
