A versão Mobile do WhatsApp tem limites diferentes da Web — mais instâncias simultâneas, menos desconexões, comportamento mais próximo de um aparelho real. A GoZAP permite usar esse modo diretamente na nuvem, sem que o cliente precise instalar nada ou emprestar o celular.
O segredo está em como a GoZAP gerencia o handshake de autenticação. Você configura o modo, gera o QR, o cliente escaneia uma única vez — e a sessão fica na nuvem indefinidamente, renovando-se automaticamente.
"Modo Mobile significa sessão mais estável, menos banimentos e zero dependência do hardware do cliente."
Passo a passo
01
Criando a instância no modo Mobile
Ao criar uma nova instância no painel GoZAP, selecione o tipo de cliente Mobile (Android) antes de salvar. Isso define o User-Agent e o protocolo de handshake usado na conexão com os servidores do WhatsApp.
POST /api/instance/create
# Criando instância com tipo mobile via APIcurl-X POST https://api.gozap.dev/instance/create \-H"Authorization: Bearer {API_KEY}" \-H"Content-Type: application/json" \-d'{ "instanceName": "cliente-joao", "clientType": "mobile", "platform": "android", "autoReconnect": true }'─────────────────────────────────────────────────────✔ Instância criada: cliente-joao✔ Tipo: Mobile (Android)✔ Status: AGUARDANDO_QR
Vantagens do modo Mobile
Suporta até 4 dispositivos vinculados simultaneamente
User-Agent de smartphone — menor taxa de detecção
Reconexão automática sem novo QR code
Compatível com recursos exclusivos de mobile (stickers, reactions)
02
Gerando e entregando o QR code ao cliente
Após criar a instância, use o endpoint de QR para obter um código temporário válido por 60 segundos. Você pode exibir direto no painel GoZAP ou embutir o QR na sua própria interface com o base64 retornado pela API.
GET /api/instance/qr
curl https://api.gozap.dev/instance/cliente-joao/qr \-H"Authorization: Bearer {API_KEY}"# Resposta:{"qrcode": "data:image/png;base64,iVBORw0KGgo...","expiresIn": 60,"instructions": "Abra WhatsApp → Mais opções → Dispositivos vinculados"}─────────────────────────────────────────────────────✔ QR gerado — expira em 60s✔ Exibir ao cliente para escaneamento único
O cliente abre o WhatsApp no celular, vai em Mais opções → Dispositivos vinculados → Vincular dispositivo e escaneia o QR. Pronto — a sessão passa para o estado CONECTADO e não precisa mais do celular.
03
Monitorando a saúde da sessão mobile
Sessões mobile na GoZAP enviam heartbeats a cada 30 segundos. Se a conexão cair, o sistema tenta reconectar automaticamente por até 5 minutos antes de notificar via webhook. Configure o webhook de status para saber em tempo real o estado de cada instância.
Webhook de status de sessão
# Payload recebido no seu endpoint de webhook{"event": "session.status","instance": "cliente-joao","status": "CONNECTED","clientType": "mobile","platform": "android","lastSeen": "2026-08-29T14:23:11Z","uptime": 86400}─────────────────────────────────────────────────────✔ uptime: 86400s (24h sem reconexão)✔ Heartbeat ativo — sessão saudável
04
Transferindo a sessão entre ambientes
Se você precisar mover a instância para outro servidor ou cluster Kubernetes, a GoZAP exporta o estado da sessão mobile como um bundle criptografado. Importe no destino e a sessão retoma sem precisar de novo QR code.
Export → Import de sessão
# 1. Exportar sessão do servidor de origemcurl-X POST https://api.gozap.dev/instance/cliente-joao/export \-H"Authorization: Bearer {API_KEY}" \-o session-bundle.enc# 2. Importar no servidor de destinocurl-X POST https://api.gozap.dev/instance/import \-H"Authorization: Bearer {API_KEY}" \--data-binary@session-bundle.enc─────────────────────────────────────────────────────✔ Sessão importada sem novo QR✔ cliente-joao → CONNECTED em 3.2s
Cenários onde a exportação de sessão é útil
Migração entre planos ou regiões de datacenter
Disaster recovery — restaurar sessão de backup
Clonagem de ambiente dev → prod sem novo QR
Manutenção de servidor sem downtime para o cliente
Próximo passo
Ative o modo Mobile na sua conta GoZAP
Crie sua primeira instância Mobile e entregue sessões mais estáveis para os seus clientes. O painel inclui monitor de saúde, exportação de sessão e notificações de reconexão.