Skip to main content
This guide shows you how to use the Kapso WhatsApp Sandbox to test your agents in a real WhatsApp environment without needing production credentials or affecting live data.
The Kapso Sandbox provides a free, shared WhatsApp number for testing. Perfect for development and quality assurance before going live.

​
What is the Kapso Sandbox?

The sandbox is a testing environment that:
  • Provides a shared WhatsApp number for all Kapso users
  • Keeps test data completely isolated from production
  • Requires no WhatsApp Business account setup
  • Works with real WhatsApp on your phone

​
Step 1: Create a test session

  1. Go to WhatsApp → Sandbox in your project
  2. Click Add Test Number
  3. Enter your WhatsApp phone number (the one you’ll test from)
  4. Click Create

​
Step 2: Activate your session

After creating a session, you’ll see:
  • A 6-character activation code (e.g., “ABC123”)
  • The Kapso sandbox WhatsApp number
  • A direct link to start the conversation
To activate:
  1. Click the Open WhatsApp button
  2. Send your activation code as a message
  3. You’ll receive a confirmation message

​
Step 3: Set up message routing

Configure where sandbox messages should go:
  1. Navigate to WhatsApp → Configurations in your project
  2. Find the Sandbox WhatsApp configuration (automatically created)

​
Option A: Route to an agent

  1. Go to your agent settings
  2. Select Sandbox WhatsApp as the WhatsApp configuration
  3. Save the agent

​
Option B: Route to a flow

  1. Go to Flows in your project
  2. Create or edit a flow
  3. Add an Inbound Message Trigger
  4. Select Sandbox WhatsApp as the WhatsApp configuration
  5. Deploy the flow

​
Option C: Route to webhooks

  1. Click on the Sandbox WhatsApp configuration
  2. Go to Manage Webhooks
  3. Add webhook URLs for the events you want to receive
  4. Test messages will trigger these webhooks
Choose one routing method based on what you’re testing. Messages can only go to one destination at a time.

​
Step 4: Test your configuration

Now you can test based on your routing setup:

​
Testing agents

  • Send messages to the sandbox number
  • Your agent will respond as configured
  • View executions in the agent dashboard

​
Testing flows

  • Send messages matching your flow triggers
  • Follow the flow path you’ve designed
  • Check flow execution logs

​
Testing webhooks

  • Send various message types
  • Verify your endpoint receives the webhook calls
  • Check webhook delivery status in the dashboard
All sandbox activity is marked with a “Sandbox” label in your dashboard for easy identification.

​
Managing test sessions

View all active sessions in the sandbox page:
  • See which phone numbers are authorized
  • Check which agent/config each session uses
  • Delete sessions when done testing
Multiple team members can have active sessions simultaneously. Each person just needs their own activation code.

​
Next steps

Test with real data

Create comprehensive test suites for your agents

Go to production

Connect your production WhatsApp number when ready
⌘I