Pular para o conteúdo principal

Introdução

Conceituação#

Neste tópico você vai conhecer todos os métodos disponiveis para registrar um número em uma instância mobile.

O que são instâncias mobile? As instâncias mobile são basicamente como se fossem o seu celular! Ao invés de ser conectada como um dispositivo secundário - como o caso da instância web - elas são o dispositivo primário. Isso quer dizer que, além de você conectar um número a essa instância, poderá também conectar outros dispositivos - como web e desktop - a partir dela! Incrível né?!

Além disso, existem diversas vantagens em conectar seu número a uma instância mobile. Uma delas seria as configurações de segurança da sua conta do WhatsApp, como por exemplo: configurar um email, configurar código PIN, remover email, remover código PIN, buscar email cadastrado na conta, verificar se possui um código PIN configurado, entre outras.

Agora que você já entendeu e viu as vantagens da instância mobile, bora codar!

Passos para conectar um número#

Comece verificando a disponibilidade do seu número para o registro em um novo dispositivo primário. A partir dessa API você pode consultar se o número está banido, se é possível solicitar o código de confirmação via sms, chamada de voz ou pelo aplicativo do celular. Para mais detalhes, acesse a sessão abaixo:

Se o número não estiver banido e algum dos métodos para envio do código de confirmação estiver disponível (sms, chamada de voz ou aplicativo do celular) basta utilizar o endpoint a seguir para solicitar o envio do mesmo:

Em alguns casos, após a solicitação do código é requerido responder a um captcha para prosseguir com a confirmação do código. Nesse caso, o base64 da imagem do captcha é retornado na API anterior a essa - Solicitar código de confirmação. Utilize a seguinte API para realizar a confirmação desse captcha.

Após verficado captcha, se esse tiver sido o seu caso, podemos seguir para a confirmação do código que foi enviado a você pelo método escolhido.

Se você configurou um código PIN de segurança em sua conta do WhatsApp, após confirmação do código de registro (passo anterior) será solicitado que você confirme seu código PIN.

Caso você tenha esquecido seu código PIN de segurança, você pode solicitar um email para recuperá-lo utilizando a API abaixo:

Ufa! Se você seguiu esse passo a passo, já deve estar conectado a uma instância mobile! Agora, é só dar Asas para sua imaginação!

Dica

Lembrando que as demais API's relacionadas ao WhatsApp - como de envio de mensagens e interações na conta - funcionam da mesma forma como para as instâncias web. Ou seja, os métodos são totalmente compatíveis entre instâncias.