Pular para o conteúdo
Atalho: /, ⌘K ou Ctrl+K

O que é o Sandbox?

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

Ver em Markdown

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 trabalhoRotaCredencial
Criar um QuickLink de testeAPI Create quick link com configuration.testingChave de equipe ou de projeto
Listar as sessões do projetoGET /platform/sessions?projectId={projectId}Chave de equipe ou bearer do painel
Iniciar ou reiniciar uma sessão de testeAPI de sessão de Linked DeviceChave de projeto
Parar uma sessão de testeAPI Stop sessionChave de equipe ou bearer do painel
Remover uma sessão de testeAPI Delete sessionChave de equipe ou bearer do painel
Abrir uma sessão de testePolymorfa InspectorSessã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.

CampoValoresResultado
profile.nameDe 1 a 128 caracteresNome de exibição da conta.
profile.statusAté 139 caracteresTexto de recado da conta.
accountTypewhatsapp_app, business_app, meta_cloud, meta_coexistenceTipo de conta configurado: app WhatsApp, app Business, API oficial ou app Business com API oficial.
primaryPlatformandroid, iosPlataforma do telefone principal. O padrão é android; omita para meta_cloud.
replyBehavioroff, echoCom echo, uma mensagem de texto de outro número de teste do projeto é respondida ao remetente.
failureScenarionone, reject-sendCom reject-send, o envio de mensagens, botões ou listas falha para testar o tratamento de erros.
historyFixtureIdID de um fixtureSeleciona 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#