Pular para o conteúdo principal
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. Cada projeto do Sandbox pode ter números de teste próprios do projeto. Eles são sessões com testMode e não se conectam a destinatários reais do WhatsApp.

Listar números

Uma chave de equipe com sessions:read pode listar as sessões do projeto:
As linhas de números de teste têm testMode: true. Use o identificador de sessão e o telefone retornados em vez de presumir uma quantidade fixa de números ou um formato de número.

Adicionar um número de teste

Use a Platform API pública com uma chave de equipe:
projectId é obrigatório. country aceita qualquer um dos 243 códigos de país ISO alfa-2 compatíveis com o WhatsApp e tem US como padrão. O seletor de país do Console mostra a lista completa e pesquisável, com bandeiras, nomes de países, nomes curtos e códigos de discagem. Se você omitir name, o nome fica vazio e o Console e o Inspector usam o número de telefone gerado como rótulo de fallback. Os metadados de formato de telefone validam a identidade gerada internamente. Uma resposta de criação bem-sucedida significa que o dispositivo controlado pela API está conectado e pronto. Números de teste se comunicam apenas com números de teste ativos do mesmo projeto. Enviar para um destinatário malformado, desconhecido, parado, removido ou de outro projeto retorna a mesma resposta 404 Not Found. O envio rejeitado não cria conversa, contato, mensagem nem estado de destinatário. Mensagens, mídia, grupos, canais, contatos, presença, perfis, catálogos comerciais e outras ações públicas de sessão atualizam uma única conta simulada compartilhada, que fica visível tanto no dispositivo controlado pela API quanto no Inspector. O dispositivo controlado pela API aceita uma mensagem enquanto o Inspector do destinatário está fechado e entrega a mensagem pendente quando ele se reconecta. Remover o destinatário cancela as mensagens pendentes dele. O Inspector conclui a inicialização normal do cliente com a sessão simulada. Recursos opcionais do WhatsApp que não são simulados ficam indisponíveis sem interromper as mensagens nem reconectar o número de teste.

Iniciar, parar ou remover um número de teste

Use uma chave de equipe com sessions:manage:
Parar mantém o registro e as configurações do número de teste. Uma resposta de início bem-sucedida significa que o dispositivo controlado pela API está pronto de novo; uma resposta de parada bem-sucedida pausa o dispositivo controlado pela API sem desvincular um dispositivo do Inspector que seja dono da sessão. Essas operações podem ser repetidas com segurança. A remoção fecha uma sessão aberta do Inspector e limpa o estado simulado do número antes de o registro sumir. Se não for possível fechar o número, a solicitação de remoção falha e mantém o registro disponível para você tentar novamente. A remoção é permanente. Números de teste não têm histórico retido pelo armazenamento hospedado de mensagens e não podem entrar em contato com destinatários reais.

Inspector: propriedade e dispositivos

Abra uma sessão de teste no app para desktop.

Limites do Sandbox

Limites atuais do plano de número Free.