# Quick Start

## Register an Account

[Contact us](https://botdistrikt.com/contact) for a demo bot and we will set up your bot account with your registered email address.

**Step 1: Go to the Register page**

Click [this link](https://flow.botdistrikt.com/register) to register your account

**Step 2: Select a Sign-Up method**

You can sign up using your Google or Facebook account. Alternatively, you can choose to sign up using your work email and password.

{% hint style="info" %}
You may skip the following steps if you signed up with Google or Facebook.
{% endhint %}

**Step 3: Fill in the required information**

Fill up your personal details like first name, last name, email, and password. Avoid using your same password from other websites! Finally, accept the terms and privacy policies.

<figure><img src="/files/UBHDBk8phrfOwTEesUKB" alt="" width="375"><figcaption><p>Sign up to BotDistrikt</p></figcaption></figure>

**Step 4: Submit**

Click on **Register.** If there is no error, you should be prompted to check your email to activate your account. You should have received an email from BotDistrikt. Click on the link inside the email body to verify your registration.

<img src="/files/-LjAiwktClbLDbhQAHqH" alt="Successfully Signed Up" width="375">

**Step 5: Verify your email address**

You should have received a verification email from BotDistrikt to complete the verification. Proceed to verify your email by clicking on the link in the email.

<figure><img src="/files/JZ3UkiAaUveBQQzsgooY" alt="" width="563"><figcaption><p>Verify your Email Address</p></figcaption></figure>

{% hint style="info" %}
If you don't see the email, check your spam or junk folder. Also check that you have entered the correct email address, request to resend the verification email. If you still do not receive the email within 10 minutes, do not hesitate to contact us at <hello@botdistrikt.com>.
{% endhint %}

Click on the link to verify your account, The link will take you to a page saying that your email has been verified. After that, click on **Take Me To Login** and login to BotDistrikt.

## Create your bot

Log in with your email on the BotDistrikt [login page](https://flow.botdistrikt.com/login). In the event that the BotDistrikt team has created a bot for you through your registered email ID, you can view your bot on the Chatbot dashboard upon logging in.

<figure><img src="/files/GSUv8weW66B18aIlQiuY" alt=""><figcaption><p>Sample Bot Dashboard with (Sample) Bot Created by BotDistrikt Team</p></figcaption></figure>

## Try your Chatbot

Click on your chatbot and you will be taken to the **Personality** page. This page allows you to get an overview of your bot's personality, its default greeting and fallback messages, the messaging apps it is already connected to, and your team managing its account.

Click on the chatbot widget on the bottom right of the page, and click **Get Started**.

<figure><img src="/files/AFrAdTUTK8Wnnd14qNxh" alt=""><figcaption></figcaption></figure>

Type something your customer would say to your chatbot. By default, it will not be able to handle to message and reply with your bot's **fallback story**.

When this happens, you will be prompted with a link to Create a rule. Click on the link. A new rule will be populated into the **UNASSIGNED** group, with the message you had entered. Click [here](/features/rules.md) to learn more about Rules and configuring one.

## Adding a new bot

**Step 1 of 5:** Click on <img src="/files/V9QbBPIRdSk1ETKmY42L" alt="" data-size="line">. You will be instantly redirected to the [new](https://flow.botdistrikt.com/new) dashboard. Here, you can view the various templates available including starting from a blank bot.

<figure><img src="/files/QJzq85KcEKzVKnmlO1V9" alt=""><figcaption><p>Chatbot Templates</p></figcaption></figure>

**Step 2 of 5:** Select from **Blank Bot**/**Import Bot**/**Website Bot**/**Food Ordering Bot**.

<figure><img src="/files/IbKAMia04kjLyMlbEfbr" alt=""><figcaption><p>Add New Chatbot --> Select from Blank Bot/Import Bot/Template Bot</p></figcaption></figure>

**Step 3 of 5:** Regardless of which template is chosen for your chatbot, BotDistrikt allows you to customize it. Proceed with adding the relevant details to your bot.

<img src="/files/61bUZuEFCHPOfH1n80LF" alt="" data-size="line"> **Import Bot**

<figure><img src="/files/RUDaWPQe2cDPuHMZtiMe" alt=""><figcaption><p>Import a bot</p></figcaption></figure>

<img src="/files/WXKQ7oIMhXjMVKMzxPkO" alt="" data-size="line"> **Website Bot**

<figure><img src="/files/G9ltnxzkKy6LSdTpX5u5" alt=""><figcaption><p>Generative AI Website Bot Template</p></figcaption></figure>

<img src="/files/kRu293LnJd8tawKHBGhP" alt="" data-size="line"> **Food Ordering Bot**

<figure><img src="/files/8QuaYp6XyCVBGlSBblZa" alt=""><figcaption><p>Food Ordering Bot Template</p></figcaption></figure>

<img src="/files/ssRyd6mwfwrPQm2lDDKP" alt="" data-size="line"> **Blank Bot**

<figure><img src="/files/EzS7VcBxI0gl7OX36riJ" alt=""><figcaption><p>Blank Bot Template</p></figcaption></figure>

In this example, we will use the Bank Bot template. At this step you can add a profile picture as well as your bot's name and description.

<figure><img src="/files/XfKxXhn2EvDJZwFFrNF8" alt=""><figcaption><p>Uploading a Profile Picture and Chatbot Description</p></figcaption></figure>

**Step 4 of 5:** Next, set up your bot's greeting story. What will your bot say for the first time? You can learn more about stories [here](/features/stories.md). In this example, we add a greeting story with two quick reply buttons.

<figure><img src="/files/d0deCAfCawdczWDZZhVa" alt=""><figcaption><p>Setup your greeting story</p></figcaption></figure>

**Step 5 of 5:** The next step is to setup your chatbot's fallback story. Your chatbot responds with this message if it cannot answer a question. Click **Finish** to create your chatbot!

<figure><img src="/files/q0Z8SKZ66aZB9GswZKOB" alt=""><figcaption><p>Setup your fallback story</p></figcaption></figure>

🎉 Your bot is now ready!

You can now view the **BotDistrikt Dashboard** where (from the left-hand side navigation panel) you can update your bot's:

* Personality
* Dashboard
* Forms
* Rules
* Stories
* Responses
* Sources
* Users
* Inbox
* Broadcasts
* Integrations
* Settings

<figure><img src="/files/HzQmIpiYIfIc8LSePx9u" alt=""><figcaption><p>Chatbot Personality Tab</p></figcaption></figure>

## Creating a Linear Flow

A linear flow is a chatbot conversation design principle that allows users to navigate from one story to another story in a fixed way. The user has to view the former story, and only then will they be able to view the latter story. Linear flows require memory.

In this example, we will create a linear flow: **Greeting → Transport options → Bus**

**Step 1 of 4:** In the left sidebar, navigate to **Stories** > **greeting** in the story dashboard (or any story you wish to set this flow up in).

**Step 2 of 4:** In the greeting story, select the button you wish to be linked to another story and click **Create rule to fix.**

<figure><img src="/files/aOx8KxrAb0v61rP0rZrE" alt="" width="375"><figcaption><p>What will the user say next?</p></figcaption></figure>

**Step 3 of 4:** A popup will appear prompting you to create a rule to fix. Click on <img src="/files/jvgr8sYtgANecVcdxGEd" alt="" data-size="line">, this creates a memory key which is used in this rule to help the chatbot identify that specific button click.

<figure><img src="/files/ze1hrDsDgHKnJG5EcROA" alt=""><figcaption><p>Create rule to fix</p></figcaption></figure>

<figure><img src="/files/7MZHAYdCjHkBPqxBvE8x" alt=""><figcaption><p>Memory key used in a rule condition</p></figcaption></figure>

**Step 4 of 4:** After saving, if you have yet to configure the linked story in the bot's answer, you can do so in the Story tab. Once configured, you can test your 2-step linear flow by clicking on the chatbot widget.

To enable a user to go back to the previous story, configure the quick reply button to <img src="/files/Ht6jC0uNZeGOoGgW6QlZ" alt="" data-size="line">.

<figure><img src="/files/bLF8YyNqRqFAWVKZGjHE" alt=""><figcaption><p>Return Quick Reply Button</p></figcaption></figure>

<figure><img src="/files/63TUTrjMn3kn1syWwhyG" alt=""><figcaption><p>The Bus story can be accessed from a linear flow</p></figcaption></figure>

If a user clicks **Get Started** and sends a message 'Bus' or any other keyword condition in the rule, the Bus story will not be triggered.

<figure><img src="/files/p8QtPzFOoyKD0i9jPSfO" alt=""><figcaption><p>The Bus story cannot be accessed from a nonlinear flow</p></figcaption></figure>

## Create a Nonlinear Flow

Nonlinear flows are stories which can be triggered from anywhere in a chatbot conversation, even from free text, as long as a message or NLP condition is met. Nonlinear flows do not require memory.

In this example, we will create a nonlinear flow: **Promotions**

**Step 1 of 4:** In the left sidebar, navigate to **Stories** > **greeting** in the story dashboard (or any story you wish to set this flow up in).

**Step 2 of 4:** In the greeting story, select the button you wish to be linked to another story and click **Create rule to fix.**

<figure><img src="/files/NVXhoyswD2xPgbbMOciD" alt="" width="375"><figcaption><p>What will the user say next?</p></figcaption></figure>

**Step 3 of 4:** A popup will appear prompting you to create a rule to fix. Select the Nonlinear option and **Save**. This condition means that as long as the text contains promotions, it will trigger the linked story.

<figure><img src="/files/QiFFNCkfAd0d0EhyjcWz" alt=""><figcaption><p>Creating a Nonlinear Flow</p></figcaption></figure>

**Step 4 of 4:** After saving, if you have yet to configure the linked story in the bot's answer, you can do so in the Story tab. Once configured, you can test your nonlinear flow by clicking on the chatbot widget.

<figure><img src="/files/Kz53np7zDpES2No0KM3e" alt=""><figcaption><p>Promotions can be accessed from any part of the chatbot conversation</p></figcaption></figure>


---

# 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/introduction/quick-start.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.
