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, 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 | API Create quick link 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 | API Stop session | Chave de equipe ou bearer do painel |
| Remover uma sessão de teste | API Delete session | 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. 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.
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 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. |
{
"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#
Crie, liste e remova um número de teste.
Pool de númerosGerencie números de teste pela Platform API pública.
Limites do SandboxRevise os limites atuais do plano de número Free.
Controles do telefoneVeja os dispositivos vinculados, envie como o telefone e desvincule um dispositivo.
Inspector: propriedade e dispositivosAbra uma sessão de teste em um dispositivo desktop com login.
Eventos de testeEnvie eventos de webhook de teste assinados.