Antes de começar — o que você vai precisar
Separa isso antes de sentar pra fazer:
- Seu número de WhatsApp Business já ativo no celular — o mesmo que você usa pra atender seus clientes. Você não vai trocar de número nem perder conversas.
- O número precisa ter algum tempo de uso no app WhatsApp Business. Se você acabou de instalar ou de transferir o número, use ele normalmente por alguns dias antes de conectar. Número muito novo costuma travar no passo final, com o erro #4563004. A Meta não publica um prazo exato, e o que a gente vê na prática é que quase toda trava desse tipo é de conta criada na semana.
- App WhatsApp Business atualizado (versão 2.24.17 ou mais nova). Atualiza na Play Store / App Store antes de começar.
- O celular com esse número em mãos — você vai escanear um QR code com ele.
- Acesso ao seu painel —
https://painel-{seu-slug}.n3ai.com.br(chegou por email após o pagamento).
NÃO apague sua conta do WhatsApp nem desinstale o app. No modo Coexistence, o app do celular continua funcionando normalmente — é ele que fica vinculado ao painel. Apagar a conta, deslogar ou desinstalar quebra a conexão e pode perder suas conversas.
Visão geral — os 3 passos
1
Abrir o painel e clicar "Conectar pela Meta"
1 minuto
2
Escanear o QR code com o WhatsApp Business
2 minutos
3
Confirmar a sincronização do histórico
1 minuto
Pronto. Sem colar tokens, sem System User, sem configurar webhook. A Meta cuida de tudo nesse modo.
1
Abrir o painel e clicar "Conectar pela Meta"
1 min
O que fazer
- Abre seu painel:
https://painel-{seu-slug}.n3ai.com.br(exemplo:https://painel-minha-empresa.n3ai.com.br). - Faz login com seu usuário e senha (chegaram por email após o pagamento).
- Vai aparecer o assistente "Conectar WhatsApp". Clica no botão "Conectar pela Meta".
- Abre uma janela oficial da Meta. Se pedir, faz login com a conta de Facebook que administra o seu negócio.
Uma janela da Meta abre por cima do painel. É normal — toda a conexão acontece dentro dela, com a segurança da própria Meta. Você não cola nenhum dado técnico (nada de token, ID ou System User).
A janela não abre / some na hora: seu navegador bloqueou o pop-up. Libera o pop-up pro site e clica de novo.
"Aplicativo inativo" ou erro genérico: tenta de novo em alguns segundos. Se persistir, fala com a gente no WhatsApp.
"Aplicativo inativo" ou erro genérico: tenta de novo em alguns segundos. Se persistir, fala com a gente no WhatsApp.
2
Escanear o QR code com o WhatsApp Business
2 min
O que fazer
- Na janela da Meta, confirma o seu número de WhatsApp Business e segue.
- A Meta mostra um QR code na tela do computador.
- No celular, abre o app WhatsApp Business → Configurações → Dispositivos conectados (ou "Aparelhos conectados") → Conectar um aparelho.
- Aponta a câmera do celular pro QR code que apareceu no computador.
É o mesmo jeito que você conecta o WhatsApp Web. A diferença é que aqui você está autorizando o painel da N3ai a disparar campanhas pelo seu número — mantendo o app do celular ativo do jeito que está.
QR não escaneia: confere se o app está atualizado (2.24.17+) e se tem boa iluminação na câmera.
"Limite de aparelhos conectados": no app → Dispositivos conectados, remove os que você não usa pra liberar um espaço, e escaneia de novo.
"Limite de aparelhos conectados": no app → Dispositivos conectados, remove os que você não usa pra liberar um espaço, e escaneia de novo.
3
Confirmar a sincronização e pronto
1 min
O que fazer
- Depois de escanear o QR, a Meta mostra uma tela perguntando se você quer importar contatos e o histórico de conversas dos últimos 6 meses.
- Clica em continuar / confirmar pra liberar a sincronização — assim o painel já mostra suas conversas e contatos.
- A janela fecha sozinha e volta pro painel. Em alguns segundos a pílula no topo fica verde — "WhatsApp conectado".
Pronto! Seu número está em Coexistence: continua funcionando no app do celular E conectado ao painel pra disparos. Não precisa colar token, criar System User nem configurar webhook — a Meta faz tudo automaticamente nesse modo.
"Something went wrong while generating pairing information" (#4563004): quase sempre é porque o número é muito novo no WhatsApp Business (criado nos últimos dias) ou o limite de aparelhos conectados está cheio. Use o número por mais alguns dias, libere um aparelho conectado, e tente de novo. Não fique repetindo na hora — espace as tentativas.
Travou e voltou pro painel sem conectar: aguarde 1-2 minutos e atualize a página (F5). Se a pílula não ficar verde, fala com a gente.
Travou e voltou pro painel sem conectar: aguarde 1-2 minutos e atualize a página (F5). Se a pílula não ficar verde, fala com a gente.
Erros comuns — guia de SOS
"Something went wrong while generating pairing information" (#4563004)
Causa mais comum: o número é muito novo no WhatsApp Business (criado nos últimos dias) — a Meta não publica prazo exato, mas conta recém-criada trava aqui com frequência antes de liberar a conexão.
Fix: use o número normalmente no app por alguns dias e tente de novo. Confere também se não está no limite de aparelhos conectados (remove os que não usa). Não fique repetindo na hora — espace as tentativas.
QR code não escaneia
Causa: app desatualizado ou câmera com problema.
Fix: atualiza o WhatsApp Business pra versão 2.24.17+ na loja, garante boa iluminação, e tenta de novo em Configurações → Dispositivos conectados → Conectar um aparelho.
"Limite de aparelhos conectados"
Causa: seu WhatsApp Business já está com o máximo de dispositivos vinculados.
Fix: no app → Configurações → Dispositivos conectados, remove os que você não usa pra liberar um espaço, e escaneia de novo.
A janela da Meta não abre quando clico em "Conectar pela Meta"
Causa: o navegador bloqueou o pop-up.
Fix: libera pop-ups pro site do painel (ícone na barra de endereço) e clica de novo. Use Chrome ou Edge.
"Aplicativo inativo" na janela do Facebook
Causa: cache do login do Facebook ou instabilidade momentânea da Meta.
Fix: fecha a janela, atualiza a página do painel (F5) e tenta de novo em alguns segundos. Se persistir, fala com a gente.
"Painel diz conectado mas não envia mensagem"
Causa: falta criar e aprovar um template.
Fix: aba Templates no seu painel, cria um e manda pra aprovação. A aprovação da Meta leva de minutos a algumas horas.
Template aprovado, mas as campanhas não saem (ou aparece erro de pagamento)
Causa mais comum: falta cadastrar uma forma de pagamento (cartão) na sua conta da Meta. Sem isso a Meta bloqueia o envio de campanhas (erro 141006). Isso não é cobrança da N3ai — é o pagamento das mensagens, feito direto com o WhatsApp/Meta. Responder quem te escreve é grátis e ilimitado. Campanha de marketing é sempre cobrada (cerca de R$ 0,32 por mensagem entregue). Aviso de utilidade — pedido, entrega, cobrança — é grátis se a pessoa falou com você nas últimas 24 horas, e custa cerca de R$ 0,04 fora dessa janela. Quem cobra é a Meta, direto na sua conta.
Fix: entre em business.facebook.com → Configurações de cobrança/pagamento da sua conta WhatsApp Business → adicione um cartão. Em alguns minutos a Meta libera e as campanhas voltam a sair.
Minhas conversas sumiram do celular depois de conectar
Causa: alguém apagou a conta ou deslogou o WhatsApp Business do celular.
Fix: no Coexistence o app NUNCA deve ser apagado/deslogado — ele é parte da conexão. Se isso aconteceu, fala com a gente imediatamente.
Disparei uma campanha, a Meta diz "entregue", mas a mensagem não aparece no WhatsApp do meu celular
É normal — não é erro. No modo Coexistence, as mensagens que você dispara pelo painel (campanhas e templates) não aparecem na conversa do app do WhatsApp Business no seu celular. O app espelha o que você manda pelo próprio celular — os disparos em massa feitos pelo painel não ficam espelhados lá.
"Entregue" quer dizer que chegou: esse status confirma que a mensagem chegou no celular do seu cliente (o destinatário recebeu normalmente). O que não acontece é só o espelhamento no seu aparelho.
Como acompanhar: use a tela de Campanhas no painel — lá você vê em tempo real quantas mensagens foram enviadas, entregues e lidas. Esse é o lugar certo pra acompanhar disparos; o app do celular não foi feito pra isso.
Próximos passos depois de conectar
Conectou? Beleza. Agora a parte boa:
- Criar seu primeiro template — vai em Templates → Novo Template. Começa simples: uma promoção, uma boas-vindas. Você pode usar só texto, ou colocar imagem ou vídeo no topo do template, e adicionar botões (resposta rápida, link pro seu site ou ligar). Manda pra Meta aprovar.
- Importar lista de contatos — vai em Contatos → Importar. Aceita CSV. Coluna obrigatória:
telefone(com DDD, sem espaços ou traços). - Cadastrar o pagamento na Meta — pra Meta liberar o envio de campanhas, sua conta WhatsApp Business precisa de um cartão cadastrado (em business.facebook.com). Não é cobrança da N3ai — é o pagamento das mensagens, direto com o WhatsApp; responder quem te escreve é grátis e ilimitado; marketing é sempre cobrado (~R$ 0,32/msg) e utilidade é grátis dentro da janela de 24h, ~R$ 0,04 fora dela. Sem isso, as campanhas ficam bloqueadas.
- Disparar primeira campanha — quando o template estiver aprovado (status verde), vai em Campanhas → Nova Campanha. Escolhe o público, escolhe o template, revisa, dispara.
- Acompanha o resultado — na tela da campanha você vê em tempo real: quantas enviadas, entregues, lidas. Importante: os disparos do painel não aparecem no app do WhatsApp no celular (isso é normal do Coexistence) — acompanhe sempre por aqui.
Travou em algum ponto?
A gente está no WhatsApp. Manda print do erro, fala em qual passo travou e respondemos rápido.
Falar com o suporte no WhatsApp · +55 (11) 99354-6300