Skip to main content

​
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

​
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

​
Route to an agent

  1. Navigate to WhatsApp → Configurations in your project
  2. Find the Sandbox WhatsApp configuration (automatically created)
  3. Go to your agent settings
  4. Select Sandbox WhatsApp as the WhatsApp configuration
  5. Save the agent

​
Route to a flow

  1. Navigate to WhatsApp → Configurations in your project
  2. Find the Sandbox WhatsApp configuration (automatically created)
  3. Go to Flows in your project
  4. Create or edit a flow
  5. Add an Inbound Message Trigger
  6. Select Sandbox WhatsApp as the WhatsApp configuration
  7. Deploy the flow

​
Route to webhooks

  1. Navigate to WhatsApp → Configurations in your project
  2. Find the Sandbox WhatsApp configuration (automatically created)
  3. Click on the Sandbox WhatsApp configuration
  4. Go to Manage Webhooks
  5. Add webhook URLs for the events you want to receive

​
Manage test sessions

Go to WhatsApp → Sandbox to view all active sessions:
  • See which phone numbers are authorized
  • Check which agent/config each session uses
  • Delete sessions when done testing

​
Limitations

The sandbox is for testing message flows, not production features.
FeatureSandboxProduction
Send text messages✅✅
Send interactive messages✅✅
Send templates❌✅
Sync from WhatsApp❌✅
Multiple recipients❌✅

​
Common errors

“Active sandbox session required to send messages” You’re sending to a number that isn’t registered in your sandbox session. The to field must match the phone number you added to your session. “Sync from WhatsApp” button disabled Template sync is not available for sandbox numbers. Connect a production number to sync templates. Can’t activate sandbox session
  • Verify you’re sending the exact 6-character code (case-sensitive)
  • Send from the phone number you registered, not a different device
  • Check the sandbox number is correct (displayed in your session)
  • Try creating a new session if the code expired