Four ways in
- Inbound phone
- Outbound phone
- Browser
- Inline
Connection types
Every call-creation endpoint takes aconnectionType, which decides what the
returned websocketUrl is prepared for.
Defaults to
twilio. Any other value returns 400.
WebSocket audio options
Only read whenconnectionType is websocket — telephony transports force
G.711 at 8000 Hz whatever you send.
Call settings
Set these on the agent’sconfig; some can be overridden per call.
Who speaks first
agent — opens with greeting. Right for inbound: the caller expects to be
greeted.user — waits silently. Right when the other side initiates.Interruptions
Whether the caller can talk over the agent’s first message only. Every
later turn is interruptible regardless.Leave it
false when the greeting carries something callers must hear — a
recording notice, for instance.Silence
prompt — check in (“Are you still there?”) and keep waiting.hang_up — say goodbye and end the call.Either way the agent speaks first. It is never a silent disconnect, which
callers read as a dropped line.The spoken line is chosen from the agent’s language — Finnish agents say
“Oletko vielä siellä?”, Swedish “Är du kvar?”, and so on, falling back to
English for unmapped languages.
Length and variability
Hard cap in seconds — 50 minutes by default, 7200 maximum. The call ends when
it is reached.
0 gives consistent, repeatable answers — the right default for anything
transactional. Raise it only when you want more personality and can tolerate
more variation.Recording
After the call
Knowing when a call ended
There is no customer-facing webhook subscription for voice calls. Call lifecycle events (call.started, call.joined, call.ended) flow inbound
from the voice provider to Omnia for billing — they are not forwarded on to you,
and there is no endpoint to subscribe to them.
To detect completion, poll the call record. A call is finished once endTime is
populated:
duration is the billed duration in seconds, and status carries the end
reason. While a call is still running, endTime is null.