# Conectar um número de WhatsApp no Bot do Afiliado: QR code, código de pareamento e grupos

> Como parear o número por QR code ou código de pareamento, ler o cartão do número na aba Números, escolher a função dele e acompanhar a conexão.

- URL: https://botdoafiliado.com/docs/whatsapp/conectar-whatsapp/
- Publicado em: 2026-09-08
- Atualizado em: 2026-10-24
- Índice da documentação para IA: https://botdoafiliado.com/llms.txt

Na aba **Números** da tela **WhatsApp**, cada número é um WhatsApp pareado como aparelho conectado: você o conecta por QR code ou por código de pareamento, e os grupos e canais dele aparecem sozinhos no painel.

## Como o número entra

O WhatsApp entra como **aparelho vinculado**, o mesmo mecanismo do WhatsApp Web. Não é número de terceiro, não é conta clonada, e o seu celular continua sendo o dono da conta.

O nome que você informa ao adicionar o número permanece como identificação principal no painel. Depois de conectar, o nome do perfil do WhatsApp (**Perfil:**) e o telefone pareado aparecem abaixo, sem substituir o que você cadastrou. Em conta comercial, o nome da empresa também aparece quando é diferente do nome do perfil. Para trocar o nome (dono ou admin), clique nele no cartão, edite e use **Salvar** (ou Enter); **Cancelar** (ou Esc) desiste.

> **Use um número dedicado à operação**, não o seu pessoal. Qualquer número que publica muito acaba recebendo denúncia de alguém, e você não quer que isso alcance o número que usa com a família.

## Adicionar o número

1. Em **WhatsApp**, clique em **Adicionar número** (no topo da tela ou na aba **Números**).
2. Dê um **Nome** para identificar o número e clique em **Criar e conectar**.
3. Na janela **Conectar**, escolha **Ler QR code** ou **Código de pareamento**.

Com o limite contratado atingido, o botão fica desligado e o topo mostra quantos números estão em uso, com o atalho **aumentar** para Assinaturas.

### Caminho 1: QR code

1. Escolha **Ler QR code** e clique em **Gerar QR code**.
2. No celular: **WhatsApp → Aparelhos conectados → Conectar um aparelho**.
3. Aponte a câmera para o QR na tela.

Depois da leitura, a janela mostra **QR code lido**: pode fechar, com **Continuar usando o painel**. A conexão continua e o painel avisa quando terminar. Se o pareamento terminar ou falhar, use **Trocar método ou gerar novamente**.

### Caminho 2: código de pareamento

Serve quando você está só no celular, sem segunda tela.

1. Escolha **Código de pareamento**, preencha **Número com DDI e DDD** (ex.: 5511999998888) e clique em **Pedir código**.
2. O painel mostra o código, com **Copiar código**.
3. No celular: **Aparelhos conectados → Conectar um aparelho → Conectar com número de telefone** e digite o código.

Mantenha a janela aberta até a confirmação. O código é de vinculação do aparelho; não é um SMS de acesso ao Bot do Afiliado.

### Depois de conectar

Assim que o número conecta, o painel busca os grupos e canais dele. Se a busca falhar, a tela preserva a lista anterior e oferece **Atualizar grupos e canais**. Importar a lista não faz nenhum grupo receber ofertas: os grupos que recebem são escolhidos na campanha ([Criar campanhas](/docs/whatsapp/criar-campanha/)).

Se o WhatsApp lido já era de um cartão seu que estava fora do ar, ele volta a conectar naquele cartão, com os grupos, o aquecimento e o histórico que já tinha, e o cartão novo sai da lista. A janela mostra **Número reconectado** e pergunta se você quer mudar o nome.

O acompanhamento de entradas, saídas e saúde dos grupos começa quando o grupo está numa campanha da sua organização. O histórico já registrado é preservado.

## O cartão do número

Cada cartão da aba **Números** mostra, na coluna da esquerda:

- a **Saúde**, uma nota de 0 a 100 com a faixa **boa**, **regular**, **atenção** ou **frágil**, e embaixo as dicas do que ajustar (**Mais dicas** ou **Sobre a nota**);
- o estado da conexão: **Conectado**, **Conectando** (aguardando o celular), **Pausado** (pela assinatura), **Desconectado** ou **Fora do ar**;
- o selo do aquecimento, quando há um.

Ao lado ficam o nome, o perfil, o telefone, quantos grupos o número tem e as ações:

- **Função** (dono e admin escolhem): **Envia ofertas** (o padrão), **Cria grupos e envia ofertas**, **Só cria grupos** ou **Segurança: só admin**. Os números que só criam e os de segurança ficam fora da fila de ofertas. Com algum número que cria grupos na organização, a criação automática fica com eles. O de segurança nunca cria grupos.
- **Atualizar grupos e canais**, no número conectado.
- **Aquecer** ou **Ver aquecimento** ([aquecimento](/docs/whatsapp/aquecimento/)).
- **Conectar**, **Reconectar** ou **Ver QR code**, no número que não está conectado.
- **Desconectar**, no menu **⋯** do cartão.

