Voice Apps
A Voice App is a configuration object that ties your Teler phone numbers to your application. It tells Teler two things: where to ask for instructions when a call comes in, and where to send lifecycle events.
You attach one or more Teler numbers to a Voice App. When any of those numbers is dialed, Teler hits the Voice App’s Incoming Call URL asking for a Call Flow.
When to use a Voice App
Section titled “When to use a Voice App”| Scenario | Use a Voice App? |
|---|---|
| You bought a Teler number and want it to do something on incoming calls | Yes |
| You want to make outbound calls only | No. Pass flow_url directly when initiating the call |
| You’re routing calls through your own SIP infrastructure (PBX/SBC) | No. Use a SIP Trunk instead |
How it fits
Section titled “How it fits”Properties
Section titled “Properties”| Field | Type | Required | Default | Description |
|---|---|---|---|---|
app_name | string | yes | none | Human-readable identifier shown in the dashboard. |
incoming_call_url | string (HTTPS) | yes | none | Endpoint Teler POST’s to when a call arrives. Must respond within 5 seconds with a Call Flow. Sent on the wire as flow_url. |
call_status_url | string (HTTPS) | no | none | Endpoint that receives call lifecycle webhooks. Sent on the wire as webhook_url. |
channels | integer | no | 1 | Maximum number of simultaneous calls this app can handle (wire field channel_limit). Additional channels can be purchased. |
webhook_api_version | enum | no | 2026-06-01 | Pins the webhook wire format. Set to 2025-08-01 or 2026-06-01. See API versioning. |
Example
Section titled “Example”A Voice App named Support IVR:
| Field | Value |
|---|---|
app_name | Support IVR |
incoming_call_url | https://api.example.com/teler/flow |
call_status_url | https://api.example.com/teler/webhook |
channels | 10 |
Concurrency and channels
Section titled “Concurrency and channels”Teler enforces the channels limit at the Voice App level. If a 11th caller
dials in while 10 calls are already active on a 10-channel app, Teler returns a
busy signal. Plan your channel count for peak: buffer at least 20% headroom
above expected concurrency.
Manage Voice Apps
Section titled “Manage Voice Apps”Voice Apps are managed in the Teler dashboard. The dashboard is the canonical surface today; programmatic Voice App management is on the API roadmap.