For the complete documentation index, see llms.txt. This page is also available as Markdown.

01/07/2026 - Z-API: Mudança na conexão via QRCode

📢 Z-API: Nova opção de conexão com chave de acesso exigida pela Meta

Em alguns dispositivos, a Meta passou a exigir uma verificação de segurança com chave de acesso para autorizar novas conexões ao WhatsApp Web, impedindo a conexão via QR Code pelo método tradicional.

Para contornar esse comportamento, implementamos a solução disponibilizada pela Z-API: conexão via extensão do Chrome.

✨ O que mudou?

Ao realizar a conexão de um canal Z-API (QR Code), agora é exibida uma opção abaixo do QR Code:

"O WhatsApp solicitou verificação do número? Clique aqui para conectar usando a extensão do Chrome, sem precisar ler o QR Code."

Ao clicar, o usuário recebe um código de conexão e deve seguir os passos:

  1. Instalar a extensão Z-API Conector no Chrome

  2. Acessar o WhatsApp Web logado com o número a conectar

  3. Clicar no ícone da extensão e inserir o código gerado

  4. Confirmar na tela da extensão para finalizar a conexão

⚠️ Importante: essa opção é um fluxo alternativo, não substitui o QR Code tradicional. Deve ser utilizada apenas quando o cliente relatar dificuldades para conectar pelo método padrão.

📖 Para mais detalhes técnicos sobre a implementação, consulte a documentação da Z-API: https://developer.z-api.io/partner/extension-token

Atualizado