Pular para o conteúdo
apiwpp
Termo

O que é aparelho conectado no WhatsApp

Aparelho conectado é um dispositivo extra ligado a uma conta de WhatsApp, como o WhatsApp Web, o aplicativo de desktop ou o servidor de uma API. Ele é pareado pelo celular uma vez e depois envia e recebe mensagens mesmo com o celular desligado.

Atualizado em

Aparelho conectado é o nome que o WhatsApp dá a qualquer dispositivo que usa a mesma conta do celular sem ter o chip: o WhatsApp Web no navegador, o aplicativo de desktop, um tablet e também o servidor de uma API de WhatsApp. A lista fica no celular, em WhatsApp › Aparelhos conectados, e é lá que o dono do número adiciona um aparelho novo ou remove um antigo.

Como um aparelho é conectado

O celular continua sendo o dono da conta. Para ligar um aparelho novo, a pessoa abre Conectar um aparelho e escaneia um QR code de pareamento, ou digita um código de 8 caracteres na opção Conectar com número de telefone. Nesse momento, o WhatsApp entrega ao aparelho as chaves da sessão, e ele passa a enviar e receber as mensagens do número com a criptografia de ponta a ponta de sempre.

É exatamente assim que uma API não oficial de WhatsApp funciona. A apiwpp fala com o WhatsApp pelo protocolo do WhatsApp Web: cada número conectado a ela aparece no celular como mais um aparelho conectado. Não há cadastro na Meta, aprovação de conta nem troca de chip. É também o que a diferencia da API oficial (Cloud API), em que o acesso passa pela plataforma da Meta, com conta Business e aprovação.

Funciona com o celular desligado

Desde que o WhatsApp adotou o modelo de vários aparelhos, cada aparelho conectado tem as próprias chaves e não depende do celular para trocar mensagens. O telefone pode ficar sem bateria, sem internet ou guardado numa gaveta, e o aparelho conectado continua funcionando.

Para uma integração, isso muda muito: não é preciso manter um celular ligado na tomada só para o sistema não cair. O celular continua útil para um atendente responder uma conversa à mão, e essas mensagens podem chegar ao seu sistema pelo evento opcional message.outgoing do webhook. Ainda assim, vale abrir o WhatsApp no celular de tempos em tempos, porque o próprio WhatsApp pode encerrar aparelhos conectados de uma conta cujo celular fica muito tempo sem uso.

Sessão, desconexão e logout

O que mantém um aparelho conectado ligado à conta é a sessão: o conjunto de chaves recebido no pareamento. Enquanto ela existir, o aparelho reconecta sem pedir um QR code novo. Na apiwpp, a sessão fica salva no banco de dados, criptografada em repouso, e por isso sobrevive a reinícios, atualizações e trocas de servidor.

Cada tipo de interrupção trata a sessão de um jeito:

SituaçãoO que acontece com a sessão
Queda de rede ou reinícioContinua guardada; a conexão volta sozinha
Desconectar pela APIContinua guardada; reconecte sem QR code
Logout pela APIÉ apagada; o próximo pareamento pede QR code novo
Aparelho removido no celularO WhatsApp encerra a sessão; é preciso parear de novo

Cada mudança chega ao seu sistema pelo evento connection.status, com o motivo (reason) e o campo willReconnect, que diz se a conexão vai voltar sozinha. Um novo pareamento, depois de um logout ou com outro número, recomeça o aquecimento de número de 14 dias.

Os detalhes de cada caso estão em sessão persistente, e o passo a passo do pareamento em conexão por QR code ou código de pareamento.

Perguntas frequentes

Continuo usando o WhatsApp no celular depois de conectar a API?

Sim. O celular segue funcionando normalmente, e a API é só mais um aparelho da lista. Mensagens digitadas no celular podem chegar ao seu sistema pelo evento message.outgoing, que você ativa por projeto.

O celular precisa ficar ligado?

Não. Depois do pareamento, o aparelho conectado troca mensagens sozinho, mesmo com o celular desligado ou sem internet. Abrir o WhatsApp no celular de vez em quando evita que o próprio WhatsApp encerre os aparelhos conectados por falta de uso.

Como desligo a API do meu número?

Pelo celular, em Aparelhos conectados, removendo o aparelho; ou pela API, com um logout, que apaga a sessão. Se a ideia é só pausar por um tempo, use a desconexão, que mantém a sessão para voltar sem QR code.

Aparelho conectado é o mesmo que API oficial?

Não. A API oficial do WhatsApp (Cloud API) passa pela plataforma da Meta, com conta Business e aprovação. O aparelho conectado usa o protocolo do WhatsApp Web, sem aprovação da Meta. A apiwpp usa esse segundo modelo e não é afiliada ao WhatsApp nem à Meta.

QR code de pareamento é o código que o celular escaneia para ligar o número de WhatsApp a um aparelho conectado, como o WhatsApp Web ou uma API. Ele muda a cada poucos segundos e pode ser trocado por um código de 8 caracteres.

Aquecimento de número (ou de chip) é o período depois de conectar um WhatsApp em que os limites de envio começam baixos e sobem aos poucos, para o número ganhar histórico antes de chegar ao volume normal. Na apiwpp, ele dura 14 dias e é aplicado pela fila.

Webhook é uma chamada HTTP que um serviço faz para um endereço do seu sistema quando um evento acontece, como uma mensagem recebida. Em vez de perguntar de tempos em tempos se há novidades, o seu sistema é avisado na hora.

Conecte seu primeiro número hoje.

7 dias grátis, sem cartão de crédito.