# Forms

Use downloadable forms to collect a standard set of responses from your users. 

Examples: Daily quizzes, user introduction, feedback questionnaires (post-operative feedback questions from patients), lead generation, increased completion rate, etc. 

* [New Form](/features/forms.md#new-form)
* [Form Name](/features/forms.md#form-name)
* [Intro Message](/features/forms.md#intro-message)
* [Questions](/features/forms.md#questions) 
* [Acknowledgment](#acknowledgment)
* [Attributes](/features/forms.md#attributes)
* [Validate](/features/forms.md#validate)
* [Free text/Audio](/features/forms.md#free-text-audio)
* [Audio](/features/forms.md#audio)
* [Validate Audio](/features/forms.md#validate-audio)
* [Completion Message](/features/forms.md#completion-message)
* [Keywords Trigger](/features/forms.md#keywords-trigger)
* [Retrieve and Download Responses](#retrieve-and-download-the-answers.).

To access **Forms**, navigate to the side panel and click **Forms**.

<figure><img src="/files/yQYTvZwA6r2jcjvT5Zw1" alt=""><figcaption><p>Forms Dashboard</p></figcaption></figure>

### New Form

Click on the "New Form" button on the top left hand of the page to start creating a new form.

<figure><img src="/files/WmQB7skiTaAIVgxv75VB" alt=""><figcaption><p>Click New Form</p></figcaption></figure>

You will be navigated to the **New Form** window. The form editor console is on the left and the form preview is on the right.&#x20;

<figure><img src="/files/IRxVruoKj2LclR4fZBzs" alt="" width="563"><figcaption><p>New Form</p></figcaption></figure>

### Form Name

Start with the **Form Name**.&#x20;

![Form Name](/files/-Mg57Ol2aHT3soNn4xzj)

### Intro Message

The **Intro Message** introduces the users to the form's purpose. It may even include a link to your privacy policy, data processing and storage policy, etc.&#x20;

To trigger the **Intro Message** textbox, click **Add Intro Message.**

<figure><img src="/files/FfaZNr6hOuXE5SEXRsFw" alt=""><figcaption><p>Add Intro Message</p></figcaption></figure>

![Intro Message](/files/-Mg57g_wTFarlfPnOoCr)

### Questions

Proceed to add questions to the form.&#x20;

<figure><img src="/files/VXJ9vTQHZmlPFI9DBjCe" alt="" width="375"><figcaption><p>Add Questions</p></figcaption></figure>

1. Add **Question** in text form.
2. Add **Question ID** - A reference word for other questions to skip to this question
3. **Store Answer to** if you choose to store the answer to a stored attribute.

   3.1 Choose **Store answer to** or **Don't store** from the dropdown
4. Choose answer form

   4.1 **text**, **options** (multiple choice)**, image**, **audio**
5. Select [**Validate**](#validate) if the answer is required in the mentioned format. If the user fails to provide the answer in the required format (for example, no text instead of text) then the question is repeated.
6. Select **Skip to ID** to skip to the next question
7. Choose to **Delete** ![](/files/4ymYqcpm22q8vM2E08LY), **Copy** ![](/files/0IlNvxcS0ja1RxMzLcLo), or **Move** the question position ![](/files/kUOFlSgrFGD7TA9iroV4)

### Acknowledgment

Acknowledgments are optional (available in **options** as answer format)

Add an acknowledgment to alert the user to incorrect and correct responses.

<img src="/files/-Mg5Li0P3L82zYEFtgG9" alt="Acknowledgement" width="375">

### Attributes

Attributes save user information and allow reuse in conversations. In BotDistrikt, attributes are the names you assign to collected responses.&#x20;

Every user's answer is stored in an attribute of that name on their user profile. If the attribute is "addition", responses against it will be stored as follows in a user's profile.&#x20;

![Attributes Stored in Users Profile](/files/-Mg5VsuDPGO8zA5d1WS2)

### Validate

**Validate** ensures that the user chooses one of the options provided. If they did not select any of the given options, the chatbot repeats the question until the user selects one of the given options.&#x20;

<img src="/files/-Mg5Qq90_pG6l7BvSc8M" alt="Validation example" width="188">

### Audio

**Audio** allows your users to answer the question with an audio clip or voice note.&#x20;

![Audio option](/files/-Mg5WY1QLKOroULjHWG5)

### Validate Audio

Audio validation enables the bot to recognize audio notes or voice clips. If the user sends anything else, the bot repeats the question until the user sends audio notes or voice clips.

<img src="/files/-Mg5YqwJhGgWMxD_M5mR" alt="Audio Validation Example" width="188">

### End Message

**End Message** indicates quiz completion. It informs the user that the quiz is over.&#x20;

<figure><img src="/files/dNfTRudpa2L2cmGyCcv9" alt="" width="431"><figcaption><p>End Message</p></figcaption></figure>

### Keywords Trigger

Keyword triggers are keywords that trigger the quiz.

<img src="/files/-Mg5GD9k0c4_4zX0Lvak" alt="Keyword Triggers" width="563">

Example of how the quiz looks like to the end-user.&#x20;

<img src="/files/-Mg5PNM7WZdcDFeKT5OT" alt="Live Quiz Example" width="188">

### Retrieve and Download the Answers.

Click **Users** on the left navigation panel.&#x20;

1. Select the users
2. Click Actions
3. Export All to CSV

![Export to CSV](/files/-Mg5_iL1Kj7N-ALQ0MJM)

Click on the Download File button

<img src="/files/-Mg5ckfcn28HoaWTCXfP" alt="Download File" width="375">

Open the CSV file and search for the column that contains the word 'attributes'.&#x20;

![Response File](/files/-Mg5dJH9kQPsKuu6OWgP)


---

# 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.botdistrikt.com/features/forms.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.