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

Início rápido

Verifique sua chave do Agents e faça um agente ligar para um número em cinco minutos, pelo terminal, Python ou TypeScript.

Ao terminar este guia, você terá verificado sua chave e criado uma chamada com a API do Agents. Tudo roda em modo de teste: nenhum número é discado e nada é cobrado.

Antes de começar

Você precisa de:

  • Uma conta Qomni (teste grátis de 14 dias, sem cartão).
  • Um terminal com curl, ou Python 3.9 ou superior, ou Node.js 18 ou superior.
  1. Crie uma chave de teste

    Cadastre-se em qomni.ai. Em Settings → API keys do seu workspace, crie uma chave de teste: ela começa por sk_agents_test_. Guarde-a em uma variável de ambiente do seu shell:

    export QOMNI_KEY="sk_agents_test_…"

    Os exemplos desta página a leem de QOMNI_KEY. Não a escreva no seu código nem a envie para um repositório.

  2. Instale o necessário

    Com cURL você não precisa de mais nada. Em Python usamos requests; o Node.js já traz fetch, e tsx executa TypeScript sem compilar.

  3. Verifique a chave

    Peça à API o contexto da sua chave. Salve o código em ping.py ou ping.mts, ou cole o comando cURL no seu terminal:

    Execute:

    Um 200 traz seu workspace e livemode: false, porque a chave é de teste. A resposta pode trazer mais campos: ignore os que você não conhece.

    200 OKjson
    {
      "product": "agents",
      "tenant": "acme",
      "cell": "co1",
      "region": "co",
      "livemode": false
    }

    Um 401 significa que a chave falta ou não é válida: o campo code do erro diz qual das duas. Veja Erros.

  4. Crie uma chamada

    Peça que um agente ligue para um número. Em modo de teste, +15005550001 é um número mágico que sempre termina em completed. Salve o código em create_call.py ou create_call.mts e execute como no passo anterior:

    A API responde 201 com a chamada:

    201 Createdjson
    {
      "id": "call_01k8x2m4v7q9r3t5w8y1z0a2b4",
      "to": "+15005550001",
      "status": "completed",
      "livemode": false,
      "cell": "co1",
      "region": "co",
      "created_at": "2026-10-21T15:04:05+00:00"
    }

Você deve ver

A chamada existe, com status completed, e nenhum telefone tocou: assim funciona o modo de teste. Você acabou de fazer as duas chamadas que qualquer integração com o Agents faz: verificar a chave e criar uma chamada. GET /calls as devolve para você, a mais recente primeiro.

Se no passo 3 você viu 401, o campo code diz por quê: api_key_missing se o header falta, api_key_malformed se a chave foi copiada errado, api_key_invalid se foi revogada.

Próximo passo

Troque a chave de teste por uma real (sk_agents_live_…) e o mesmo código faz chamadas de verdade. Antes disso, coloque o agente para conversar com seu app:

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