# Conectar o WhatsApp Lite

Conecte o WhatsApp da sua operação ao PipeFácil por QR Code. Depois do pareamento, configure quem pode atender pelo canal.

Este guia é da modalidade **WhatsApp Lite**. Para conectar pela Meta, consulte [Conectar o WhatsApp](/integracoes/whatsapp/).

## Antes de começar

- Tenha acesso para gerenciar as integrações do workspace.
- Confira se o WhatsApp Lite está disponível e se há capacidade para outro canal no seu plano.
- Tenha em mãos o celular principal, com o WhatsApp do número que deseja conectar já funcionando.
- Mantenha o celular e o computador com acesso à internet. O celular precisa conseguir ler o QR Code exibido no computador.

As capturas abaixo usam dados de exemplo e acompanham o tema claro ou escuro da documentação. O QR Code das imagens é ilustrativo: use o código gerado no seu workspace.

## Crie uma instância Lite

Uma instância representa a conexão de um número com o CRM. O nome ajuda sua equipe a reconhecer esse canal.

1. No PipeFácil, acesse **Configurações** > **Integrações** e abra o card **WhatsApp Lite**. O card mostra **Conectar** quando ainda não há conexão ou **Gerenciar** quando já existe um canal.

   ![Integrações com o card WhatsApp Lite e a ação Conectar](integracoesLight.src)

2. Em **Instâncias Lite**, selecione **Nova instância**. Informe um **Nome da instância**, como `Time comercial`. Se aparecerem abas, mantenha **Nova instância** selecionada.

   ![Formulário Adicionar instância Lite com o nome Time comercial e o botão Criar instância](criarLight.src)

3. Selecione **Criar instância** e aguarde a tela **QR Code do canal**. Confira o nome do canal antes de parear o celular.

   ![QR Code do canal Time comercial com as ações Atualizar status e Novo QR](qrLight.src)

Criar a instância ainda não conecta o número. Conclua o pareamento no celular.

## Leia o QR Code pelo celular

1. No celular principal do número que deseja conectar, abra o WhatsApp e entre em **Dispositivos conectados**. Dependendo da versão do aplicativo, essa opção pode aparecer como **Aparelhos conectados**.

- **Android:** abra o menu de três pontos e selecione **Dispositivos conectados**.
- **iPhone:** abra **Configurações** e selecione **Dispositivos conectados**.

2. Toque em **Conectar dispositivo** ou **Conectar um aparelho**, conforme o texto do aplicativo. Se solicitado, confirme o desbloqueio do celular.

3. Com o leitor aberto no WhatsApp, aponte o celular para o QR Code exibido no PipeFácil. Aguarde a confirmação do pareamento sem fechar a tela do computador.

