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.

​

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

​

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

​

Next steps