Solucao de problemas
Resolva os problemas mais comuns de login, carregamento, contatos e envio.
Dicas práticas
Neste guia: Comece pelo sintoma que está vendo e siga a verificação correspondente.
Nao consigo entrar
Quando o login falha, o Zhapio quase sempre mostra uma mensagem generica de proposito: "Credenciais inválidas" aparece tanto para senha errada quanto para e-mail que nao existe, para nao dar pista a quem esta tentando adivinhar uma conta. Se voce esqueceu com qual e-mail se cadastrou, va direto para a recuperacao de senha em vez de tentar varias combinacoes.
Depois de 5 tentativas de senha erradas, a conta trava por 15 minutos automaticamente. A tela mostra "Muitas tentativas. Tente novamente em alguns minutos." e voce tambem recebe um e-mail avisando do bloqueio de seguranca.
Atenção
- 5 senhas erradas seguidas = 15 minutos de bloqueio automatico, nao e um bug.
- O aviso chega tambem por e-mail (aviso de bloqueio de seguranca) — confira a caixa de entrada e o spam.
- Errou o e-mail, nao a senha? A mensagem e a mesma para os dois casos; use "Esqueci minha senha" em vez de tentar adivinhar.
Se voce esta sendo deslogado com frequencia, o motivo normalmente e a duracao da sessao: por padrao o login mantem voce conectado por ate 30 dias. Se a opcao de permanecer conectado estiver desmarcada na tela de entrada, a sessao dura so 1 dia. Trocar a senha tambem encerra as sessoes abertas em outros aparelhos e navegadores por seguranca — entao se voce mudou a senha recentemente, e esperado ter que entrar de novo em cada lugar.
Se o problema e o painel web e a extensao mostrando contas diferentes (ou uma logada e a outra nao), o mecanismo e outro — veja a proxima secao.
Sincronizar a extensao com o painel web
A extensao e o painel web guardam o login separadamente, e sincronizam sozinhos — mas so quando uma aba do proprio Zhapio carrega, nao quando voce recarrega o WhatsApp Web. Ao abrir qualquer pagina do zhapio.com, um script de sincronizacao compara o token guardado pela extensao com o token do navegador: se forem diferentes, o token da extensao sempre vence e fica gravado na pagina; se a extensao nao tiver nenhum token e o navegador tiver, a extensao adota o token do navegador. A extensao tambem renova sozinha sua propria sessao a cada 45 minutos e sempre que uma chamada volta com erro 401; se essa renovacao tambem falhar, ela desloga a extensao automaticamente.
Abra ou recarregue uma aba do proprio Zhapio (nao a aba do WhatsApp Web) — e isso que dispara a sincronizacao entre extensao e painel.
Confirme ali que voce esta logado com a conta certa.
So depois volte para a aba do WhatsApp Web e recarregue-a — e nela que a extensao redesenha a barra lateral com o token ja atualizado.
Clique no botao de perfil da barra lateral da extensao para confirmar qual conta ficou ativa.
Dicas práticas
- Se a extensao continuar deslogando sozinha, pode ser um loop de renovacao falhando (erro 401 repetido) — nesse caso ela se desloga por seguranca; entre de novo pelo painel web e repita os passos acima.
Painel vazio ou carregando
Paineis vazios costumam ter uma de tres causas: voce caiu do login (veja as duas secoes acima), a conexao com a API esta instavel, ou o WhatsApp Web ainda esta carregando. Existe tambem uma quarta possibilidade, mais rara: um widget especifico do dashboard quebrou sozinho. Hoje isso e isolado — cada widget e protegido separadamente, entao um card com erro nao derruba mais o dashboard inteiro. Ou seja: pagina inteira em branco e um problema; um unico card quebrado, com o resto do dashboard funcionando normalmente, e outro, bem mais raro de precisar de suporte.
Feche o painel ou a aba e abra de novo.
Recarregue o WhatsApp Web.
Confirme que voce esta conectado ao Zhapio — se a duvida for entre extensao e painel web, siga "Sincronizar a extensao com o painel web" acima.
Se so um widget estiver quebrado e o resto do dashboard funcionar, recarregar a pagina normalmente resolve; se a pagina inteira ficar em branco mesmo depois dos passos acima, abra Ajuda e suporte na barra lateral e clique em Reportar bug.
Falhas ao enviar pelo Inbox
Existem dois caminhos de envio diferentes no Zhapio, e cada um falha de um jeito diferente. Esta secao cobre o envio manual pelo Inbox, feito pelo numero oficial conectado via Cloud API da Meta — as mensagens de erro aqui sao especificas e dizem exatamente o que aconteceu, entao vale ler o texto completo antes de assumir que e um bug. Campanhas e automacoes tem uma logica propria, coberta na proxima secao.
Importante
- "A janela de 24h está fechada para o número selecionado. Envie um modelo aprovado para reabrir a conversa." — o cliente nao te escreve ha mais de 24h; so um modelo (template) aprovado pela Meta reabre a conversa para texto livre.
- "Informe um número de WhatsApp válido, com DDD e código do país quando necessário." — aparece ao iniciar uma conversa nova com um numero mal formatado.
- "Nenhum número do WhatsApp conectado para esta organização." — nao ha numero oficial conectado; confira em Integracoes.
- Modelo preso ao numero errado ou sem a midia de exemplo do cabecalho: a mensagem aponta exatamente isso e, no segundo caso, pede para reenviar o arquivo de exemplo em Modelos.
- "O WhatsApp aceita reações somente em mensagens dos últimos 30 dias." — reacoes (emoji) em mensagens mais antigas nao sao permitidas pela propria Meta.
Quando o erro vem direto da Meta (nao do Zhapio), ele aparece como uma frase legivel com o codigo numerico da Meta entre parenteses no final, por exemplo "(Meta code 131030)". Nesses casos o texto ja explica o motivo — o codigo serve para voce, ou o suporte, confirmar exatamente qual regra da Meta foi acionada, em vez de tratar como uma falha aleatoria.
Dicas práticas
- Revise o formato dos telefones antes de enviar, principalmente DDD e codigo do pais.
- Teste com poucos contatos antes de um envio em lote.
- Se voce usa o numero pessoal via extensao (coexistencia com o WhatsApp Business App), mantenha a aba do WhatsApp Web aberta e logada — esse caminho depende da sessao do navegador. Ja o numero oficial via Cloud API nao depende disso.
Falhas em campanhas e automacoes
Envios automaticos — campanhas de Disparo e automacoes de formulario — passam pela API oficial da Meta, e o jeito como ela reporta falha e diferente do envio manual: a Meta pode aceitar o envio na hora, e o Zhapio registrar como enviado, e so avisar que falhou minutos depois, por um webhook de status separado. Isso significa que "enviado" nao e a palavra final — o status real pode mudar depois.
Atenção
A causa isolada mais comum de falha em massa e bloqueio de cobranca da Meta (codigo 131042): "A Meta bloqueou a cobrança desta conta do WhatsApp. Adicione ou regularize a forma de pagamento no Gerenciador da Meta — vamos tentar reenviar automaticamente." Para resolver, abra o cartao de cobranca da Meta nas paginas de Modelos ou de Automacoes: ele mostra a severidade (bloqueado, atencao ou ok), os motivos informados pela Meta, quantas falhas de pagamento aconteceram nos ultimos 7 dias, quantos reenvios estao pendentes, e um link direto para adicionar credito ou forma de pagamento no Gerenciador da Meta.
Fora cobranca, os outros motivos de falha caem em categorias com tratamento proprio:
Importante
- Limite temporario (throttle): a Meta esta limitando o ritmo de envio; o Zhapio reenvia sozinho. Um caso especifico e o limite por destinatario — a Meta atingiu o quanto aquela pessoa especifica pode receber de empresas agora, e so libera depois de algumas horas, entao reenviar na hora nao adianta.
- Token ou numero desconectado: erros de autenticacao (token morto, revogado, ou numero removido da conta da Meta) ficam guardados na fila sem gastar tentativas, por ate 24h, esperando voce reconectar — a mensagem no proprio erro diz "a mensagem sai assim que a conexão voltar."
- Destinatario invalido: a Meta simplesmente nao consegue entregar para aquele numero — nao esta no WhatsApp, precisa de reengajamento (janela de 24h fechada, so com modelo aprovado) ou, em ambiente de teste da Meta, o numero nao esta na lista de destinatarios permitidos.
- Modelo recusado pela Meta: "o modelo foi recusado pela Meta (parâmetros, formato ou modelo pausado/desativado)." O texto exato que a Meta deu aparece na pagina de Modelos, no proprio modelo com status rejeitado.
Abra a campanha ou a automacao e olhe o status real de cada envio, nao so o status geral.
Se o status geral disser Concluido mas os destinatarios dizem que nao chegou nada, atualize a pagina — o sistema reclassifica automaticamente campanhas com falha total, entao o status pode se corrigir sozinho.
Abra o cartao de cobranca da Meta em Modelos ou Automacoes para descartar bloqueio de pagamento primeiro — e a causa mais comum.
Leia o codigo da Meta entre parenteses no erro e compare com as categorias acima antes de reportar como bug.
Leads do Facebook nao chegam
Quando o lead aparece no Gerenciador de Negocios da Meta mas nao no Zhapio, a causa quase sempre e permissao: a Meta trata administrar a pagina e autorizar a leitura dos leads como coisas diferentes — dar administracao da pagina para alguem nao da acesso aos leads automaticamente.
No Meta Business Suite, abra Configuracoes, Integracoes, Acesso a leads, e autorize o Zhapio para cada pagina, na aba de CRMs.
Confirme em Integracoes do Zhapio que a pagina que recebeu o lead esta na lista de paginas conectadas.
Se a conexao aparecer como expirada, reconecte. A Meta recusa o acesso as paginas quando a senha do Facebook e trocada, quando o app conectado e removido ou quando a conta perde o acesso a pagina. Depois de reconectar, o Zhapio busca sozinho os leads do periodo parado; se faltar algum, importe o historico na pagina de Leads.
Use a Ferramenta de teste de Lead Ads da Meta para enviar um lead falso e validar o caminho completo, do formulario ate o Zhapio.
Dicas práticas
- O cartao do Facebook em Integracoes tem busca por palavra-chave e aponta direto para o problema certo, com links da Meta.
- Leads marcados como ignorados na importacao ja existem na sua base — foram descartados por duplicidade, nao perdidos. Procure pelo telefone ou e-mail na pagina de Leads antes de assumir que sumiram.
Problemas conhecidos na conexao com o Facebook Lead Ads
Alem do cenario mais comum acima, existem outros motivos especificos, ja mapeados, para leads do Facebook nao aparecerem direito:
Importante
- Lista de formularios vazia: a permissao de leitura dos formularios foi desmarcada ou revogada na hora de conectar — desconecte e reconecte mantendo todas as permissoes marcadas.
- "0 paginas" depois de conectar: nenhuma pagina foi marcada no seletor de paginas da Meta durante a conexao — reconecte e marque a pagina certa.
- Importacao manual funciona mas leads novos nao chegam sozinhos: a inscricao no webhook daquela pagina nao foi recriada — desconectar e reconectar recria a inscricao; depois teste com a Ferramenta de teste de Lead Ads da Meta.
- Conta errada conectada: o navegador estava logado no perfil ou portfolio de negocios errado da Meta no momento da conexao.
- "Nenhuma conta de anuncios": e cosmetico e nao bloqueia a captura de leads — a leitura de contas de anuncios e so opcional.
- Formulario sem nenhum lead: ou o formulario realmente nao teve envios, ou os leads ja foram importados e marcados como ignorados por duplicidade (veja o item sobre leads ignorados na secao acima).
- Pagina ja conectada em outro lugar: a mesma pagina ja esta vinculada a outro workspace — por exemplo, sua conta Pessoal e uma Empresa ao mesmo tempo. E preciso adotar explicitamente a conexao existente ou desconectar do outro lado primeiro.
Se os leads chegam no Zhapio mas ficam sem fila (bloqueados ou nao roteados), isso ja nao e um problema de conexao, e sim de configuracao de roteamento — territorio de administrador em contas Enterprise. O painel de Distribuicao de Leads tem uma area propria de leads bloqueados, com a acao "Conectar origem a uma fila" para resolver direto por ali.
Continue aprendendo
Escolha o próximo guia de acordo com a tarefa que você quer concluir: