Qomni é Agents: agentes de IA que atendem o telefone, ligam para seus clientes e conversam em tempo real a partir do seu app. Tem um app web para administrá-los e uma API para colocá-los no seu código. Toda a API segue as mesmas regras: as mesmas chaves, os mesmos erros e o mesmo modo de teste. Se você aprende um endpoint, sabe usar todos.
O que a API faz
| Recurso | O que você faz com ele | Onde |
|---|---|---|
| Chamadas | Um agente liga para um número e informa como terminou | POST /calls, GET /calls |
| Sessões em tempo real | Seu app abre uma conversa de voz ou texto com um agente, sem expor sua chave | POST /realtime/sessions e um WebSocket |
| Contexto da chave | Verifique uma chave e veja em que célula seu workspace vive | GET /ping |
A API vive em um único host, api.qomni.ai: o caminho começa pelo produto
e depois a versão, https://api.qomni.ai/agents/v1. Fala JSON e é
versionada no caminho. Dentro de uma versão só se adicionam campos, nunca se
removem: seu cliente deve ignorar os campos que não conhece.
O que vale em todos os endpoints
- Uma chave por modo.
sk_agents_test_…para testar,sk_agents_live_…para produção. Veja Chaves de API e autenticação. - Um único host. Seu código não escolhe região: a chave carrega a célula e o edge roteia. Veja O edge e as células.
- O mesmo formato de erro.
codepara o seu código,messagepara pessoas,request_idpara o suporte. Veja Erros. - Modo de teste sem consequências. A mesma API, sem discar nem faturar nada. Veja Modo de teste.
Por onde começar
Início rápido
Verifique uma chave e faça um agente ligar para um número, em cinco minutos.
Fale com um agente em tempo real
Crie uma sessão, abra o socket e converse a partir do seu app.
Conceitos
As regras que valem para toda a API.
Referência da API
Cada endpoint, campo e erro, gerado a partir do contrato.