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

# 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 na
página **Números**, um proprietário ou administrador da equipe seleciona
**Participar** na linha do beta, revisa os termos e seleciona **Aceitar e
participar**. O Inspector tem a própria linha de beta. 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](/pt-br/integrations/quicklink#conexões-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](/pt-br/console/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.

## Próximos passos

> **[Início rápido do Sandbox](/pt-br/sandbox/quickstart)**
>
> Crie, liste e remova um número de teste.

> **[Pool de números](/pt-br/sandbox/number-pool)**
>
> Gerencie números de teste pela Platform API pública.

> **[Limites do Sandbox](/pt-br/sandbox/tiers)**
>
> Revise os limites atuais do plano de número Free.

> **[Controles do telefone](/pt-br/sandbox/phone-controls)**
>
> Veja os dispositivos vinculados, envie como o telefone e desvincule um dispositivo.

> **[Inspector: propriedade e dispositivos](/pt-br/sandbox/inspector-ownership-and-devices)**
>
> Abra uma sessão de teste em um dispositivo desktop com login.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.