---
title: "Modo de teste"
description: "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."
version: "pt-br"
---

> Documentation Index
> Fetch the complete documentation index at: https://docs.qomni.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Modo de teste

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](#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 {#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

- [Chaves de API e autenticação](/pt-br/concepts/authentication/): a chave decide o modo.
- [Início rápido](/pt-br/get-started/quickstart/): sua primeira chamada, em modo de teste.
- [Limites de uso](/pt-br/concepts/rate-limits/): os mesmos nos dois modos.

Source: https://docs.qomni.ai/pt-br/concepts/test-mode/index.mdx
