![Fluxo para conectar o WhatsApp Web: adicionar a caixa de entrada, escolher o provedor WhatsApp Web, informar nome e número, gerar o QR Code e escaneá-lo com o celular.](/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBbXNRIiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--2578b411d9715ab78eb0ac3dabe8bc0195fd4192/1724618803-como-configurar-um-canal-whats_app-usando-a-evolution-api.png)

O **WhatsApp Web** é a forma principal de conectar o seu número de WhatsApp ao Chatwoot para atender seus clientes. A conexão é feita escaneando um **QR Code** com o celular — sem precisar de credenciais do Meta Business. É rápido e funciona com o seu número atual.

Neste artigo você vai criar uma caixa de entrada de WhatsApp Web e deixá-la pronta para receber e responder mensagens.

## Antes de começar

- Tenha o **celular com o WhatsApp instalado e ativo** no número que você quer conectar, com acesso à internet.
- Anote o número no **formato internacional (E.164)**, com o código do país e DDD — por exemplo: **+5511999999999**.
- Você precisa de permissão de administrador para adicionar caixas de entrada.

## Passo a passo

1. No menu lateral, acesse **Configurações**.
2. Abra **Caixas de Entrada** e clique em **Adicionar caixa de entrada**.
3. Escolha o canal **WhatsApp**.
4. Em provedor, selecione **WhatsApp Web** — "Escaneie o QR Code para conectar diretamente".
5. Na tela **Conectar via WhatsApp Web**, preencha os campos:
   - **Nome da Caixa de Entrada** — informe um nome para identificar a caixa (por exemplo, "Atendimento Acme").
   - **Número de Telefone** — digite seu número do WhatsApp no formato internacional, ex.: **+5511999999999**.
6. Clique em **Gerar QR Code**.

## Escanear o QR Code

Com o QR Code gerado, a tela **Escaneie o QR Code** exibe as instruções em **Como escanear:**

1. **Abra o WhatsApp no seu celular**.
2. **Toque em Menu ou Configurações e selecione Aparelhos conectados**.
3. **Aponte a câmera do seu celular para esta tela para capturar o QR code**.

Enquanto a conexão é feita, aparece a mensagem "Aguardando você escanear o QR code...". Assim que o celular reconhecer o código, a caixa de entrada é conectada.

Se o QR Code expirar antes de você escanear, clique em **Atualizar QR Code** para gerar um novo.

## Opções adicionais

Na configuração do WhatsApp Web você encontra alguns ajustes opcionais (também disponíveis depois nas configurações da caixa de entrada):

- **Ignorar mensagens de grupos** — quando ativado, mensagens de grupos do WhatsApp não serão importadas.
- **Importar histórico de mensagens** — as mensagens existentes serão importadas ao conectar.
- **Incluir nome do agente nas mensagens** — adiciona o nome do agente em negrito no início de cada mensagem de texto enviada por essa caixa.

## Conectar depois

Se preferir, você pode usar a opção **Pular e Criar Caixa de Entrada** e escanear o QR Code em outro momento. Nesse caso, você pode conectar ao WhatsApp depois pela página de configurações da caixa de entrada.

## Número divergente

Ao escanear, o WhatsApp Web confere se o celular usado corresponde ao número informado no cadastro. Se você escanear com um número diferente, aparece o aviso **"Número de telefone divergente"**, informando o número esperado e o número que foi conectado. Nesse caso, escaneie novamente usando o celular com o **mesmo número** que você informou no campo **Número de Telefone**.

## Pronto!

Sua caixa de entrada de WhatsApp Web está conectada e já pode receber e responder mensagens dos seus clientes diretamente no Chatwoot.