A Meta implementou uma nova camada de segurança para alguns números do WhatsApp, exigindo a utilização de um PIN/Chave de Acesso (Passkey) durante o processo de vinculação do dispositivo.
Em função dessa alteração, algumas conexões via QR Code podem não ser concluídas com sucesso, mesmo quando o procedimento é realizado corretamente.
Para contornar essa nova validação de segurança, a UAZAPI disponibilizou uma extensão oficial para Google Chrome, que permite migrar uma sessão já autenticada do WhatsApp Web para uma instância da API.
Esse processo elimina a necessidade de realizar o pareamento por QR Code nos casos em que a Meta bloqueia esse método de conexão.
Instale a extensão oficial da UAZAPI.
Acesse o WhatsApp Web e conecte o número normalmente.
Abra a extensão.
Informe os seguintes dados da sua instância:
Server URL
Instance Token
Clique em Migrar sessão.
Aguarde a conclusão da migração.
Atualize o painel da UAZAPI para confirmar que a instância foi conectada com sucesso.
Observação: Durante o processo de migração é normal que o WhatsApp Web seja desconectado. Isso ocorre porque a sessão será transferida para a instância da API.
Este procedimento não é obrigatório para todas as conexões.
Utilize a extensão apenas nos casos em que a Meta impedir a conexão via QR Code, devido à nova validação de segurança (Passkey/PIN).
Se a conexão por QR Code ocorrer normalmente, não é necessário utilizar a extensão.
O Assistente de Integração é uma extensão para Google Chrome que permite migrar uma sessão já autenticada do WhatsApp Web para uma instância da D-API, sem a necessidade de escanear um novo QR Code.
Essa funcionalidade é especialmente útil quando a conexão via QR Code é bloqueada ou quando se deseja transferir uma sessão ativa para a API de forma rápida e segura.
A forma recomendada é instalar a extensão diretamente pela Chrome Web Store, garantindo que você utilize sempre a versão mais recente.
Caso necessário, também é possível:
Baixar o pacote da extensão (.zip).
Extrair os arquivos.
Acessar a página de extensões do Chrome.
Ativar o Modo do Desenvolvedor.
Selecionar Carregar sem compactação.
Escolher a pasta extraída da extensão.
Você pode obter o código de integração de duas formas:
Pelo painel da D-API:
Acesse Conectar dispositivo.
O código será exibido abaixo do QR Code.
Pela API:
Utilize o endpoint:
POST /sessions/:sessionId/migration-otp
Abra uma aba do WhatsApp Web que já esteja conectada à conta que será migrada.
Clique no ícone da extensão.
O Assistente detectará automaticamente o número conectado na aba aberta.
Digite o código de integração de 8 caracteres gerado anteriormente.
Em seguida, clique em Integrar.
Após alguns instantes, a migração será concluída.
Importante: Ao finalizar o processo, o WhatsApp Web será desconectado automaticamente, pois a sessão será transferida para a D-API.