Trusted by 30,000+ developers worldwide Build on WhatsApp
in the sandbox
You don't need your own number to start. Every project comes with a sandbox number, so you can test and build on the real API today.
Live in three steps
Add your phone, send a code, and start sending. No Meta verification and no number to buy.
1. Add your phone
Start a testing session with the WhatsApp number you'll test from.
2. Send the code
Send the code to the sandbox number from that phone. It expires after 15 minutes.
3. Send and receive
Call the API with the sandbox phone number ID. Replies reach your webhooks.
The same API as production
Point your code at the sandbox phone number ID. When your own number is connected, swap the ID and keep the rest.
1curl https://api.kapso.ai/meta/whatsapp/v24.0/$SANDBOX_PHONE_NUMBER_ID/messages \2 -H "X-API-Key: $KAPSO_API_KEY" \3 -H "Content-Type: application/json" \4 -d '{5 "messaging_product": "whatsapp",6 "to": "YOUR_TEST_PHONE_NUMBER",7 "type": "interactive",8 "interactive": {9 "type": "button",10 "body": { "text": "Your table for 2 is booked for 8 pm." },11 "action": {12 "buttons": [13 { "type": "reply", "reply": { "id": "confirm", "title": "Confirm" } },14 { "type": "reply", "reply": { "id": "change_time", "title": "Change time" } }15 ]16 }17 }18 }'
Sandbox vs. production
The sandbox covers text and interactive messages, webhooks, agents, and flows. Connect your own number for templates and to reach customers.
| Feature | Sandbox | Production |
|---|---|---|
| Send text messages | ||
| Send interactive messages Buttons and lists | ||
| Receive messages on your webhooks | ||
| Route to agents and flows | ||
| Send templates | ||
| Sync templates from WhatsApp | ||
| Message any customer | Only your test phones |
Frequently asked
questions
Yes. Every plan includes the sandbox, including Free, and you don't need a credit card to try it.
Only phones with an active sandbox session in your project. Start a testing session for each phone you test from, then send its code from that phone.
15 minutes after you start the session. If it expires, start a new session to get a new code.
No. Templates need your own number. In the sandbox you can send text, buttons, and lists to phones with an active session.