Como conectar o WhatsApp Business API ao GoHighLevel

Integrar o WhatsApp Business API ao GoHighLevel permite centralizar conversas, automatizar respostas e gerenciar contatos diretamente dentro da plataforma. Este guia explica o processo de forma técnica e objetiva, incluindo pré-requisitos, passo a passo de configuração e os erros mais comuns que você pode encontrar.

Pré-requisitos antes de começar

Antes de iniciar qualquer configuração dentro do GoHighLevel, você precisa garantir que os seguintes itens estão em ordem:

• Conta no Meta Business Manager verificada e ativa. Sem a verificação do negócio concluída, a Meta não libera acesso à API.
• Número de telefone exclusivo para o WhatsApp Business API. Esse número não pode estar associado a um aplicativo WhatsApp comum ou ao WhatsApp Business App. Se já estiver, será necessário desvinculá-lo antes.
• Acesso a um plano do GoHighLevel que suporte integrações de WhatsApp. A disponibilidade do recurso pode variar conforme o plano contratado — verifique com o suporte ou na documentação oficial da HighLevel.
• Permissões de administrador na subconta (sub-account) onde a integração será realizada.

Um ponto importante: o GoHighLevel utiliza o LeadConnector como provedor intermediário para a conexão com a API oficial do WhatsApp (via Meta). Você não está se conectando diretamente à API da Meta — o tráfego passa pelo ecossistema da HighLevel. Considere isso na sua avaliação de conformidade e privacidade de dados.

Passo a passo: conectando o WhatsApp Business API

1. Acesse a subconta correta no GoHighLevel. Integrações de WhatsApp são configuradas no nível de subconta, não na agência.
2. No menu lateral, clique em Settings (Configurações).
3. Role até a seção Integrations (Integrações) e localize a opção WhatsApp.
4. Clique em Connect (Conectar). Uma janela pop-up do Meta será aberta para autenticação.
5. Faça login com a conta do Facebook/Meta vinculada ao seu Business Manager.
6. Siga o fluxo guiado pelo Meta: selecione o Business Manager, crie ou selecione uma conta do WhatsApp Business (WABA) e adicione o número de telefone que será usado.
7. Durante esse processo, você precisará verificar o número por código SMS ou chamada de voz. Certifique-se de ter acesso ao número naquele momento.
8. Após a verificação, o Meta solicitará que você revise e aceite os termos de uso do WhatsApp Business.
9. Concluído o fluxo do Meta, você será redirecionado de volta ao GoHighLevel. Se tudo correu bem, o número aparecerá como Connected (Conectado) na tela de integrações.
10. Configure o nome de exibição (display name) do perfil do WhatsApp, que precisará passar por aprovação da Meta antes de ser exibido aos contatos.

Configurando o número como canal de conversas

Após a conexão, o número precisa ser habilitado como canal ativo:

1. Vá em Settings > Phone Numbers (ou Messaging, dependendo da versão da interface).
2. Localize o número de WhatsApp recém-conectado.
3. Ative-o para receber e enviar mensagens dentro do módulo Conversations (Conversas).
4. Teste enviando uma mensagem de um número externo para confirmar que ela aparece na caixa de entrada da subconta.

Configurando templates de mensagem (HSM)

O WhatsApp Business API exige o uso de templates aprovados (chamados de HSM — Highly Structured Messages) para iniciar conversas com contatos que não entraram em contato nas últimas 24 horas. Para criar e submeter templates:

1. Acesse Settings > WhatsApp dentro da subconta.
2. Clique em Message Templates (Modelos de Mensagem).
3. Crie um novo template, definindo categoria (Marketing, Utilidade ou Autenticação), idioma e corpo da mensagem.
4. Submeta para aprovação da Meta. O tempo de aprovação varia — geralmente entre alguns minutos e 24 horas, mas pode levar mais tempo em casos de revisão manual.

Templates rejeitados precisam ser revisados conforme as políticas de mensagens do WhatsApp. O GoHighLevel não tem controle sobre o processo de aprovação da Meta.

Limitações e cenários em que essa integração pode não ser ideal

A integração funciona bem para equipes que já utilizam o GoHighLevel como CRM central e querem consolidar o atendimento via WhatsApp em um único lugar. No entanto, há situações em que pode não ser a melhor escolha:

• Alto volume de mensagens com automações complexas: ferramentas dedicadas como Wati, Respond.io ou Trengo oferecem controle mais granular sobre fluxos de WhatsApp e podem ser mais adequadas.
• Negócios que precisam de múltiplos agentes com filas e SLA detalhados: plataformas de help desk especializadas têm funcionalidades mais robustas para isso.
• Orçamento limitado: o custo das conversas é cobrado diretamente pela Meta (por sessão), e o GoHighLevel pode adicionar custos próprios dependendo do plano. Avalie a estrutura de preços antes de escalar.
• Operações fora do Brasil com regulações de dados específicas (como GDPR na Europa): verifique onde os dados são armazenados e processados antes de adotar a integração.

Erros comuns e troubleshooting

Erro: "Phone number already registered" O número já está associado a outro aplicativo WhatsApp. Você precisa deletar a conta WhatsApp desse número antes de prosseguir. Isso é feito diretamente no aplicativo ou via painel do Meta Business Manager.

Erro: O pop-up do Meta não abre ou trava Desative bloqueadores de pop-up no navegador e tente em modo anônimo. O Chrome costuma ter melhor compatibilidade com o fluxo de autenticação do Meta.

Mensagens enviadas não chegam ao destinatário Verifique se o template utilizado foi aprovado pela Meta. Mensagens fora da janela de 24 horas que não usam templates aprovados são bloqueadas automaticamente.

O número aparece como conectado, mas não recebe mensagens Confira se o número está ativo como canal em Settings > Phone Numbers e se não há filtros de roteamento bloqueando as mensagens recebidas nos Workflows da subconta.

Conta do WhatsApp Business suspensa pela Meta Isso pode ocorrer por violações das políticas de mensagens (ex.: envio de spam ou mensagens não solicitadas). A resolução é feita diretamente com a Meta via Central de Ajuda do Business Manager — o GoHighLevel não pode intervir nesse processo.

Display name pendente de aprovação há mais de 48 horas Entre no Meta Business Manager, acesse WhatsApp Manager > Account Tools > Profile e verifique o status. Em alguns casos, é necessário abrir um ticket diretamente com o suporte da Meta.

---

A integração entre WhatsApp Business API e GoHighLevel é funcional e cobre bem os casos de uso de CRM com mensageria, mas depende de variáveis externas — principalmente a aprovação e as políticas da Meta — que estão fora do controle da plataforma. Planeje a implantação com tempo suficiente para a verificação do Business Manager e a aprovação dos templates antes de colocar fluxos em produção.