# Conectar WhatsApp via QR Code

Conecte um número de WhatsApp ao AtendeBot lendo um QR Code com o celular, do mesmo jeito que você faz no WhatsApp Web. Ao final, as mensagens desse número chegam direto na sua caixa de **Atendimentos**.

## Objetivo
Ligar um número de WhatsApp ao AtendeBot pela leitura de um QR Code.

## Pré-requisitos
- Perfil **Administrador**.
- O celular com o WhatsApp que você vai conectar em mãos e com internet.
- Uma vaga de canal disponível conforme seu plano.

## Tempo estimado
5 minutos.

## Caminho de acesso
**Ajustes → Canais**

## Passo a passo
1. Abra **Ajustes → Canais**. No bloco **Adicionar canal**, no cartão **WhatsApp**, clique em **Adicionar**. O cartão mostra quantas vagas do plano já estão em uso (por exemplo, "1 de 3 em uso").

<figure><img src="https://docs.atende.bot/uploads/images/gallery/2026-10/canais-whatsapp-adicionar.png" alt="Tela Ajustes → Canais com o bloco Adicionar canal e o botão Adicionar do cartão WhatsApp em destaque"><figcaption>Tela Ajustes → Canais com o bloco Adicionar canal e o botão Adicionar do cartão WhatsApp em destaque</figcaption></figure>

2. Na janela **Novo WhatsApp**, digite em **Nome do canal** um nome para identificar esta conexão (ex.: `Atendimento Principal`) e clique em **Criar**. Esse nome aparece na lista de canais e no seletor de atendimento.
3. Na tela **Conectar ao WhatsApp**, escolha **QR Code**.

<figure><img src="https://docs.atende.bot/uploads/images/gallery/2026-10/canais-uazapi-opcoes.png" alt="Janela Conectar ao WhatsApp com as duas formas de conexão: QR Code e Código de Pareamento"><figcaption>Janela Conectar ao WhatsApp com as duas formas de conexão: QR Code e Código de Pareamento</figcaption></figure>

4. No celular, abra o **WhatsApp → Dispositivos conectados → Conectar dispositivo** e aponte a câmera para o QR Code na tela.

   Enquanto o celular não lê o código, a janela mostra **Aguardando leitura...** abaixo do QR Code.

5. Assim que o celular ler o código, abre a janela **[nome do canal] conectado**, em dois passos:
   - **Passo 1, Configurações:** escolha a **Equipe que recebe os atendimentos**, use **Definir como padrão** se esse for o número principal e ajuste o **Comportamento** (mostrar "digitando" e enviar confirmação de leitura). Cada opção salva no clique. Clique em **Continuar**.
   - **Passo 2, Grupos:** marque os grupos de WhatsApp que devem entrar no AtendeBot, se quiser atender algum. Veja [Atender grupos de WhatsApp](/books/atendimentos/page/atender-grupos-de-whatsapp). Clique em **Concluir**.

   Se preferir configurar depois, clique em **Deixar para depois**.

<p class="callout info">Sem o celular por perto para ler o QR Code? Na tela **Conectar ao WhatsApp**, escolha **Código de Pareamento**, informe o número com o código do país (ex.: `5511999999999`) e clique em **Gerar Código**. No celular, vá em **WhatsApp → Dispositivos conectados → Conectar dispositivo → Conectar com número** e digite o código que apareceu na tela. Pelo celular, a conexão já abre nessa opção, porque não dá para ler o QR Code na mesma tela.</p>

## Resultado esperado
O canal aparece em **Seus canais** com o nome que você deu, o status **Conectado** em verde, o número e a equipe que recebe os atendimentos. O canal padrão leva uma estrela ao lado do nome. Para mudar as opções depois, clique em **Configurar** na linha do canal.

## Erros comuns
- **Sintoma:** o QR Code não é lido ou expira. **Solução:** clique em **Gerar novo QR** e tente de novo com boa iluminação. Veja [QR Code não lê ou expira](/books/solucao-de-problemas/page/qr-code-nao-le-ou-expira).
- **Sintoma:** o botão **Adicionar** está desabilitado. **Solução:** pare o mouse sobre ele para ver o motivo: em geral, as vagas de canal do plano já estão em uso. A cota de WhatsApp vale para QR Code e Oficial juntos. Remova um canal que não usa mais ou amplie o plano. Veja [Quantos usuários e canais meu plano permite?](/books/perguntas-frequentes/page/quantos-usuarios-e-canais-meu-plano-permite).
- **Sintoma:** o cartão mostra **Não incluído no seu plano** e o botão **Ver planos**. **Solução:** esse canal não faz parte do seu plano. Veja <a href="/books/comece-por-aqui/page/entender-planos-modulos-e-o-que-esta-incluido">Planos e módulos</a>.
- **Sintoma:** conectou, mas depois ficou **Desconectado**. **Solução:** reconecte o número sem perder o histórico. Veja [Reconectar um canal que caiu ou trocar de número](/books/canais-e-integracoes/page/reconectar-um-canal-que-caiu-ou-trocar-de-numero).

## Artigos relacionados
- [Reconectar um canal que caiu ou trocar de número](/books/canais-e-integracoes/page/reconectar-um-canal-que-caiu-ou-trocar-de-numero)
- [Conectar WhatsApp Oficial (API da Meta)](/books/canais-e-integracoes/page/conectar-whatsapp-oficial-api-da-meta)
- [Definir a equipe padrão por canal](/books/equipes-usuarios-e-permissoes/page/definir-a-equipe-padrao-por-canal)
- [QR Code não lê ou expira](/books/solucao-de-problemas/page/qr-code-nao-le-ou-expira)