# O que é o Sandbox?

> Crie e gerencie números de teste simulados sem conectar um número real de WhatsApp.

Números de teste exigem acesso da equipe ao beta. Quando o beta é oferecido,
um proprietário ou administrador da equipe abre [Recursos opcionais](https://docs.polymorfa.com/teams/opt-in-features),
seleciona **Números de teste** e **Participar**, revisa os termos e seleciona
**Aceitar e participar**. O Inspector aparece separadamente na mesma lista. Sem acesso a números de
teste, a criação e o uso ficam bloqueados; os números existentes continuam
disponíveis para consulta, parada e exclusão.

O Sandbox da Polymorfa oferece números de teste para projetos de
desenvolvimento. Números de teste têm `testMode` ativado e não se conectam a
destinatários reais do WhatsApp.

Use o Sandbox para verificar o gerenciamento de números, os controles de sessão
por projeto e os fluxos de trabalho do desktop com login antes de registrar um
número de produção. Números de teste novos ficam conectados e disponíveis
imediatamente. Eles continuam simulados e não podem entrar em contato com
destinatários reais do WhatsApp. O dispositivo controlado pela API continua
vinculado depois de reinícios do serviço e do app, até você remover o número de
teste. As APIs públicas de sessão oferecem equivalentes simulados para mensagens
e mídia, alterações e confirmações de mensagens, contatos, grupos, canais,
presença, privacidade, perfis, etiquetas, catálogos comerciais e ações do ciclo
de vida da sessão. As mudanças de estado são compartilhadas entre o dispositivo
controlado pela API e o Inspector, então você pode exercitar o mesmo
comportamento multidispositivo sem entrar em contato com o WhatsApp nem com um
destinatário real.

Mensagens diretas ficam dentro do projeto: o destinatário precisa ser outro
número de teste ativo desse projeto. A atividade de grupos e canais é roteada
entre os números de teste que fazem parte da conversa simulada. Destinatários
diretos desconhecidos, parados, removidos ou de outro projeto retornam
`404 Not Found` sem criar estado para o destinatário.

## Fluxos de trabalho disponíveis

| Fluxo de trabalho | Rota | Credencial |
| --- | --- | --- |
| Criar um QuickLink de teste | `POST /messaging/quicklinks` com `configuration.testing` | Chave de equipe ou de projeto |
| Listar as sessões do projeto | `GET /platform/sessions?projectId={projectId}` | Chave de equipe ou bearer do painel |
| Iniciar ou reiniciar uma sessão de teste | API de sessão de Linked Device | Chave de projeto |
| Parar uma sessão de teste | `POST /platform/sessions/{sessionId}/stop` | Chave de equipe ou bearer do painel |
| Remover uma sessão de teste | `DELETE /platform/sessions/{sessionId}` | Chave de equipe ou bearer do painel |
| Abrir uma sessão de teste | Polymorfa Inspector | Sessão do Inspector com login |

A solicitação de QuickLink identifica o projeto e inclui `configuration.testing`.
Escolha um país, um perfil simulado, o tipo de conta, o comportamento de
resposta e um cenário de falha compatível. Delegue um subconjunto explícito ao
destinatário com `editable`. Um país fixo determina o número de telefone gerado;
os campos de perfil não mudam a identidade reservada. Consulte
[QuickLink](https://docs.polymorfa.com/pt-br/numbers/quicklink#conexoes-simuladas). Liste as sessões do
projeto e selecione as linhas com `testMode: true` em vez de presumir uma
quantidade fixa de números ou um formato de telefone.

## Limites e cobrança

Os números de teste do Sandbox usam o plano de número Free:

- 0 créditos por dia de sessão online.
- 5 mensagens por segundo por número de teste.
- 1 GB de dados incluídos por número de teste.
- 5 chamadas recebidas e 5 chamadas feitas por mês, sem excedente.
- 1.000 chamadas serverless por mês.
- Sem registro de números reais nem campanhas.

Esses são limites do plano de número. Cada projeto pode ter 5 números de teste,
ou 50 com o add-on Simulação, em equipes Free e Pay-As-You-Go. Números de teste
não usam créditos em nenhum dos modos de cobrança. Consulte
[Free e Pay-As-You-Go](https://docs.polymorfa.com/pt-br/billing#free-and-pay-as-you-go).

## Dispositivos do Inspector

No Inspector, escolha **Abrir** ao lado de um número de teste. A sua conta da
Polymorfa passa a ser dona dessa sessão pelo Inspector, e o app se conecta como
um dispositivo vinculado nativo. Fechar o app ou sair da conta mantém o
dispositivo para reconexão. Ser dono pelo Inspector não amplia as suas
permissões de equipe, projeto ou controle de sessão.

## Chave de teste no Inspector

O Inspector mostra a [chave de teste](https://docs.polymorfa.com/testing/test-key) de cada projeto na
linha dele na lista de projetos. A chave funciona apenas com os números de teste
do projeto.

- **Criar e revelar** cria a primeira chave de teste do projeto e a mostra.
  **Revelar** mostra uma chave existente. Qualquer membro com acesso ao projeto
  pode usar essas ações.
- **Copiar** copia a chave revelada. **Ocultar** volta a mascará-la.
- O Inspector oculta a chave após 60 segundos, quando você revela a chave de
  outro projeto, troca de equipe, abre uma sessão ou sai da conta. Uma chave
  oculta mostra apenas os quatro últimos caracteres.
- Um proprietário ou administrador pode selecionar **Gerar nova** e confirmar. A
  chave antiga e os tokens de cliente criados com ela param de funcionar em até
  60 segundos.
- Depois de muitas solicitações, o Inspector mostra quanto tempo esperar. Um
  limite em **Gerar nova** não bloqueia **Revelar**.

O Inspector mostra chaves de teste de projetos em todas as equipes que você
autorizou ao entrar.

## Cenários de configuração

Defina os valores em `configuration.testing.configuration` ao criar o QuickLink
do número de teste.

| Campo | Valores | Resultado |
| --- | --- | --- |
| `profile.name` | De 1 a 128 caracteres | Nome de exibição da conta. |
| `profile.status` | Até 139 caracteres | Texto de recado da conta. |
| `accountType` | `whatsapp_app`, `business_app`, `meta_cloud`, `meta_coexistence` | Tipo de conta configurado: app WhatsApp, app Business, API oficial ou app Business com API oficial. |
| `primaryPlatform` | `android`, `ios` | Plataforma do telefone principal. O padrão é `android`; omita para `meta_cloud`. |
| `replyBehavior` | `off`, `echo` | Com `echo`, uma mensagem de texto de outro número de teste do projeto é respondida ao remetente. |
| `failureScenario` | `none`, `reject-send` | Com `reject-send`, o envio de mensagens, botões ou listas falha para testar o tratamento de erros. |
| `historyFixtureId` | ID de um fixture | Seleciona o histórico de teste enviado. |

```json
{
  "projectId": "00000000-0000-4000-8000-000000000001",
  "configuration": {
    "testing": {
      "country": "BR",
      "configuration": {
        "profile": { "name": "Suporte de demonstração" },
        "accountType": "business_app",
        "replyBehavior": "echo",
        "failureScenario": "none"
      },
      "editable": ["profile.name", "replyBehavior"]
    }
  }
}
```

## Próximos passos

- **[Início rápido do Sandbox](https://docs.polymorfa.com/pt-br/testing/quickstart)**
Crie, liste e remova um número de teste.

- **[Pool de números](https://docs.polymorfa.com/pt-br/testing/test-numbers)**
Gerencie números de teste pela Platform API pública.

- **[Limites do Sandbox](https://docs.polymorfa.com/pt-br/testing/test-numbers)**
Revise os limites atuais do plano de número Free.

- **[Controles do telefone](https://docs.polymorfa.com/pt-br/testing/phone-controls)**
Veja os dispositivos vinculados, envie como o telefone e desvincule um dispositivo.

- **[Inspector: propriedade e dispositivos](https://docs.polymorfa.com/pt-br/testing/inspector/devices)**
Abra uma sessão de teste em um dispositivo desktop com login.

- **[Eventos de teste](https://docs.polymorfa.com/pt-br/testing/test-events)**
Envie eventos de webhook de teste assinados.
