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

Novidades

O que mudou na API e nesta documentação, por data: o que é novo, o que mudou e o que foi corrigido em cada versão.

Assinar por RSS
  1. Beta: o site, a lista de espera e esta documentação estão publicados

    Plataforma

    O Qomni Agents entra em beta privada. A partir de hoje qomni.ai e esta documentação são públicos, e você pode entrar na lista de espera. A API e o app ainda não estão abertos.

    Novo

    • qomni.ai com a lista de espera do Agents: você deixa seu e-mail e escrevemos uma vez, quando abrir.
    • Esta documentação em docs.qomni.ai, em espanhol, inglês e português.
    • Estado da beta: o que está feito, o que falta e como abre, passo a passo até o primeiro cliente.

    Alterado

    • O Agents aparece como “Em breve” em todo o portal e cada guia avisa que a API ainda não responde. Os exemplos mostram como vai funcionar.
  2. A API em um só host

    Plataforma

    A API da Qomni agora vive em api.qomni.ai, com o produto e a versão no caminho: https://api.qomni.ai/agents/v1. O host anterior (agents-api.qomni.ai) não atende mais: responde 404 api_host_moved com a nova URL base, sem redirecionar.

    Alterado

    • URL base da API: https://api.qomni.ai/agents/v1, antes https://agents-api.qomni.ai/v1. Troque a URL base do seu cliente; as rotas, as chaves e as respostas não mudam. Veja Boas-vindas.
    • Tempo real: crie a sessão com POST https://api.qomni.ai/agents/v1/realtime/sessions; seu url é wss://api.qomni.ai/agents/v1/realtime?session=…. Veja Fale com um agente em tempo real.
    • SDK de TypeScript: baseUrl agora é o host (por padrão https://api.qomni.ai) e cada produto adiciona seu /{product}/v1. Veja Use o SDK de TypeScript.
    • Erros novos: 404 api_host_moved no host antigo e 404 unknown_api quando o caminho não começa por uma API. Veja Erros.
  3. Tutoriais, e novidades por produto com RSS

    Plataforma

    Uma seção de tutoriais com soluções de ponta a ponta, e esta página com filtro por produto, página por entrada e RSS.

    Novo

    • Tutoriais: guias de ponta a ponta com o tempo que levam, filtráveis por produto, e “Comece por aqui” na página inicial.
    • Filtro por produto acima da lista (?product=agents o compartilha) e RSS das novidades em cada idioma.
    • Cada entrada tem sua URL (/es/changelog/2026-10-23-blog-subscriptions/), com a anterior e a seguinte no rodapé; a página inicial e o menu de produtos apontam para lá.

    Alterado

    • A linha do tempo leva a data em uma coluna à esquerda, o título como link e o produto como etiqueta com sua cor; as entradas vão da mais recente à mais antiga.
    • A página inicial agrupa os produtos por categoria e o prompt do hero é um botão com as marcas dos agentes de IA. Uma faixa “Pronta para o seu agente de IA” reúne llms.txt, llms-full.txt e o Markdown de cada página.
  4. Assinatura do blog por e-mail

    Plataforma

    O blog avisa por e-mail sobre cada artigo novo: deixe seu endereço no rodapé de qualquer artigo ou da lista, confirme pelo e-mail e pronto.

    Novo

    • Formulário de assinatura no blog e no fim de cada artigo, com confirmação por e-mail (double opt-in) e cancelamento a partir de qualquer mensagem.
    • A API por trás, api.qomni.ai/newsletter/v1 (POST /subscriptions), nunca diz se um endereço já está inscrito e aceita cinco cadastros por hora a partir de um mesmo endereço IP.
    • O blog em três idiomas também por RSS: /es/blog/rss.xml, /blog/rss.xml e /pt-br/blog/rss.xml.
  5. BYOC, conecte sua própria telefonia

    Agents

    Sua operadora e sua linha de sempre chegam aos seus agentes de voz

    Traga sua operadora ou seu tronco SIP e seus números de sempre chegam aos seus agentes de voz, sem portar nada e sem trocar de provedor.

    Novo

    • BYOC: sua própria telefonia: as duas maneiras de trazê-la (tronco SIP e linha desviada), qual agente atende cada número e como ligar para fora pela sua operadora.
    • Um anúncio no portal apresenta o BYOC com seu link; fecha uma vez e não volta.
  6. SDK de TypeScript

    Agents

    @qomni/sdk chama a API do Agents com um método por operação, os tipos do contrato e erros com código; a referência mostra suas chamadas.

    Novo

    • Use o SDK de TypeScript: new Qomni({ apiKey }) e qomni.agents.createCall(…), com idempotencyKey como opção e QomniError (status, code, message, requestId, fields).
    • O exemplo em TypeScript de cada operação da referência do Agents usa o SDK; cURL e Python continuam como estavam.
    • O SDK é gerado do contrato com bin/contracts generate; ainda não está no npm e se instala a partir do repositório.
    • Anúncios no portal: um card apresenta a última função nova, com link e, quando há, um vídeo; fecha uma vez e não volta.
  7. Exemplos completos, diagramas e blog

    Plataforma

    O portal muda de cara: os exemplos dos guias são programas inteiros com sua saída, os processos são explicados com diagramas, há um blog de engenharia e este registro detalha cada versão.

    Novo

    • Blog: notas de engenharia sobre como a plataforma é construída, começando por as células por país e a anatomia de uma chave de API.
    • Diagramas de processo em O edge e as células, Idempotência e novas tentativas e Fale com um agente. Abrem em tamanho completo com um clique.
    • Menu de produtos com pré-visualização: ao passar o ponteiro sobre um produto você vê seu host, sua primeira chamada e seus guias; à direita, os últimos anúncios com imagem.
    • Menu “Nesta página” abaixo do título em telas pequenas, com a seção que você está lendo marcada.
    • O menu lateral pode ser ocultado pelo seu botão; a escolha é lembrada.

    Alterado

    • Tema neutro, claro e escuro: brancos e cinzas, com a cor da marca só no logo e no que está selecionado (aba, linha do menu, indicador).
    • Os exemplos de código mostram as linguagens como abas no cabeçalho do bloco, com o ícone de cada uma, um só botão de copiar e números de linha; escolher Python em um bloco o escolhe em todos.
    • Os guias seguem o guia de estilo da Cloudflare: cada tipo de página (visão geral, início rápido, conceito, tarefa, referência) tem a mesma forma, com “Antes de começar”, “Você deve ver” e “Próximo passo” nas tarefas.
    • Referência da API: cada operação tem um título curto (“Create call”) e sua explicação à parte, e os grupos de endpoints têm nome. O seletor de linguagem do exemplo é um menu com o ícone de cada linguagem. O menu lateral começa com Visão geral e Referência do produto, como o dos seus guias.
    • Este registro: cada entrada leva sua data em uma coluna, o produto como etiqueta e as listas do que é novo, do que mudou e do que foi corrigido.
    • Tabelas mais compactas e paginação em cards com o título da página anterior e da seguinte.

    Corrigido

    • A bandeira da Colômbia no menu de idioma estava mal desenhada.
    • A largura do menu lateral mudava de uma página para outra.
    • Um clique em uma imagem dos guias não abria o visualizador.
  8. Documentação em inglês e português

    Plataforma

    Os guias em espanhol, inglês e português

    Os guias agora também estão em inglês e em português. Troque de idioma pelo menu do cabeçalho: ele leva você à mesma página.

    Novo

    • Inglês na raiz do site (docs.qomni.ai/concepts/errors/) e português sob /pt-br/, traduzidos dos guias em espanhol e revisados.
    • Menu de idioma no cabeçalho, com a bandeira de cada um.
    • Cada página declara suas versões nos outros idiomas (hreflang), para que um buscador mostre a do leitor.

    Alterado

    • O espanhol passa para /es/; cada URL anterior redireciona para sua nova página.
    • A referência da API continua em inglês e é a mesma para os três idiomas; seu menu e seus links ficam no idioma da página.
  9. Nova página inicial e diretório de produtos

    Plataforma

    A página inicial mostra o produto com sua primeira chamada, as últimas novidades e o que é comum a toda a API.

    Novo

    • Diretório com os produtos por categoria, com filtro por texto.
    • Cada página pode ser aberta no Claude ou no ChatGPT, copiada como Markdown ou vista em Markdown pelo seu menu de ações.

    Alterado

    • O logo da Qomni, uma tipografia própria para os títulos (substituída no dia seguinte pela do sistema) e transições entre páginas: a aba e a linha ativas deslizam para a seguinte.
    • Menu de produtos ao lado do logo, com o ícone e o resultado do produto.
  10. Novo portal

    Plataforma

    A documentação se mudou para um portal próprio, gerado a partir de contracts/.

    Novo

    • A seção do Agents com sua referência REST.
    • A referência do WebSocket do Agents, gerada a partir do seu AsyncAPI.
    • Os guias em espanhol, com o mesmo menu e a mesma busca que a referência.

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