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

Modo de teste

O que muda quando você usa uma chave de teste do Agents, o que não muda, e como testar cada ramo da sua integração sem discar nenhum número.

A API da Qomni tem dois modos: real (live) e de teste (test). O modo é decidido pela chave que você usa: sk_agents_live_… ou sk_agents_test_…. Não há um ambiente separado, nem outro host, nem uma configuração para ativar. É a mesma API, com a mesma validação e os mesmos erros, sobre dados separados e sem consequências.

Com uma chave de teste:

  • nenhum número é discado e nada é enviado a ninguém;
  • nada é faturado;
  • os dados de teste vivem separados dos reais. Uma chave real nunca os vê, e vice-versa.

Por que funciona assim

Um ambiente de testes separado, com outro host e outro banco de dados, obriga a manter duas configurações e a acreditar que as duas se comportam igual. Quase nunca é verdade. A Qomni usa o mesmo código e o mesmo host para os dois modos, e separa só os dados. Assim, o que você testa é exatamente o que vai rodar em produção. Passar para real é trocar uma variável de ambiente.

O que muda com uma chave de teste

Recurso Com uma chave de teste
Chamadas Nenhum número é discado. Os números mágicos decidem o resultado da chamada.
Sessões em tempo real Funcionam igual ao modo real e terminam com billed_minutes: 0.

Números mágicos

Para testar cada ramo do seu código, em modo de teste uma chamada para estes números tem um resultado fixo:

Número Resultado
+15005550001 completed
+15005550002 busy
+15005550003 no-answer

Qualquer outro número em modo de teste termina completed.

Limites

  • O modo de teste não é uma cópia dos seus dados reais. Começa vazio e só tem o que você cria com chaves de teste.
  • Os limites de uso são os mesmos: 120 requisições por minuto por chave.
  • Uma chave de teste não se converte em real. Quando passar para produção, crie uma chave live e revogue as de teste que você já não usa.
  • A validação é idêntica. Um 422 em teste será um 422 em real.

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