> ## Documentation Index
> Fetch the complete documentation index at: https://help.goghl.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Configuração do WhatsApp

> Siga estes passos simples para conectar sua conta de WhatsApp ao seu CRM GoHighLevel através do GoGHL.ai e poder enviar e receber mensagens de WhatsApp diretamente dentro das suas conversas do CRM.

<Check>
  O GoGHL.ai vincula seu número real de WhatsApp ao seu CRM. Cada mensagem que você envia do CRM sai do seu próprio WhatsApp, e cada resposta é sincronizada diretamente de volta para suas conversas do CRM, sem números de terceiros, sem aprovação da API do WhatsApp Business.
</Check>

<Note>
  Já conectou o WhatsApp como um **provedor de SMS** personalizado? Faça a troca com a [Configuração Legada do WhatsApp](/pt-BR/whatsapp/sms-provider-setup).
</Note>

***

## Vídeo de Configuração Completa[​](#vídeo-de-configuração-completa "Link direto para o Vídeo de Configuração Completa")

<iframe className="w-full aspect-video rounded-xl" src="https://www.youtube.com/embed/J6GPSFy0MTY?modestbranding=1&rel=0" title="YouTube video player" frameBorder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" allowFullScreen />

***

## O Que Você Precisa Antes de Começar[​](#o-que-você-precisa-antes-de-começar "Link direto para O Que Você Precisa Antes de Começar")

