> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kapso.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Use Kapso Sandbox

> Test your WhatsApp agents safely without production credentials

## 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 **WhatsApp** → **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.

| Feature                   | Sandbox | Production |
| ------------------------- | ------- | ---------- |
| 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