Integracoes

Neste guia: Conecte os provedores no workspace correto e encontre ajuda para falhas de conexão.

• Conectar Facebook Lead Ads.
• Autorizar acesso aos leads.
• Escolher a conexão do WhatsApp.

Integracao com Google Ads Lead Forms ja existe na tela mas ainda esta desativada enquanto o app do Zhapio aguarda verificacao da Meta/Google para esse escopo. Se o cartao aparecer desabilitado ou nao aparecer, nao e um bug: ainda nao ha data confirmada para a liberacao.

• Formularios instantaneos (Instant Forms) sao os unicos que geram leads aqui. Anuncios que levam para um site externo ou para conversas no WhatsApp nao entram nesse fluxo — a Meta os trata como formatos diferentes.
• Contas de anuncio vazias (0 contas) apos conectar geralmente sao cosmeticas: a permissao de leitura de anuncios nem sempre e concedida e isso nao impede a importacao de leads.
• Uma mesma pagina do Facebook so pode estar conectada a um workspace do Zhapio por vez. Se aparecer aviso de "ja conectada em outro lugar", desconecte a pagina no workspace anterior primeiro.

Isso nao e um passo opcional em nenhuma das duas pontas — sem qualquer uma dessas permissoes, paginas e formularios podem aparecer conectados normalmente no Zhapio e ainda assim nenhum lead chegar.

O guia de configuracao dentro do cartao do Facebook em Integracoes tem uma busca por problema com os links diretos da Meta para cada uma dessas telas, alem dos erros mais comuns ja traduzidos.

Nao existe um botao separado de "renovar". Reconectar e simplesmente repetir o fluxo de login da Meta: isso substitui as credenciais salvas, e o Zhapio busca sozinho os leads que chegaram enquanto a conexao estava parada.

• Leads aparecem na Meta mas nao no Zhapio: quase sempre e o Acesso a leads do Business Suite nao autorizado para o Zhapio, ou a pagina que recebeu o lead nao esta entre as paginas conectadas.
• Lista de formularios vazia: falta a permissao de gerenciar anuncios na hora do login — reconecte e mantenha tudo marcado.
• "0 paginas" logo apos conectar: nenhuma pagina foi marcada na janela da Meta, ou voce entrou com o perfil ou portfolio errado.
• Importacao manual funciona mas leads em tempo real nao chegam: a inscricao da pagina no evento de leadgen pode ter falhado silenciosamente no momento da conexao. Desconectar e reconectar refaz essa inscricao; ha tambem uma rotina periodica do Zhapio que tenta reinscrever paginas pendentes sozinha.
• Leads zerados na importacao: ou os leads daquele formulario ja foram importados antes (o Zhapio ignora duplicados), ou o formulario realmente nao tem respostas ainda.
• Para isolar se o problema e da Meta ou do Zhapio, use a Ferramenta de teste de Lead Ads oficial da Meta para simular um envio e conferir se ele chega no Zhapio.

Quem decide o modo final da conexao e a propria Meta durante o fluxo, nao o botao que voce clicou. Por exemplo, se o numero ja estava cadastrado no WhatsApp Business App, a Meta pode concluir como coexistencia mesmo que voce tenha escolhido "somente pela API". Quando isso acontece, o Zhapio mostra um aviso de que o modo concluido foi diferente do escolhido — leia esse aviso antes de continuar usando a conexao, porque muda o que a integracao faz.

• Conectar app e importar historico (coexistencia): o WhatsApp Business App continua funcionando normalmente no celular, o Zhapio importa contatos e cerca de 6 meses de historico de conversas e a sincronizacao passa a ser nos dois sentidos. Em troca, voce abre mao do selo oficial verificado, do Marketing Messages Lite, do envio para grupos e da migracao futura da WABA. E preciso desligar marcacao automatica de eventos antes de conectar, estar na versao 2.24.17 ou mais recente do app, e abrir o WhatsApp Business App no celular pelo menos uma vez a cada 13 dias — passar desse prazo quebra a sincronizacao.
• Conectar somente pela API, sem app nem historico: o numero precisa ser totalmente removido do WhatsApp Business App antes de conectar, e essa troca e de mao unica — depois de migrado, nao ha caminho de volta para o app. Nao ha importacao de historico. Em compensacao, e o unico caminho que da acesso ao selo verificado oficial e a limites de envio mais altos.
• Criar um numero novo pela Meta: e o caminho de menor risco, porque nao mexe em nenhum numero que voce ja usa — mas comeca zerado, sem historico, e com um limite inicial de 1.000 conversas por dia ate a Meta elevar esse limite com o uso.

