Overview
Every Teler account has two modes:
- Sandbox: for building and testing. Calls use the sandbox numbers assigned to your account at signup and are limited to verified numbers, so you can test end to end before going live.
- Production: for production traffic on your virtual numbers.
Switch modes
Section titled “Switch modes”In the Teler dashboard, switch between sandbox and production mode from the mode dropdown. Everything you see and create in the dashboard (Call logs, Voice apps, SIP trunks, and so on) belongs to the mode that is currently selected.
API keys
Section titled “API keys”Each account has one API key per mode. The key you send in the X-API-Key
header decides which mode the request runs in:
| Mode | API key |
|---|---|
| Sandbox | Test API key |
| Production | Live API key |
See Authentication for where to find the keys and how to store them.
Webhook events on the 2026-06-01 version carry a mode field (sandbox or
live) in the event envelope, so one
endpoint can tell the two apart.
Data isolation
Section titled “Data isolation”Sandbox and live data are kept separate. Only account-level data is common to both modes:
| Common to both modes | Separate in each mode |
|---|---|
| Users | Call logs |
| Settings | Webhook event logs |
| Credits | Voice apps |
| SIP trunks | |
| App secrets | |
| IP ACLs | |
| Virtual numbers |
What’s different in sandbox
Section titled “What’s different in sandbox”| Sandbox | Live | |
|---|---|---|
| API key | Test API key | Live API key |
| Phone numbers | Sandbox reference number and sandbox virtual number, assigned at signup | Obtained virtual numbers (paid) |
| Who you can call / who can call you | Verified numbers only | Any number |
| Inbound calls | Caller enters a 4-digit sandbox PIN for the Voice App or SIP Trunk they want to reach | Routed directly |
Next steps
Section titled “Next steps” Sandbox numbers The two numbers assigned at signup, and how to verify the numbers you test with.
Testing calls Place outbound calls and receive inbound calls in sandbox mode.
Authentication Where to find your test and live API keys, and how to store them.