Conectar o WhatsApp escaneando o QR Code

O que é a conexão por QR Code

A conexão por QR Code usa o Zapini Gateway para vincular seu número de WhatsApp à plataforma da mesma forma que o WhatsApp Web. É a maneira mais rápida de começar: você lê um código no celular e a instância passa do status qr_ready para connected.

Esse método é ideal para quem usa o WhatsApp comum ou o WhatsApp Business e não tem credenciais oficiais da Meta.

Conectar pelo painel

1. No menu lateral, abra Instâncias (ou Conexões) e clique em Nova instância.
2. Dê um nome para identificar o número e salve. A instância nasce com o status qr_ready.
3. Clique em Conectar para exibir o QR Code na tela.
4. No celular, abra o WhatsApp e toque em Configurações > Aparelhos conectados > Conectar um aparelho.
5. Aponte a câmera para o QR Code exibido no painel.

Assim que o celular ler o código, o status muda para connected em poucos segundos e a instância já aparece no seletor global de instâncias.

💡 Dica: o QR Code expira por segurança. Se ele desaparecer antes de você escanear, clique em Gerar novo QR Code para atualizar.

Conectar por link público

Se quem vai escanear não tem acesso ao painel (por exemplo, o cliente final ou um colega), use o link público de conexão:

1. Na instância, copie a URL de conexão pública (gerada automaticamente ao criar a instância).
2. Envie o link para a pessoa responsável pelo número.
3. Ela abre o link no navegador — sem login — e lê o QR Code com o celular.

Confirmando a conexão

Para verificar se está tudo certo:

• O status da instância deve aparecer como connected (verde).
• Em Mensagens, abra uma conversa e envie uma mensagem de teste.
• O número conectado passa a aparecer no seletor global de instâncias no topo do painel.

Cada instância mantém seus contatos, conversas e mensagens totalmente isolados. Conectar um novo número não mistura dados com os números já existentes.

💡 Dica: mantenha o celular conectado à internet. Como na conexão do WhatsApp Web, o aparelho precisa estar online para que as mensagens sincronizem.