Se voce estiver conectando o numero de um cliente (nao o seu proprio negocio), prefira sempre a janela de Cadastro Incorporado da Meta em vez de um login simplificado. Em contas de terceiros, um login simplificado pode falhar com erro generico da Meta a menos que a WABA do cliente ja esteja compartilhada com o app do Zhapio.

• Conexoes pessoais sao verificadas em segundo plano a cada 15 minutos, e uma conexao so e tratada como desatualizada apos 6 horas sem checagem bem-sucedida. Essa verificacao e so leitura: mesmo que a Meta esteja fora do ar, ela nunca desconecta sua conta sozinha — apenas registra o erro para voce ver.
• Conexoes de WhatsApp de uma organizacao sao verificadas de outra forma: a saude e recalculada na hora, sempre que a tela de status e aberta, usando uma janela de 15 minutos antes de buscar de novo a classificacao de qualidade do numero na Meta.
• Se aparecer um aviso de erro de saude no cartao de WhatsApp, ele reflete a ultima checagem — nao precisa reconectar automaticamente por causa dele, mas vale investigar antes que afete o envio.

Durante a coexistencia, quando um humano responde pelo proprio WhatsApp Business App no celular, o Zhapio pausa a IA para aquela conversa por um tempo, para nao haver duas respostas conflitantes chegando ao mesmo cliente. Se a IA parecer "muda" logo depois que alguem respondeu manualmente pelo celular, esse comportamento e esperado.

• Marcacao automatica de eventos ainda ativa no WhatsApp Business App: bloqueia a elegibilidade para coexistencia. Desligue essa opcao no app antes de tentar conectar de novo.
• Numero reprovado na checagem de elegibilidade da Meta: e um erro guarda-chuva que normalmente aponta para um dos problemas mais especificos abaixo.
• Numero ja vinculado a outro aplicativo, parceiro ou a uma tentativa anterior do proprio Zhapio: e preciso desvincular pelo celular, em Configuracoes, Conta, Plataforma de negocios (ou Contas vinculadas), e aguardar cerca de 15 minutos antes de tentar de novo.
• Numero pertence a outro portfolio de negocios ou WABA diferente do que voce esta usando para conectar.
• Numero nao esta registrado no WhatsApp Business App (para coexistencia) ou nao foi totalmente removido dele (para o caminho somente API).
• Regiao nao elegivel para coexistencia: Meta ainda restringe esse modo em paises como os da Uniao Europeia, Reino Unido, Japao, India, Australia, Nigeria, Filipinas, Russia, Coreia do Sul, Africa do Sul e Turquia.
• Versao desatualizada do WhatsApp Business App (anterior a 2.24.17): atualize o app antes de conectar.
• Conta ou portfolio restrito, negocio nao verificado limitando a criacao de numeros, ou nome de exibicao reprovado: sao decisoes de moderacao da propria Meta, tratadas caso a caso pelo suporte da Meta.
• Falta de forma de pagamento cadastrada na WABA: bloqueia o envio de mensagens de template e mensagens iniciadas pelo negocio, mesmo com a conexao aparecendo ativa.
• Janela de permissao nao abre: geralmente e um bloqueador de pop-up, extensao de privacidade do navegador, ou o navegador estar em modo anonimo — nao e um erro da Meta.
• Historico e contatos nao vieram apos conectar em coexistencia: normalmente a caixa de consentimento de importacao foi recusada dentro da propria janela da Meta.
• Migrar de coexistencia para somente API depois de ja estar usando: e de mao unica e exige desvincular o numero no celular e apagar a conta do WhatsApp Business App nele antes de tentar.
• Coexistencia que "cai" sozinha depois de algumas semanas: quase sempre e o WhatsApp Business App que ficou mais de 13 dias sem ser aberto no celular.

Quem administra a organizacao tem um cartao proprio de supervisao em Integracoes para acompanhar e, se necessario, revogar a conexao pessoal de um integrante — por exemplo, quando alguem sai da equipe ou troca de numero.