O WhatsApp pediu passkey ao conectar

Algumas contas, depois de ler o QR code, recebem no celular um pedido diferente: em vez de conectar na hora, o WhatsApp diz para continuar no WhatsApp Web ou para confirmar com passkey (a chave de acesso do celular, a mesma da biometria ou do bloqueio de tela).

Quando isso acontece, o DevZap interrompe a conexão e mostra, na própria tela do QR, a mensagem "O WhatsApp pediu passkey". Ela só aparece para quem passou por esse pedido. Esta página explica o que é e o que fazer.

O que está acontecendo

Desde o fim de junho de 2026, o WhatsApp passou a exigir, para algumas contas, uma etapa extra ao conectar um aparelho novo: depois do QR, o vínculo só termina com uma confirmação por passkey feita dentro do WhatsApp Web oficial.

O DevZap ainda não consegue concluir essa etapa. Por isso, em vez de ficar mostrando QR codes novos sem fim, o painel para a tentativa e avisa. Nada foi apagado da sua conta do WhatsApp, e nenhum aparelho novo ficou conectado.

Por que acontece com o meu número

A escolha é do WhatsApp, não do DevZap, e não depende do seu plano. Não sabemos o critério exato: números diferentes da mesma empresa podem se comportar de forma diferente, e o mesmo número pode deixar de pedir depois de um tempo.

O que NÃO resolve

Já testamos, e estes caminhos não fazem o pedido sumir:

• Apagar a passkey no celular. O WhatsApp continua pedindo a confirmação.
• Conectar pelo código de pareamento (a opção "Conectar com número de telefone" no celular). O pedido de passkey aparece do mesmo jeito.
• Ler o QR de novo várias vezes. Cada tentativa termina no mesmo pedido.

O que fazer hoje

1. Conecte outro número, se tiver. O pedido não aparece para todas as contas.
2. Aguarde e tente de novo mais tarde. Clique em Gerar novo QR Code na mensagem de erro (ou em Conectar na instância). Em alguns números o pedido deixa de aparecer.
3. Fale com o suporte informando o nome da instância e o horário da tentativa. Cada caso fica registrado do nosso lado e nos ajuda a priorizar a solução.

Estamos trabalhando numa solução

Estamos implementando a confirmação por passkey no DevZap. Quando estiver pronta, o painel vai guiar você pelo passo extra, e esta página será atualizada.

Para quem integra pela API

A instância volta para disconnected e o webhook connection.changed chega com reason: "PASSKEY_REQUIRED" (o mesmo motivo vai no status.changed do WebSocket e, por até 30 minutos, no campo disconnectReason de GET /instances/{id}). Veja webhooks.

← Todos os guias