> For the complete documentation index, see [llms.txt](https://docs.helena.app/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.helena.app/duvidas-e-novidades/novidades-de-produto/julho-de-2026/01-07-2026-z-api-mudanca-na-conexao-via-qrcode.md).

# 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

<figure><img src="https://3176979156-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3HTAyLM7hzj1t6Nt4ii2%2Fuploads%2FTp1Ftk2tRzE0zmAuXOrO%2Fimage.png?alt=media&amp;token=9e8942a3-5565-4571-8995-a63597f1fbcc" alt=""><figcaption></figcaption></figure>

<figure><img src="https://3176979156-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3HTAyLM7hzj1t6Nt4ii2%2Fuploads%2Fbud6INIrcCDVP5JfNB1v%2Fimage.png?alt=media&amp;token=327e501f-c26d-4482-868c-3ac009848089" alt=""><figcaption></figcaption></figure>

⚠️ **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>