WhatsApp sandbox

The sandbox lets you try WhatsApp end to end without a number, a WABA or a Meta review. Pozy runs one shared WhatsApp number for testing. You prove you own a test phone by replying to it once, and for the next 7 days that phone is a normal conversation in your inbox: you can send it a template, chat with it freely and receive every webhook.

It costs nothing. When you are ready for real traffic, get a number of your own.

#Sandbox limits

Because the number is shared, a phone can only be messaged after its owner has replied to it from WhatsApp. That stops anyone from using the sandbox to reach strangers.

#Try it

{
  "numbers": [],
  "connected": [],
  "sandbox": {
    "phoneNumber": "+14155550100",
    "accountId": "6716e3b8a4c7f92d5e1b6c08",
    "template": { "name": "sandbox_start", "language": "en" },
    "isSandbox": true
  }
}

curl -X POST https://api.pozy.ai/v1/whatsapp/sandbox/sessions \
  -H "Authorization: Bearer $POZY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "phone": "+351912345678" }'

const res = await fetch("https://api.pozy.ai/v1/whatsapp/sandbox/sessions", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.POZY_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ phone: "+351912345678" }),
});
const data = await res.json();
if (!res.ok) throw new Error(data.error);

console.log(data.session.status, data.sandboxNumber); // "pending"

import os
import requests

H = {"Authorization": f"Bearer {os.environ['POZY_API_KEY']}"}
resp = requests.post(
    "https://api.pozy.ai/v1/whatsapp/sandbox/sessions",
    headers=H,
    json={"phone": "+351912345678"},
    timeout=30,
)
print(resp.json()["session"]["status"])

curl -X POST https://api.pozy.ai/v1/inbox/conversations \
  -H "Authorization: Bearer $POZY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "accountId": "6716e3b8a4c7f92d5e1b6c08",
    "participantId": "351912345678",
    "templateName": "sandbox_start",
    "templateLanguage": "en",
    "templateParams": []
  }'

#Switch to another test phone

You can test one phone at a time. Revoke the current session with DELETE /v1/whatsapp/sandbox/sessions/{sessionId}, then activate the new phone. Messages already exchanged stay in the inbox; revoking only blocks new sends.

#What the sandbox cannot do

• Send to more than one phone at a time, or to anyone who has not replied.
• Send any template other than sandbox_start, or use templates from your own WhatsApp Manager.
• Carry production traffic. It exists to test your integration, not to message customers.

#Common errors

#Endpoints

#Webhook events