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
- Go to WhatsApp → Sandbox in your project
- Click Add Test Number
- Enter your WhatsApp phone number (the one you’ll test from)
- 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
- Click the Open WhatsApp button
- Send your activation code as a message
- You’ll receive a confirmation message
Step 3: Set up message routing
Configure where sandbox messages should go:- Navigate to WhatsApp → Configurations in your project
- Find the Sandbox WhatsApp configuration (automatically created)
Option A: Route to an agent
- Go to your agent settings
- Select Sandbox WhatsApp as the WhatsApp configuration
- Save the agent
Option B: Route to a flow
- Go to Flows in your project
- Create or edit a flow
- Add an Inbound Message Trigger
- Select Sandbox WhatsApp as the WhatsApp configuration
- Deploy the flow
Option C: Route to webhooks
- Click on the Sandbox WhatsApp configuration
- Go to Manage Webhooks
- Add webhook URLs for the events you want to receive
- 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
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.