> ## Documentation Index
> Fetch the complete documentation index at: https://docs.whatabot.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Quick Start

> Create and deploy your first whatabot flow in minutes.

## Step 1: Create an account

Sign up at the whatabot dashboard. After registration, your account is automatically created with a **FREE plan**.

## Step 2: Create a workspace

Workspaces organize your flows. Navigate to the **Workspaces** section and create one. Each workspace can have its own:

* Flows
* API keys
* OAuth clients
* AI agents
* Sectors

## Step 3: Build your first flow

<Steps>
  <Step title="Create a new flow">
    Go to your workspace and click **New Flow**. Give it a name like "Welcome Bot".
  </Step>

  <Step title="Add a message node">
    Your flow starts with a **Start** node. Drag a connection from it and add a **Message** node. Type your welcome message:

    ```
    Hello! Welcome to our service. How can I help you today?
    ```
  </Step>

  <Step title="Add buttons for options">
    Connect a **Button** node to your message node. In it, add two options:

    * "Support"
    * "Sales"

    Each option creates a separate output handle that you can connect to different paths.
  </Step>

  <Step title="Add responses for each path">
    Connect a **Message** node to each button output:

    * Support path: "A support agent will be with you shortly."
    * Sales path: "Let me connect you with our sales team."
  </Step>

  <Step title="End the flow">
    Add a **Transfer** node to hand the conversation to a human agent, or a **Finish** node to end it cleanly.
  </Step>
</Steps>

## Step 4: Create an API key

To connect your WhatsApp integration with whatabot:

1. Go to **API Keys** in your workspace
2. Click **Create API Key**
3. Set a **name** and the **callback URL** (where whatabot will send responses)
4. Save the generated key (starts with `wh_`)

## Step 5: Start a session

Use the [API](/en/api-reference/sessions/create-session) to create a conversation session and process messages:

```bash theme={null}
# Create a session
curl -X POST https://api.whatabot.app/api/v1/sessions/flows/{flowId}/create \
  -H "X-Api-Key: wh_your_api_key"
```

Optionally, you can pass initial variables in the request body:

```bash theme={null}
curl -X POST https://api.whatabot.app/api/v1/sessions/flows/{flowId}/create \
  -H "X-Api-Key: wh_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{"variables": {"userName": "Claudio"}}'
```

```bash theme={null}
# Send a message to the session
curl -X POST https://api.whatabot.app/api/v1/sessions/{sessionId}/message \
  -H "X-Api-Key: wh_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{"type": "text", "text": {"body": "Hello"}}'
```

The flow engine processes the message and calls your **callback URL** with the bot's response.

## Next steps

<CardGroup cols={2}>
  <Card title="Key Concepts" icon="lightbulb" href="/en/get-started/concepts">
    Understand the building nodes of whatabot.
  </Card>

  <Card title="Explore Nodes" icon="shapes" href="/en/nodes/overview">
    See all 18+ node types available.
  </Card>
</CardGroup>