* Uma conta no [GoGHL.ai](https://app.goghl.ai/login) (teste gratuito de 7 dias, sem cartão)
* Uma conta GoHighLevel com pelo menos uma subconta / localização
* O telefone com sua conta de WhatsApp ativa por perto, para escanear um código QR

***

## Parte 1: Conecte seu CRM e Instale o App do Marketplace[​](#parte-1-conecte-seu-crm-e-instale-o-app-do-marketplace "Link direto para a Parte 1: Conecte seu CRM e Instale o App do Marketplace")

Primeiro, conecte seu CRM e instale o aplicativo do marketplace para que o WhatsApp apareça como um canal na sua subconta.

<Steps>
  <Step title="Cadastre-se no GoGHL.ai">
    Acesse o [GoGHL.ai](https://app.goghl.ai/login) e crie uma conta usando sua conta do Google ou seu e-mail. Assim que fizer login, seu **teste gratuito** começa imediatamente (7 dias grátis, sem cartão).
  </Step>

  <Step title="Conecte sua Conta HighLevel">
    Vá para o seu painel e clique no botão **Conectar**, depois siga o onboarding para conectar suas subcontas.

    <Frame>
      <img src="https://mintcdn.com/goghl/JZJa2MoUHOf9Nw9w/images/sms/assets/images/Blur_Connect-your-Highlevel-with-GoGhl-8ad0dbbd9621f06792166328f0ac14d6.png?fit=max&auto=format&n=JZJa2MoUHOf9Nw9w&q=85&s=3d06564bb836312c806b5a2007c54f24" alt="Conecte sua conta HighLevel com o GoGHL.ai" width="2850" height="1590" data-path="images/sms/assets/images/Blur_Connect-your-Highlevel-with-GoGhl-8ad0dbbd9621f06792166328f0ac14d6.png" />
    </Frame>
  </Step>

  <Step title="Instale o App do Marketplace nas Subcontas">
    Instale o aplicativo do marketplace nas suas subcontas. Se você é um **usuário de agência**, escolha **Instalar em todas as localizações** e habilite a instalação automática para futuras localizações.

    <Check>
      Para uma configuração mais fácil, clique em **Selecionar Todas** para instalar em todas as subcontas de uma só vez.
    </Check>

    <Frame>
      <img src="https://mintcdn.com/goghl/JZJa2MoUHOf9Nw9w/images/sms/assets/images/sms-install-marketplace-app-f33cb17bc4015c05f516970ce500a7c2.png?fit=max&auto=format&n=JZJa2MoUHOf9Nw9w&q=85&s=cb21f82a8c69a2e7fa4d6b3e1799f0af" alt="Instale o aplicativo do marketplace em todas as localizações" width="2878" height="1550" data-path="images/sms/assets/images/sms-install-marketplace-app-f33cb17bc4015c05f516970ce500a7c2.png" />
    </Frame>
  </Step>

  <Step title="Escolha o Canal do WhatsApp">
    Quando for perguntado qual canal de mensagens configurar, escolha **WhatsApp**.

    <Frame>
      <img src="https://mintcdn.com/goghl/vzt4xop8mfhKGrG3/images/sms/assets/images/sms-pick-channel-89b87ce0a34b42bfe2d265ccf80ed658.png?fit=max&auto=format&n=vzt4xop8mfhKGrG3&q=85&s=60686292b89ee81b0ea625f26c170e29" alt="Escolha um canal de mensagens" width="2870" height="1516" data-path="images/sms/assets/images/sms-pick-channel-89b87ce0a34b42bfe2d265ccf80ed658.png" />
    </Frame>
  </Step>

  <Step title="Selecione a Subconta a Conectar">
    Escolha a localização que você deseja conectar. Você sempre pode conectar mais de uma depois.

    <Frame>
      <img src="https://mintcdn.com/goghl/JZJa2MoUHOf9Nw9w/images/sms/assets/images/Select-sub-account-fd1f5b43d552e571910ed14f64d47573.png?fit=max&auto=format&n=JZJa2MoUHOf9Nw9w&q=85&s=c5ef529939352843f67301ad83056599" alt="Selecionar subconta" width="2840" height="1512" data-path="images/sms/assets/images/Select-sub-account-fd1f5b43d552e571910ed14f64d47573.png" />
    </Frame>
  </Step>
</Steps>

***

## Parte 2: Conecte seu Número de WhatsApp[​](#parte-2-conecte-seu-número-de-whatsapp "Link direto para a Parte 2: Conecte seu Número de WhatsApp")

Com o aplicativo instalado, vincule seu número de WhatsApp escaneando um código QR, exatamente como no WhatsApp Web.

<Steps>
  <Step title="Abra a Tela de Conexão">
    Vá para a aba **Message hub** na sua subconta (ou abra o [painel do GoGHL.ai](https://app.goghl.ai/dashboard/)), depois clique em **Conectar** e aguarde o código QR aparecer.

    <Frame>
      <img src="https://mintcdn.com/goghl/JZJa2MoUHOf9Nw9w/images/getting-started/assets/images/goghl-connect-whatsapp-ac884b9a1adaff649811f18733ecc005.gif?s=51f32d84c740c32868f61a5439abd0e4" alt="GoGHL.ai conectar WhatsApp com código QR" width="1920" height="1031" data-path="images/getting-started/assets/images/goghl-connect-whatsapp-ac884b9a1adaff649811f18733ecc005.gif" />
    </Frame>
  </Step>

  <Step title="Escaneie o Código QR pelo seu Telefone">
    No telefone com sua conta de WhatsApp, abra:

    `WhatsApp → Configurações → Aparelhos Conectados → Conectar um Aparelho → Escanear QR`

    Aponte sua câmera para o código QR na tela.

    <Frame>
      <img src="https://mintcdn.com/goghl/JZJa2MoUHOf9Nw9w/images/getting-started/assets/images/ghl-onboarding-mobile-qr-5986cd8480b478ec9fa25a4024a9af2f.jpg?fit=max&auto=format&n=JZJa2MoUHOf9Nw9w&q=85&s=ef82ad5d8d2992ebaf02175f337c9c4a" alt="Escaneie o código QR pelo WhatsApp no seu telefone" width="3860" height="2171" data-path="images/getting-started/assets/images/ghl-onboarding-mobile-qr-5986cd8480b478ec9fa25a4024a9af2f.jpg" />
    </Frame>

    <Note>
      Estas são capturas de tela do iOS, o fluxo no Android pode variar um pouco. Não consegue escanear o código QR? Use [Entrar com número de telefone](/pt-BR/whatsapp/link-with-phone-number) em vez disso.
    </Note>
  </Step>

  <Step title="Aguarde a Confirmação">
    Aguarde alguns instantes. Você verá uma confirmação no seu console assim que o WhatsApp estiver conectado, seu número agora está pronto para uso.

    <Frame>
      <img src="https://mintcdn.com/goghl/JZJa2MoUHOf9Nw9w/images/getting-started/assets/images/goghl-wa-confirmation-36d58389a20eb4f439ca491330d978e2.png?fit=max&auto=format&n=JZJa2MoUHOf9Nw9w&q=85&s=4b78287c1b97dc0d141f88aa8d2b38f5" alt="Confirmação de WhatsApp conectado no GoGHL.ai" width="1920" height="1080" data-path="images/getting-started/assets/images/goghl-wa-confirmation-36d58389a20eb4f439ca491330d978e2.png" />
    </Frame>
  </Step>
</Steps>

***

## Parte 3: Envie uma Mensagem de Teste[​](#parte-3-envie-uma-mensagem-de-teste "Link direto para a Parte 3: Envie uma Mensagem de Teste")

Vamos confirmar que tudo funciona de ponta a ponta.

<Steps>
  <Step>
    Vá para **Contatos → selecione um contato → Enviar Mensagem**.
  </Step>

  <Step>
    Escolha **WhatsApp** no menu suspenso de tipo de mensagem.
  </Step>

  <Step>
    Digite uma mensagem de teste rápida e clique em **Enviar**.
  </Step>

  <Step>
    Confirme que a mensagem é **enviada com sucesso** e que a **resposta é recebida**, ambas devem aparecer nas suas Conversas do CRM.
  </Step>
</Steps>

<Frame>
  <img src="https://mintcdn.com/goghl/JZJa2MoUHOf9Nw9w/images/getting-started/assets/images/goghl-verify-setup-14e6c7703f5cafe21b344427fc3f4d5c.gif?s=211a031f1ed81aaeb5de623e7eeb397a" alt="Envie uma mensagem de teste no WhatsApp e verifique a configuração" width="1920" height="1038" data-path="images/getting-started/assets/images/goghl-verify-setup-14e6c7703f5cafe21b344427fc3f4d5c.gif" />
</Frame>

<Check>
  Parabéns, você concluiu a configuração! Seu número de WhatsApp agora está totalmente conectado ao seu CRM.
</Check>

***

## Seu Número Precisa de uma Chave de Acesso?[​](#seu-número-precisa-de-uma-chave-de-acesso "Link direto para Seu Número Precisa de uma Chave de Acesso?")

Alguns números agora exigem uma **chave de acesso** para vincular, então a leitura de QR habitual não os conecta. Se esse é o seu caso, siga os passos guiados no navegador.

<CardGroup cols={1}>
  <Card title="Conectar com uma chave de acesso" icon="key" href="/pt-BR/whatsapp/connect-with-passkey">
    Vincule números que exigem uma chave de acesso usando um script guiado no seu navegador quando a leitura do QR não conecta.
  </Card>
</CardGroup>

***

## Mantenha seu Número Seguro[​](#mantenha-seu-número-seguro "Link direto para Mantenha seu Número Seguro")

Os banimentos do WhatsApp são o motivo nº 1 pelo qual os números param de funcionar. Antes de começar a enviar mensagens em grande escala, configure a proteção:

<CardGroup cols={2}>
  <Card title="Estratégia de Aquecimento" icon="fire" href="/pt-BR/safety-and-protection/warmup-strategy">
    Aumente gradualmente o envio em um número novo para que o WhatsApp confie nele.
  </Card>

  <Card title="Drip Mode" icon="droplet" href="/pt-BR/safety-and-protection/drip-mode">
    Espaçe suas mensagens automaticamente para passar despercebido.
  </Card>

  <Card title="Proxy Residencial" icon="shield-halved" href="/pt-BR/safety-and-protection/residential-proxy">
    Encaminhe o tráfego por um IP compatível com sua localização para reduzir o risco de banimento.
  </Card>

  <Card title="Múltiplas Instâncias" icon="layer-group" href="/pt-BR/multiple-instances/overview">
    Distribua o volume entre vários números conectados por localização.
  </Card>
</CardGroup>

***

## Checklist Final[​](#checklist-final "Link direto para o Checklist Final")

Mantenha sua conexão de WhatsApp funcionando de forma confiável:

* O telefone com a conta de WhatsApp vinculada permanece **online** e carregado
* Você está seguindo as [diretrizes de segurança](/pt-BR/safety-and-protection/introduction) (aquecimento, drip mode)
* Apenas **uma** conta de WhatsApp está conectada por instância
* O aplicativo do marketplace está instalado na subconta da qual você envia mensagens
* O WhatsApp está selecionado como o **provedor de conversas** da localização

***

## Solução de Problemas[​](#solução-de-problemas "Link direto para a Solução de Problemas")

Se o WhatsApp não está conectando ou as mensagens não estão sendo enviadas, verifique isto em ordem:

| Sintoma                           | Solução                                                                                                                  |
| --------------------------------- | ------------------------------------------------------------------------------------------------------------------------ |
| O código QR não escaneia          | Atualize para obter um código novo, ou use [Entrar com número de telefone](/pt-BR/whatsapp/link-with-phone-number)       |
| Desconecta logo após vincular     | Mantenha o telefone online; confira as [Notificações de Desconexão](/pt-BR/whatsapp/disconnection-notifications)         |
| Mensagens não são enviadas        | Confirme que o WhatsApp é o provedor de conversas e que o app está instalado nessa subconta                              |
| O número foi banido / restringido | Revise [Banimentos e Restrições](/pt-BR/safety-and-protection/bans-and-restrictions) e habilite os recursos de segurança |
| Respostas não chegam ao CRM       | Verifique novamente a conexão no Message hub e reconecte se o status não for **Conectado**                               |

**Comece a enviar mensagens!** Seu número de WhatsApp agora é um canal totalmente conectado no seu CRM.

***

## Suporte[​](#suporte "Link direto para o Suporte")

Se você precisar de ajuda com a configuração ou o onboarding:

* Suporte via WhatsApp: [Conversar no WhatsApp](https://wa.me/+12267248710?text=Ol%C3%A1%2C%20preciso%20de%20ajuda%20com%20a%20Configura%C3%A7%C3%A3o%20do%20WhatsApp.)
* Email: [**support@goghl.ai**](mailto:support@goghl.ai)