# Integração WhatsApp Business — Resolução de problemas

> Guia para diagnosticar e resolver os erros mais comuns da integração entre o GS Engage e o Facebook/WhatsApp Business.

- URL canônica: https://docs.growthstation.app/docs/integracoes/whatsapp-business
- Idioma: pt-BR
- Última atualização: 2026-08-17T12:49:19.121Z
- Produto: GS Engage
- Mantido por: Produto GS Engage



<PageHero emoji="🩹" title="Integração WhatsApp Business — Resolução de problemas" description="Diagnostique e resolva os erros mais comuns na configuração e uso da integração com o Facebook/WhatsApp Business." gradient="brand" />

A integração entre o GS Engage e o Facebook/WhatsApp Business pode apresentar alguns problemas durante a configuração e o uso. Abaixo estão os cenários mais frequentes e o passo a passo para resolver cada um.

<Callout type="tip" title="Comece pelo diagnóstico guiado">
  Responda ao [fluxo interativo](/docs/diagnostico-guiado) para separar falhas de navegador, rede, validação da Meta, sincronização de números e templates.
</Callout>

<Callout type="warning" title="Antes de começar">
  Certifique-se de que a integração com o Facebook já foi realizada. Caso ainda não tenha conectado, consulte a [documentação sobre como realizar a conexão com o Facebook](/docs/integracoes/whatsapp).
</Callout>