Use o leitor de **Dispositivos conectados**, em vez da câmera comum ou do QR Code do perfil. Consulte também as [instruções de conexão do WhatsApp](https://faq.whatsapp.com/1317564962315842/?cms_platform=android&lang=pt_br).

A tela renova o QR Code automaticamente enquanto aguarda o pareamento. Se ele ficar indisponível ou a leitura falhar, selecione **Novo QR** e leia o código atualizado.

## Confirme a conexão

Depois de parear, a tela mostra **Canal pronto para atendimento**. Se a confirmação não aparecer, selecione **Atualizar status**.

![Confirmação Canal pronto para atendimento após o pareamento do WhatsApp Lite](confirmacaoLight.src)

Feche a tela do QR Code e confira o número na lista de instâncias. O canal deve mostrar o selo **Conectado**. Verifique se o telefone corresponde ao número da sua operação.

![Instância Time comercial com número de exemplo, selo Conectado e ação Reconectar](conectadoLight.src)

Para validar o atendimento, envie uma mensagem de outro número para o número conectado. Em **Conversas**, confira o recebimento e responda pelo canal Lite. Confirme a entrega no outro celular.

## Configure o canal para sua equipe

No menu de ações da instância, abra a configuração que deseja ajustar:

| Opção                     | Para que serve                                                             |
| ------------------------- | -------------------------------------------------------------------------- |
| **Funil de entrada**      | Escolhe o funil e a etapa para a entrada dos leads do canal.               |
| **Distribuição de leads** | Define se a atribuição segue o funil ou os membros com acesso para enviar. |
| **Acesso dos membros**    | Define quem pode acompanhar as conversas e quem pode enviar mensagens.     |
| **Renomear**              | Altera o nome usado para identificar o canal no CRM.                       |

![Menu da instância Lite com funil de entrada, distribuição de leads e acesso dos membros](menuLight.src)

Consulte [Configurar um canal](/integracoes/canais/) para entender o roteamento e os níveis de acesso. Uma lista de acessos individuais vazia deixa o canal disponível ao workspace; ela não bloqueia todos os membros.

## Reconecte uma instância existente

Use a instância já cadastrada quando precisar refazer o pareamento do mesmo canal.

1. Em **Configurações** > **Integrações**, abra **WhatsApp Lite** e localize a instância pelo nome e número.

2. Selecione **Abrir QR** quando o canal estiver desconectado. Se a ação disponível for **Reconectar**, use-a para preparar um novo pareamento.

3. No celular, repita a leitura em **Dispositivos conectados**. Aguarde **Canal pronto para atendimento** e confira o selo **Conectado** na lista.

4. Faça um novo teste de recebimento e resposta em **Conversas**.

No menu da instância, **Desconectar** encerra a sessão e permite reconectar depois. **Excluir** remove o canal da operação. Não exclua a instância como tentativa de atualizar o QR Code.

## Conecte uma conta própria da Z-API

Este caminho só aparece quando o provedor configurado no workspace permite usar uma instância própria. Se a aba **Minha conta Z-API** não existir, siga a criação de uma nova instância descrita neste guia.

1. Em **Nova instância**, abra a aba **Minha conta Z-API**.

2. Informe o **Nome da instância**, o **ID da instância**, o **Token da instância** e o **Client-Token**. Obtenha esses dados no painel da sua conta Z-API.

   ![Aba Minha conta Z-API com campos de identificação e credenciais da instância, sem dados preenchidos](contaLight.src)

3. Selecione **Conectar conta**. O PipeFácil configura os webhooks da instância automaticamente.

4. Se o número ainda precisar de pareamento, leia o QR Code pelo celular. Depois, confira o status e teste o atendimento.

Essas credenciais são da Z-API, não da API pública do PipeFácil. Não compartilhe tokens em capturas de tela ou mensagens de suporte.

## Resolva as dificuldades mais comuns

| Situação                                                  | O que conferir                                                                                   |
| --------------------------------------------------------- | ------------------------------------------------------------------------------------------------ |
| **QR Code indisponível**                                  | Selecione **Novo QR** e aguarde a nova imagem antes de ler.                                      |
| O celular não aceita o QR Code                            | Use o leitor de **Dispositivos conectados** no celular principal e leia o código atual.          |
| A leitura terminou, mas o status não mudou                | Selecione **Atualizar status** e confira se o aplicativo concluiu a conexão.                     |
| O canal está conectado, mas um membro não vê as mensagens | Confira **Acesso dos membros**, as permissões e os filtros de Conversas.                         |
| Mensagens antigas não aparecem                            | Teste uma mensagem nova. Pareamento não garante a importação completa do histórico anterior.     |
| A criação de uma instância falha                          | Confira a mensagem exibida e a disponibilidade de canais no workspace antes de tentar novamente. |

Se o problema continuar, consulte [Diagnosticar problemas no WhatsApp](/integracoes/solucionar-problemas-whatsapp/). Ao pedir ajuda, informe o nome do canal, o horário da tentativa e o erro exibido, sem incluir tokens ou um QR Code de conexão ativo.