Core concepts
Organizations
Section titled “Organizations”Everything belongs to an organization, usually a station or broadcast group. Its plan (Demo, Basic, Premium or Enterprise) sets limits such as how many studios and numbers it can have. An API key belongs to one organization and can only see that organization’s data.
Studios
Section titled “Studios”A studio is one show’s call-screening setup. It has its own call queue, on-air lines,
hold music, voicemail and modes. Each studio has one or more on-air lines (“hybrids”,
numbered 1, 2, …), which are the phone inputs of your broadcast console. Studios also
expose the SIP endpoints your rack gear registers with.
Studio modes shape what happens to incoming calls:
- Busy / DND: send every call straight to voicemail.
- AI screening: an AI screener talks to each caller before they reach the queue.
- Contest mode: answer only the Nth caller (“be caller 9!”).
- Ring timeout: what happens if nobody picks a caller up in time (nothing, hang up, play an announcement, or voicemail).
Phone numbers
Section titled “Phone numbers”A number rings into a studio, or is forwarded elsewhere, or is routed to a SIP trunk. Each number assignment has a role:
- Primary: normal inbound line, subject to the studio’s modes.
- Hotline: a priority line that skips every mode and jumps to the front of the queue.
Scheduled automations change routing and modes on a timetable, for example “weekdays at 5 pm, turn on Busy/DND” or “Saturday 8 am, route this number to the Weekend studio”.
A call moves through these states:
queued → screening → hold ⇄ on-air ↘ browser (studio app only)| State | Meaning |
|---|---|
queued |
Ringing and waiting in the studio’s queue. Hotline callers are queued first. |
screening |
Talking to the AI screener. |
hold |
Answered and on hold, hearing hold music or the station feed. |
on-air |
Connected to an on-air line (hybrid) and live on your console. |
browser |
Talking to an operator in the studio app (not available to API keys). |
With a full-access key you can answer, hold, put a caller on air, reorder the queue, send DTMF, attach a contact, record a contest win, and end calls. You can also place outbound calls to an on-air line. See Live Calls in the reference.
Contacts and wins
Section titled “Contacts and wins”Contacts are your organization’s caller database, matched automatically by phone number. Each contact keeps its call history and win history. Contest mode uses win history to enforce “can’t win again within N days” rules.
SIP trunks
Section titled “SIP trunks”A SIP trunk connects your own PBX. Numbers routed to a trunk ring the PBX, and the PBX can place outbound calls through Caller 9 (US/Canada).