👁 2.341 leituras⏱ 3 min de leitura📅 Atualizado em março/2026
💡
Resumo rápido
Para conectar seu WhatsApp ao Promium, você precisa ter uma instância criada e escanear o QR Code pelo aplicativo do WhatsApp no celular. O processo leva menos de 1 minuto.
📋 Pré-requisitos
Antes de começar, certifique-se de que você tem:
Uma conta Z-API ativa com as credenciais configuradas em Configurações → Credenciais de API
O aplicativo do WhatsApp instalado e ativo no celular que deseja conectar
Uma instância criada no Promium (se ainda não tem, veja o passo 1 abaixo)
🪜 Passo a passo
1
Acesse WhatsApp → Instâncias
No menu lateral do Promium, clique em WhatsApp e depois em Instâncias. Você verá a lista de instâncias da sua conta.
2
Crie uma instância (se necessário)
Se a lista estiver vazia, clique em + Adicionar Número, informe um nome para a instância (ex: instancia-01) e clique em Criar Instância. O nome não pode ter espaços.
3
Clique em "Conectar"
Na linha da instância desconectada, clique no botão verde Conectar. Uma janela será aberta com o QR Code gerado pela Z-API.
4
Abra o WhatsApp no celular
No aplicativo do WhatsApp, toque em Configurações (ícone de engrenagem) e depois em Aparelhos conectados.
5
Escaneie o QR Code
Toque em Conectar um aparelho e aponte a câmera para o QR Code exibido no Promium. O código expira em 20 segundos e é renovado automaticamente.
6
Aguarde a confirmação ✅
Após o escaneamento, o Promium detecta a conexão em alguns segundos e a instância passa a aparecer como Conectado com o número do WhatsApp.
✅
Conectado com sucesso!
A partir deste momento, o Promium pode enviar mensagens e promoções automáticas pelo número conectado para os seus grupos do WhatsApp.
⚠️ Problemas comuns
QR Code não aparece
Verifique se o instance_id e o instance_token da instância estão corretamente preenchidos no banco. Se a instância foi criada recentemente pelo painel, esses campos precisam ser configurados manualmente a partir do painel da Z-API.
QR Code expira antes de escanear
O QR Code é renovado automaticamente a cada 20 segundos. Se estiver demorando para abrir o WhatsApp, deixe a janela aberta — um novo código será gerado automaticamente.
Aparece "Conectado" mas some depois
Isso geralmente indica que o WhatsApp foi desconectado pelo celular (bateria, troca de rede, ou modo avião). Basta clicar em Conectar novamente e reescanear o QR Code.
⚠️
Atenção
Não use o mesmo número do WhatsApp em duas instâncias simultaneamente. Isso pode causar desconexões frequentes e banimento temporário do número.
❓ Dúvidas frequentes
Posso conectar mais de um número?
Sim. Cada instância corresponde a um número de WhatsApp. Você pode criar e conectar múltiplas instâncias conforme seu plano permitir.
O número precisa ter WhatsApp Business?
Não. O Promium funciona com WhatsApp pessoal e Business. O processo de conexão é idêntico nos dois casos.
O celular precisa ficar ligado?
Sim. O WhatsApp exige que o celular esteja com internet ativa para manter a conexão com aparelhos vinculados. Se o celular desligar por muito tempo, a instância pode se desconectar.