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

# Conexão Líderhub

> Passo a passo para conectar seu WhatsApp à LíderHub via QR Code ou código digital

## Visão geral

A LíderHub funciona conectando seu número de WhatsApp à plataforma. Todas as mensagens recebidas e enviadas passam a ser gerenciadas pelo sistema, permitindo que agentes de IA respondam automaticamente.

## Como conectar

<Steps>
  <Step title="Acesse Conexões e clique em Nova Conexão">
    Na barra lateral esquerda, clique em **[Conexões](https://chat.liderhub.ai/connections)**.

    <Frame>
      <img src="https://mintcdn.com/liderhub/mMi6av5hQKUNG_BI/images/sidebar-conexoes.png?fit=max&auto=format&n=mMi6av5hQKUNG_BI&q=85&s=e7d7d0b2324227820180cc14bf0370fe" alt="Barra lateral da LíderHub com Conexões destacado" width="1024" height="610" data-path="images/sidebar-conexoes.png" />
    </Frame>
  </Step>

  <Step title="Escolha entre API Oficial ou Não Oficial">
    <Frame>
      <img src="https://mintcdn.com/liderhub/mMi6av5hQKUNG_BI/images/api-oficial-vs-nao-oficial.png?fit=max&auto=format&n=mMi6av5hQKUNG_BI&q=85&s=de1715bd7717b8750fa3450547835817" alt="Escolha entre API Oficial e Não Oficial na LíderHub" width="1828" height="552" data-path="images/api-oficial-vs-nao-oficial.png" />
    </Frame>

    Veja mais detalhes sobre as diferenças em <Tooltip headline="API Oficial vs Não Oficial" tip="Comparativo completo entre as duas formas de conexão: custo, estabilidade, risco e funcionalidades." cta="Ver mais" href="/whatsapp/api-oficial-vs-nao-oficial">API Oficial vs Não Oficial</Tooltip>.

    Você pode conectar **WhatsApp Business** ou **WhatsApp normal**. Na API Oficial, apenas WhatsApp Business.
  </Step>

  <Step title="Conecte seu WhatsApp">
    <Tabs>
      <Tab title="API Não Oficial">
        Assim como no WhatsApp Web, você pode conectar de duas formas na API Não Oficial:

        <AccordionGroup>
          <Accordion title="Conecte via QR Code">
            1. Clique em **Gerar QR Code**
            2. Abra o WhatsApp no celular
            3. Vá em **Configurações → Aparelhos conectados**
            4. Clique em **Conectar dispositivo**
            5. Aponte a câmera para o QR Code e aguarde a conexão

            <Frame>
              <img src="https://mintcdn.com/liderhub/mMi6av5hQKUNG_BI/images/conexao-qrcode.png?fit=max&auto=format&n=mMi6av5hQKUNG_BI&q=85&s=611067d52974ff4ba0134dbfddba7e1e" alt="Tela de conexão via QR Code na LíderHub" width="1024" height="1009" data-path="images/conexao-qrcode.png" />
            </Frame>
          </Accordion>

          <Accordion title="ou Conecte via Código">
            1. Clique em **Tentar com Código**
            2. Digite o número do WhatsApp
            3. Clique em **Gerar Código**
            4. Abra o WhatsApp no celular
            5. Vá em **Configurações → Aparelhos conectados**
            6. Clique em **Conectar com número de telefone** e digite o código gerado

            <Frame>
              <img src="https://mintcdn.com/liderhub/mMi6av5hQKUNG_BI/images/conexao-codigo.png?fit=max&auto=format&n=mMi6av5hQKUNG_BI&q=85&s=c695a4966b1f62f67b2518b8700bd339" alt="Tela de conexão via código digital na LíderHub" width="1024" height="996" data-path="images/conexao-codigo.png" />
            </Frame>
          </Accordion>
        </AccordionGroup>
      </Tab>

      <Tab title="API Oficial">
        Siga o fluxo de configuração da API Oficial do WhatsApp Business. Veja o passo a passo completo em <Tooltip headline="API Oficial" tip="Como conectar e configurar a API Oficial do WhatsApp na LíderHub." cta="Ver mais" href="/whatsapp/api-oficial">Meta, e API Oficial</Tooltip>.
      </Tab>
    </Tabs>
  </Step>

  <Step title="Conexão confirmada">
    Quando conectar, o status mudará automaticamente. Você já pode receber e enviar mensagens pela LíderHub.
  </Step>
</Steps>

## Suspeita de golpe

Ao reconectar seu WhatsApp à LíderHub, o próprio WhatsApp pode exibir um aviso de **Suspeita de golpe** informando que um dispositivo em **São Paulo, SP, Brasil** terá acesso à sua conta.

<Frame>
  <img src="https://mintcdn.com/liderhub/KVOhQxMKRTZgCEJU/images/suspeita-de-golpe.png?fit=max&auto=format&n=KVOhQxMKRTZgCEJU&q=85&s=850047075af9ce1cf9a3fe18aec6d292" alt="Aviso de Suspeita de golpe do WhatsApp mostrando dispositivo em São Paulo, SP, Brasil" width="676" height="913" data-path="images/suspeita-de-golpe.png" />
</Frame>

<Info>
  Se a localização exibida for **São Paulo, SP, Brasil**, pode autorizar normalmente. Nosso banco de dados está sediado em São Paulo, e é por isso que a conexão aparece a partir dessa localização.
</Info>

Toque em **Conectar dispositivo** para autorizar. Assim que permitir, a conexão com a LíderHub será concluída normalmente.

## Configurações da conexão

Após conectar, clique na conexão para configurar. Estas configurações **padrão** são aplicadas automaticamente em **todas as conversas** iniciadas nesta conexão:

<Frame>
  <img src="https://mintcdn.com/liderhub/mMi6av5hQKUNG_BI/images/config-conexao.png?fit=max&auto=format&n=mMi6av5hQKUNG_BI&q=85&s=f8b1533a647fb8e4124262d5883cf44a" alt="Configurações da conexão na LíderHub" width="1850" height="893" data-path="images/config-conexao.png" />
</Frame>

* **Status padrão**: sempre que uma conversa for iniciada neste WhatsApp, será atribuído esse status automaticamente.
  * Especialmente útil para WhatsApp específico do departamento comercial. Sugerimos que você coloque o status <Badge color="gray">Nova conversa</Badge>. Veja mais em <Tooltip headline="Estratégias e Boas Práticas" tip="Por que separar comercial e pós-venda, múltiplos números por produto e proteção do pós-venda." cta="Ver mais" href="/whatsapp/estrategias-boas-praticas">Estratégias e Boas Práticas</Tooltip>.
* **Departamento padrão**: para qual departamento as conversas vão
* **Responsável padrão**: qual agente de IA ou humano é responsável pela conversa. Se for uma IA, ela deverá responder automaticamente.

## Sincronização de mensagens

Sempre que o WhatsApp é conectado, buscamos o histórico das mensagens dos **últimos 2 dias** automaticamente.

<Tabs>
  <Tab title="API Não Oficial">
    A sincronização dos últimos 2 dias acontece automaticamente a cada reconexão.

    <Info>
      Se houver alguma instabilidade durante algumas horas, as mensagens também são recuperadas depois que voltar ao normal. Nenhuma mensagem será perdida se houver desconexão de até 2 dias.
    </Info>
  </Tab>

  <Tab title="API Oficial">
    Na API Oficial, é possível sincronizar até **6 meses** de histórico, mas apenas via <Tooltip headline="API Oficial" tip="Como conectar e configurar a API Oficial do WhatsApp na LíderHub, incluindo coexistência." cta="Ver mais" href="/whatsapp/api-oficial">coexistência</Tooltip>, e somente quando o WhatsApp é conectado pela **primeira vez**.
  </Tab>
</Tabs>

## Logs de desconexão

A LíderHub registra automaticamente todas as desconexões. Acesse o histórico de logs da conexão para identificar quando e por que o número desconectou.

<Frame>
  <img src="https://mintcdn.com/liderhub/mMi6av5hQKUNG_BI/images/logs-conexao.png?fit=max&auto=format&n=mMi6av5hQKUNG_BI&q=85&s=2f6bbf9c11811129d526debbee6c32cf" alt="Logs de conexão e desconexão na LíderHub" width="1792" height="873" data-path="images/logs-conexao.png" />
</Frame>

<Tooltip headline="Permissões" tip="Como gerenciar permissões de membros, roles e acessos por departamento na LíderHub." cta="Ver mais" href="/workspace/permissoes">Administradores</Tooltip> do workspace são notificados se o WhatsApp for desconectado.

## Deixe uma sugestão

<Accordion title="Feedback de Melhorias sobre Conexão Líderhub">
  Agradecemos muito pelo seu tempo! Se você precisa de suporte, acesse [Obtenha suporte](/suporte/obtenha-suporte).

  <iframe src="https://tally.so/embed/682q2k?feature=Conex%C3%A3o%20L%C3%ADderhub&alignLeft=1&hideTitle=1&transparentBackground=1" width="100%" height="350" frameBorder="0" title="Enviar feedback de melhorias" />
</Accordion>

## Dúvidas Frequentes

<AccordionGroup>
  <Accordion title="Conversas não aparecem">
    Após conectar, somente novas mensagens são recebidas. Mensagens anteriores à conexão não são importadas (exceto via coexistência com API Oficial).
  </Accordion>

  <Accordion title="Posso usar o mesmo número no WhatsApp Web e na LíderHub?">
    Com a API Não Oficial, não. O número só pode estar conectado a um dispositivo por vez. Com a API Oficial, é possível.
  </Accordion>

  <Accordion title="Se o celular ficar sem internet ou bateria?">
    | Cenário                          | O que acontece                                                                                                                                 |
    | -------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- |
    | **API Não Oficial**              | Não tem problema de imediato! Mas manter o celular ligado, com WhatsApp atualizado e conectado à internet ajuda na sincronização de mensagens  |
    | **API Oficial sem coexistência** | Não se aplica! API Oficial sem coexistência não tem telefone nem conexão à internet — o WhatsApp é direto via Cloud API da Meta                |
    | **API Oficial com coexistência** | Não tem problema! O celular pode estar desconectado da internet, desligado... Vai funcionar normalmente, desde que esteja conectado à LíderHub |
  </Accordion>
</AccordionGroup>