Pular para o conteúdo principal
Todo número de teste tem um telefone simulado que funciona como o dispositivo principal dele. A API da Polymorfa e o Inspector se conectam a ele como dispositivos vinculados, da mesma forma que se conectam a um telefone real. Use os controles do telefone para conferir quais dispositivos estão vinculados, enviar uma mensagem como o telefone ou desvincular um dispositivo, como uma pessoa faria em Aparelhos conectados no próprio telefone. Os controles do telefone funcionam apenas para números de teste (testMode: true). Uma solicitação para qualquer outro número retorna 400 Bad Request.

Antes de começar

  • A sua equipe tem acesso a números de teste. Consulte O que é o Sandbox?.
  • Você tem uma chave de projeto, ou uma chave de equipe, com o escopo sandbox:read para ler o telefone e sandbox:write para enviar ou desvincular. Tokens de cliente não podem usar os controles do telefone.
  • Enviar e desvincular exigem que o número de teste esteja em execução. Inicie-o primeiro se o telefone estiver offline.

No Console

Abra a página Números do projeto. Os números de teste aparecem em Slots de teste. Escolha Controles do telefone ao lado de um número de teste para ver os dispositivos vinculados dele, desvincular um deles ou enviar uma mensagem do telefone para outro número de teste do projeto.

Ler o telefone

online é true enquanto o telefone simulado está em execução. devices lista os dispositivos vinculados pelo ID do dispositivo.

Enviar uma mensagem pelo telefone

O telefone envia um texto para outro número de teste em execução no mesmo projeto. A mensagem passa pela rede simulada do WhatsApp, então os dispositivos vinculados do remetente recebem a cópia enviada e o destinatário recebe uma mensagem recebida comum.
A API retorna 202 Accepted com o ID da mensagem no WhatsApp quando o telefone informa um:
As mensagens do telefone e os eventos de teste compartilham um limite de 30 solicitações por minuto por projeto. Acima dele, a API retorna 429 Too Many Requests com um cabeçalho Retry-After.

Desvincular um dispositivo

Desvincular desconecta o dispositivo, como aconteceria em um telefone real. O dispositivo 0 é o próprio telefone e não pode ser desvinculado.
Um ID de dispositivo que não está vinculado retorna 404 Not Found.

Erros

Consulte a referência da API para Get a Test number’s phone, Send a message from a Test number’s phone e Unlink a companion.