🔌 Erro de comunicação entre o GS Engage e o Facebook [#-erro-de-comunicação-entre-o-gs-engage-e-o-facebook]

Esse erro pode ocorrer devido ao uso de VPN, proxy ou outras configurações de rede que interferem na comunicação entre o GS Engage e os servidores do Facebook.

<Callout type="tip" title="Como resolver">
  Realize o processo de integração normalmente, porém utilizando uma **aba anônima** do navegador. A navegação anônima desativa extensões e ignora configurações de cache que podem estar causando o conflito.
</Callout>

<Callout type="warning" title="Se o problema persistir">
  Caso o problema persista mesmo em aba anônima, entre em contato com sua equipe de TI para verificar se há alguma regra de rede bloqueando a comunicação com os servidores da Meta.
</Callout>

📱 Como validar o número de telefone dentro da Meta? [#-como-validar-o-número-de-telefone-dentro-da-meta]

Após conectar sua conta, é necessário que o número de telefone utilizado esteja validado na plataforma da Meta para que a integração funcione corretamente.

<Steps>
  <Step num={1} title="Acesse o Meta Business Suite">
    Acesse o [Meta Business Suite](https://business.facebook.com/) e clique no número de telefone desejado.
  </Step>

  <Step num={2} title="Clique em Perfil">
    Clique em <TextHighlight>Perfil</TextHighlight> para acessar as informações do número.
  </Step>

  <Step num={3} title="Verifique o número">
    Clique no botão de verificação do número e siga as instruções exibidas para concluir o processo de validação.
  </Step>
</Steps>

🏢 Como validar a conta da empresa dentro da Meta? [#-como-validar-a-conta-da-empresa-dentro-da-meta]

A verificação da conta empresarial na Meta é um requisito para utilizar a API do WhatsApp Business. Sem essa validação, a integração pode apresentar limitações ou deixar de funcionar.

<Steps>
  <Step num={1} title="Acesse o Meta Business Suite">
    Acesse o [Meta Business Suite](https://business.facebook.com/) e clique no ícone da empresa localizado no canto superior esquerdo da tela.
  </Step>

  <Step num={2} title="Clique em Configurações">
    Clique no botão de <TextHighlight>Configurações</TextHighlight> que aparecer no menu.
  </Step>

  <Step num={3} title="Clique em Configurações da empresa">
    Caso apareça um pop-up automático, siga as instruções exibidas na tela. Caso contrário, clique em <TextHighlight>Configurações da empresa</TextHighlight> no topo da página e role a tela para baixo até encontrar a opção <TextHighlight>Verificação de Conta</TextHighlight>.
  </Step>

  <Step num={4} title="Clique em Verificação de Conta">
    Clique em <TextHighlight>Verificação de Conta</TextHighlight> e inicie o processo de validação seguindo as instruções da Meta.

    <Callout type="warning" title="A verificação pode demorar">
      O processo de verificação da conta empresarial pode levar alguns dias para ser concluído pela Meta. Acompanhe o status diretamente no Meta Business Suite.
    </Callout>
  </Step>
</Steps>

🔄 O número é novo, mas já existe uma conta de WhatsApp associada [#-o-número-é-novo-mas-já-existe-uma-conta-de-whatsapp-associada]

Esse problema ocorre porque as operadoras de telefonia reutilizam números antigos que já tiveram uma conta de WhatsApp associada anteriormente. Para utilizar o número na integração com o WhatsApp Business, é necessário primeiro desvincular a conta existente.

<Steps>
  <Step num={1} title="Insira o chip">
    Insira o chip em um celular e crie uma conta pessoal de WhatsApp com esse número.
  </Step>

  <Step num={2} title="Exclua a conta">
    Dentro do WhatsApp, acesse <TextHighlight>Configurações</TextHighlight> > <TextHighlight>Conta</TextHighlight> > <TextHighlight>Excluir conta</TextHighlight> e confirme a exclusão.
  </Step>

  <Step num={3} title="Aguarde a confirmação">
    Aguarde alguns minutos para que a exclusão seja processada.
  </Step>

  <Step num={4} title="Tente criar a conta">
    Após a exclusão, tente criar a conta novamente pela plataforma da Meta.

    <Callout type="warning" title="Ação irreversível">
      A exclusão da conta é irreversível. Certifique-se de que o número não possui dados importantes antes de prosseguir.
    </Callout>
  </Step>
</Steps>

🔎 Como investigar um erro desconhecido relacionado ao número? [#-como-investigar-um-erro-desconhecido-relacionado-ao-número]

Quando o erro não é identificado diretamente durante o processo de integração, é possível utilizar um número de teste fornecido pela Meta para obter mais detalhes sobre o problema.

<Steps>
  <Step num={1} title="Selecione Nome de Exibição">
    Durante a criação da conta, selecione a opção <TextHighlight>Nome de Exibição</TextHighlight>. Um número de teste da Meta será gerado automaticamente (formato: +1 555…).
  </Step>

  <Step num={2} title="Clique em Gerenciar com a Meta">
    Clique em <TextHighlight>Gerenciar com a Meta</TextHighlight> e tente incluir o número desejado na plataforma.
  </Step>

  <Step num={3} title="Leia a mensagem de erro detalhada">
    Caso ocorra algum erro, a plataforma da Meta exibirá uma mensagem detalhada com o motivo da falha, facilitando a identificação e resolução do problema.

    <Callout type="tip" title="Guarde a mensagem de erro">
      Anote a mensagem de erro exibida pela Meta. Caso não consiga resolver, envie essa informação ao entrar em contato com o suporte para agilizar o atendimento.
    </Callout>
  </Step>
</Steps>

🔄 O GS Engage não está refletindo alterações feitas no Facebook [#-o-gs-engage-não-está-refletindo-alterações-feitas-no-facebook]

Esse problema pode ocorrer quando são realizadas alterações diretamente no Facebook, como mudança de número, atualização de nome de exibição ou outras configurações. As alterações feitas na plataforma da Meta nem sempre são sincronizadas automaticamente com o GS Engage.

<Steps>
  <Step num={1} title="Clique em Sincronizar">
    Dentro do GS Engage, acesse a seção de integração com o WhatsApp Business e clique no botão <TextHighlight>Sincronizar</TextHighlight> para forçar a atualização dos dados.
  </Step>

  <Step num={2} title="Reconecte a integração">
    Caso o problema persista após a sincronização, desconecte a integração com o Facebook e reconecte novamente para que as informações sejam atualizadas por completo.

    <Callout type="warning" title="Após reconectar, revise os templates">
      Ao desconectar e reconectar a integração, verifique se as configurações de templates e modelos de atividade associados estão funcionando corretamente após a reconexão.
    </Callout>
  </Step>
</Steps>

<SupportDiagnosticPackage
  context="WhatsApp Business — integração com a Meta"
  sourceArticle="WhatsApp Business — resolução de problemas"
  suggestedTests={[
  "Repetir a autorização em aba anônima",
  "Sincronizar números e templates",
  "Confirmar validação da empresa e do número na Meta",
  "Reconectar a integração e executar um teste controlado",
]}
  evidenceHints={[
  "Business Manager ID e WABA ID",
  "Número mascarado",
  "Nome, idioma e status do template",
  "Mensagem completa exibida pela Meta",
]}
/>

<RelatedArticles>
  <RelatedArticle href="/docs/integracoes/whatsapp" title="Integração WhatsApp Business" description="Como conectar o WhatsApp Business ao GS Engage e acessar os templates." />

  <RelatedArticle href="/docs/integracoes/api" title="Integração via API" description="Conecte o GS Engage a outras ferramentas usando a API." />

  <RelatedArticle href="/docs/integracoes/webhook" title="Integração via Webhook" description="Receba eventos do GS Engage em tempo real por webhook." />
</RelatedArticles>