Use a busca por nome ou telefone e o filtro **Todos os números**, **Só conectados**, **Só caídos** ou **Só pausados**.

## Ritmo de envio

O ritmo dos envios é configurado na campanha, em **Campanhas → Fontes e ritmo** ([Criar campanhas](/docs/whatsapp/criar-campanha/)). Cada campanha mantém o seu intervalo, que vale por número. A aba Números cuida da conexão.

Quando mais de um número está ligado no mesmo grupo, a fila divide os envios entre eles. A fila continua espaçando as operações do mesmo número, e isso pode fazer o envio esperar além do intervalo da campanha.

## Quando a sessão cai

Aparelho vinculado não é eterno. A sessão cai quando você remove o aparelho no celular, o celular fica muito tempo desligado ou sem internet, você reinstala o WhatsApp, ou o próprio WhatsApp derruba.

O que acontece:

- o painel mostra no topo a faixa **Número "…" desconectado desde…**, com o botão **Reconectar** quando você está em outra tela;
- o cartão mostra **Fora do ar** e a frase **O Bot não envia por este número até reconectar.**;
- **os outros números** ligados naquele grupo assumem os envios; o repasse não pausa;
- se não sobrar nenhum número conectado no grupo, o envio **falha** e aparece em **Envios → Últimos envios** com o motivo;
- o aviso **Número desconectado** chega pelos canais escolhidos em [Notificações](/docs/whatsapp/incidentes-e-alertas/), e o **Número reconectado** quando ele volta.

Para reconectar, use **Reconectar** no cartão: é o mesmo fluxo de QR code ou código. Grupos, fontes e campanhas continuam como estavam.

## Sobre risco de bloqueio

**Não existe garantia de que um número nunca será bloqueado**, e quem promete isso está mentindo. O que reduz o risco de verdade:

- **número dedicado**, aquecido aos poucos;
- **envio espaçado**: configure o ritmo da campanha; a fila também respeita os limites operacionais do número;
- **gente que entrou porque quis** (link clicado), não número adicionado sem pedir;
- **filtro apertado**: menos volume e mais relevância.

Se quiser risco mínimo, use um **canal do WhatsApp** como destino: é broadcast, ninguém entra, ninguém responde.

## Reduzir quantidade ou trocar os números ativos

A aba **Números** mostra quantos números estão liberados, quantos foram contratados e quantos estão cadastrados. Ao reduzir a quantidade em **Assinaturas**, os números excedentes ficam **Pausados** pela assinatura. Sem uma escolha anterior, o Bot mantém os mais antigos dentro da quantidade paga. As instâncias e sessões são preservadas; a pausa não desconecta o aparelho e não apaga grupos ou configurações.

Em **Números a manter ativos**, o dono ou administrador pode desmarcar um número e marcar outro. Selecione a quantidade indicada e use **Salvar números ativos**. Essa troca não muda a cobrança. Se a quantidade ou a seleção mudar em outra aba enquanto você escolhe, use **Atualizar lista** e tente novamente.

Sem o módulo ativo, todos ficam pausados. Ao reativar ou aumentar a quantidade, o Bot preserva a escolha anterior e preenche as vagas com os mais antigos restantes. A conexão precisa continuar válida para o número operar. Envios que falharam durante a pausa não são reenviados automaticamente; confira **Últimos envios** antes de reenviar.

## Desconectar um número

No cartão, abra o menu **⋯** e use **Desconectar**. O número sai do WhatsApp Web e da lista, e os grupos dele param de receber ofertas até você conectar outro número neles. Isso libera a vaga. A quantidade contratada muda em Assinaturas ([preço e limites](/docs/whatsapp/planos-e-limites/)).

## Perguntas frequentes

### O número precisa ficar com o celular ligado?

O pareamento é o de aparelho vinculado, como o WhatsApp Web. O celular precisa continuar com a conta ativa; se ele ficar muito tempo desligado ou sem internet, a sessão pode cair.

### Posso conectar mais de um número?

Sim. Você contrata de 1 a 20 números por R$ 49,90 por número ao mês. Os números liberados podem dividir os envios nos mesmos grupos; os pausados não aumentam a quantidade contratada.

### O que acontece quando um número cai?

Os outros números ligados naquele grupo assumem os envios. O aviso de número desconectado e de número reconectado chega pelos canais escolhidos em Notificações.

### Quem pode conectar e mudar a função de um número?

O dono ou administrador da organização. O membro vê os cartões, sem editar.
