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
livee revogue as de teste que você já não usa. - A validação é idêntica. Um
422em teste será um422em real.
Veja também
- Chaves de API e autenticação: a chave decide o modo.
- Início rápido: sua primeira chamada, em modo de teste.
- Limites de uso: os mesmos nos dois modos.