Skip to main content

​
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

1

Create a new flow

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

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?
3

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

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

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

​
Next steps

Key Concepts

Understand the building nodes of WhataBot.

Explore Nodes

See all 18+ node types available.