Use Kapso Sandbox for testing

​

What is the Kapso Sandbox?

• 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

• A 6-character activation code (e.g., “ABC123”)
• The Kapso sandbox WhatsApp number
• A direct link to start the conversation

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

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

​

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

​

Managing test sessions

• See which phone numbers are authorized
• Check which agent/config each session uses
• Delete sessions when done testing

​

Next steps