Quando um cliente já usa o WhatsApp Web no navegador, pedir para escanear um novo QR code cria fricção — o cliente precisa do celular em mãos, e qualquer erro desconecta o aparelho. A extensão GoZAP para Chrome resolve isso capturando a sessão existente e importando para a nuvem em segundos.
O processo funciona porque o WhatsApp Web armazena as credenciais da sessão no localStorage do navegador. A extensão lê esse dado com permissão do usuário e o envia criptografado para o servidor GoZAP, que reconstrói a sessão sem necessidade de reautenticação.
"Migrar sessão com a extensão demora menos de 30 segundos — sem pedir o celular, sem fricção para o cliente."
Passo a passo da migração
01
Instalando a extensão GoZAP no Chrome
Instale a extensão GoZAP Session Migrator na Chrome Web Store. Ela solicita permissão apenas para o domínio web.whatsapp.com — nenhum outro site é acessado. Após instalar, o ícone GoZAP aparece na barra de extensões do Chrome.
Permissões da extensão
# Permissões solicitadas pela extensão GoZAP:✔ Ler dados de web.whatsapp.com (apenas)✔ Armazenamento local (para salvar config da instância)✖ Sem acesso a outros sites ou abas✖ Sem acesso ao histórico de navegação✖ Sem coleta de dados sem consentimento explícito─────────────────────────────────────────────────────✔ Dados transmitidos com TLS 1.3 + criptografia E2E
Requisitos para a migração
Chrome 110+ ou Edge baseado em Chromium
WhatsApp Web aberto e conectado no navegador
Conta GoZAP com instância criada (aguardando sessão)
Internet estável — upload de ~80KB de dados de sessão
02
Capturando a sessão ativa
Com o WhatsApp Web aberto e logado, clique no ícone da extensão GoZAP. Selecione a instância de destino no seu painel GoZAP e clique em "Capturar e migrar sessão". A extensão lê os dados de autenticação do localStorage e os envia criptografados para a nuvem.
Log da captura de sessão
[GoZAP Extension] Iniciando captura de sessão...✔ WhatsApp Web detectado e conectado✔ Número identificado: +55 11 99999-8888✔ Credenciais capturadas: 82KB✔ Transmissão criptografada para GoZAP Cloud[GoZAP Cloud] Reconstituindo sessão...✔ Sessão importada em 4.1s✔ Instância cliente-maria → CONNECTED─────────────────────────────────────────────────────✔ Nenhum QR code necessário
03
Verificando a sessão migrada
Após a migração, a instância no painel GoZAP mostra status CONNECTED. Teste enviando uma mensagem via API para confirmar que a sessão está ativa. O WhatsApp Web no navegador do cliente continuará funcionando normalmente — a GoZAP opera como um dispositivo vinculado adicional.
Teste pós-migração
curl-X POST https://api.gozap.dev/message/send \-H"Authorization: Bearer {API_KEY}" \-d'{ "instance": "cliente-maria", "to": "[email protected]", "message": "Sessão migrada com sucesso! Teste de envio." }'─────────────────────────────────────────────────────✔ Mensagem entregue — sessionOrigin: chrome_migration 04
Migração em lote para múltiplos clientes
Para agências que gerenciam múltiplos clientes, a extensão suporta migração em lote via script de automação de navegador. Configure o script com as instâncias GoZAP de destino e execute em série — cada sessão migrada em menos de 30 segundos.
Migração em lote — output
# Resultado da migração de 12 sessões✔ cliente-01 → CONNECTED (3.8s)✔ cliente-02 → CONNECTED (4.2s)✔ cliente-03 → CONNECTED (3.5s) ... [9 mais]✔ cliente-12 → CONNECTED (4.0s)Total: 12/12 sessões migradasTempo total: 52s0 QR codes necessários
Quando usar migração via extensão
Clientes que já usam WhatsApp Web ativamente
Agências onboarding múltiplos clientes de uma vez
Migração de outro provedor sem nova vinculação
Renovação de sessão sem contato com o cliente
Extensão disponível
Instale o GoZAP Session Migrator no Chrome
A extensão está disponível gratuitamente na Chrome Web Store para todos os usuários GoZAP. Onboarding de clientes em segundos, sem fricção, sem QR code.