Pular para o conteúdo
Qomni

Agents

Crie um agente, dê voz a ele e coloque-o para atender: REST para as ligações e um WebSocket para falar com ele em tempo real a partir do seu app.

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

Novidades

BYOC: sua própria telefonia

Como sua operadora ou seu tronco SIP levam seus números de sempre aos agentes de voz do Qomni Agents, sem portar nada nem trocar de provedor.

BYOC (Bring Your Own Carrier) significa que a telefonia continua sendo sua e a Qomni só coloca o agente. Seus números você contratou da sua operadora e seus clientes os conhecem: você não os porta, não publica um novo e não troca de provedor. Sua operadora ou seu tronco SIP levam cada chamada à rede SIP do seu workspace, e ali atende o agente que você escolheu para esse número.

Cada workspace tem sua própria rede SIP: um domínio (acme.sip.qomni.ai), um tronco de entrada com um usuário e uma senha que só você conhece, e uma sala por chamada na região do seu workspace. Uma chamada que não entra pelo seu tronco nunca chega aos seus agentes.

Por que a telefonia é sua

Um agente de voz serve onde já ligam para você. Os provedores que vendem seus próprios números obrigam você a portar ou a anunciar um novo, e a pagar os minutos deles. A Qomni faz o contrário: o transporte (SIP e RTP) continua sendo da sua operadora, com as tarifas dela, e a Qomni coloca o agente, a sala onde ele fala e o registro da chamada.

Também é mais seguro assim. Como o tronco tem credenciais próprias por workspace, um desvio ou um header inventado só podem escolher entre seus agentes, nunca mandar a chamada para outro workspace.

Duas maneiras de trazê-la

Elas podem ser combinadas.

Sua telefoniatronco SIPdesvio + DiversionSua operadoraSua linha de sempreLiveKit SIP da sua célulaAgente de voz
Maneira Quando O que você faz
Tronco SIP Você tem uma operadora ou um tronco SIP e quer que seus números entrem direto Em Telephony você ativa as chamadas de entrada. A Qomni te dá o domínio SIP, um usuário e uma senha; sua operadora aponta seus números para lá
Linha desviada Você tem um número de sempre (fixo ou celular) e não quer mexer em mais nada Você pede à sua operadora um desvio dessa linha para um número do tronco e declara a linha na Qomni. Reconhecemos o número que seu cliente discou (Diversion ou History-Info) e o agente dessa linha atende

Um PBX que você já tem (Asterisk, FreePBX, Issabel, 3CX…) entra pela primeira: seu tronco de saída aponta para a sua rede SIP da Qomni, como faria com mais uma operadora.

Qual agente atende

O número decide. Se seu cliente discou sua linha de sempre e a operadora a desviou, usamos o número que ele discou, não o do tronco.

Caso Quem atende
Número com um agente atribuído Esse agente
Número sem atribuição e um só agente de voz ativo Esse agente
Nenhum agente possível Uma mensagem curta; a chamada fica sem atendimento

Ligar para fora

Também pela sua telefonia. Um tronco de saída com o endereço e as credenciais da sua operadora deixa o agente ligar com seus números: é o que POST /agents/v1/calls usa em modo real.

Limites

  • A Qomni não vende números nem os porta: hoje toda chamada entra pela sua telefonia.
  • O agente transfere só para os destinos que você configurar; não disca outro número mesmo que peçam.
  • Só um agente de voz pode atender um tronco; um agente de chat não atende chamadas.

Veja também

Navegação do site

Novo

2 de 7 passos feitosA seguir: a plataforma em produção

A Qomni está em beta privada

A API e o app ainda não estão abertos. Veja o que está feito, o que falta e como abre, passo a passo até o primeiro cliente.

Digite para buscar…

↑↓ mover↵ abrirEsc para fechar