Skip to content
Qomni

Agents

Create an agent, give it a voice and put it to work: REST for the calls and a WebSocket to talk to it in real time from your app.

Base URL
https://api.qomni.ai/agents/v1
Key
sk_agents_test_…
curl https://api.qomni.ai/agents/v1/calls \
  -H "Authorization: Bearer sk_agents_test_…"

What's new

BYOC: your own telephony

How your carrier or your SIP trunk brings your existing numbers to Qomni Agents voice agents, without porting anything or switching providers.

BYOC (Bring Your Own Carrier) means your telephony stays yours and Qomni only provides the agent. You got your numbers from your carrier and your customers know them: you do not port them, publish a new one or switch providers. Your carrier or your SIP trunk carries each call to your workspace’s SIP network, and there the agent you chose for that number answers.

Each workspace has its own SIP network: a domain (acme.sip.qomni.ai), an inbound trunk with a username and a password only you know, and one room per call in your workspace’s region. A call that does not come in through your trunk never reaches your agents.

Why the telephony is yours

A voice agent is useful where people already call you. Providers that sell their own numbers force you to port or announce a new one, and to pay for their minutes. Qomni does the opposite: the transport (SIP and RTP) stays with your carrier, at its rates, and Qomni provides the agent, the room where it talks and the call record.

It is also safer this way. Because the trunk has its own credentials per workspace, a forward or a forged header can only choose among your agents, never send the call to another workspace.

Two ways to bring it

They can be combined.

Your telephonySIP trunkforwarding + DiversionYour carrierYour existing lineLiveKit SIP in your cellVoice agent
Way When What you do
SIP trunk You have a carrier or a SIP trunk and want your numbers to come in directly In Telephony you enable inbound calls. Qomni gives you the SIP domain, a username and a password; your carrier points your numbers there
Forwarded line You have an existing number (landline or mobile) and do not want to touch anything else You ask your carrier to forward that line to a trunk number and declare the line in Qomni. We recognize the number your customer dialed (Diversion or History-Info) and that line’s agent answers

A PBX you already have (Asterisk, FreePBX, Issabel, 3CX…) comes in through the first: its outbound trunk points to your Qomni SIP network, as it would with one more carrier.

Which agent answers

The number decides. If your customer dialed your existing line and the carrier forwarded it, we use the number they dialed, not the trunk’s.

Case Who answers
Number with an assigned agent That agent
Unassigned number and a single active voice agent That agent
No possible agent A short message; the call goes unanswered

Calling out

Also through your telephony. An outbound trunk with your carrier’s address and credentials lets the agent call with your numbers: that is what POST /agents/v1/calls uses in live mode.

Limits

  • Qomni does not sell numbers or port them: today every call comes in through your telephony.
  • The agent transfers only to the destinations you configure for it; it does not dial another number even if asked.
  • Only a voice agent can answer a trunk; a chat agent does not answer calls.

See also

Site navigation

New

2 of 7 steps doneNext: the platform in production

Qomni is in private beta

The API and the app are not open yet. See what is done, what is left and how it opens, step by step until the first customer.

Type to search…

↑↓ move↵ openEsc to close