Quick Start

Step 1: Create an account

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

Create a new flow

Go to your workspace and click New Flow. Give it a name like “Welcome Bot”.

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?

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.

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.”

End the flow

Add a Transfer node to hand the conversation to a human agent, or a Finish node to end it cleanly.

Step 4: Create an API key

To connect your WhatsApp integration with whatabot:

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

Step 5: Start a session

Use the API to create a conversation session and process messages:

# 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:

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"}}'

# 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.

Get Started

Editor

Nodes

Workspace

Embed

Step 1: Create an account

Step 2: Create a workspace

Step 3: Build your first flow

Step 4: Create an API key

Step 5: Start a session

Next steps

Key Concepts

Explore Nodes

​Step 1: Create an account

​Step 2: Create a workspace

​Step 3: Build your first flow

​Step 4: Create an API key

​Step 5: Start a session

​Next steps

Key Concepts

Explore Nodes

Step 1: Create an account

Step 2: Create a workspace

Step 3: Build your first flow

Step 4: Create an API key

Step 5: Start a session

Next steps