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

# Como conectar o WhatsApp por QR code

> Leia o código QR com o celular da empresa, ou mande um link de conexão para quem está com o aparelho.

## Para que serve

Ligar o número de WhatsApp da empresa ao STChat. Depois disso, as conversas chegam em Conversas e a equipe responde pelo sistema.

A conexão é parecida com a do WhatsApp Web: você lê um código QR com o celular da empresa.

## Quem pode

Dono e Admin da organização conectam. Os outros papéis veem o aviso "Só o Dono ou um gerente pode conectar. Avise quem cuida da conta."

Quem atribui o número (a "caixa") à organização é a agência. Se aparecer "Falta um número livre para conectar", peça à agência para liberar um.

## Onde clicar

* Em **Conversas**, se a organização ainda não tem nenhuma instância vinculada pela agência, a tela mostra "Nenhum canal liberado ainda" e **não mostra QR**. O QR só aparece depois que a agência vincula uma vaga à organização.
* Em **Ajustes › Canais**, o botão **Conectar canal** abre a escolha do canal: "Escolha o canal. O WhatsApp pede o número; os outros abrem o painel do canal, onde a agência conecta a conta."
* Em **Ajustes › Canais**, na linha do WhatsApp, use **Conectar** (ou **Reconectar**, se já esteve conectado).

## Passo a passo

**1. Abra o WhatsApp no celular da empresa**

Toque em ⋮ › **Aparelhos conectados** › **Conectar um aparelho**.

**2. Aponte a câmera para o código**

O código muda a cada 20 segundos. Se ele vencer, aparece "O código venceu": toque em **Gerar novo código**. Também dá para usar **Atualizar código**.

**3. Espere terminar**

Aparece "Conectando…" e "Código lido". Deixe o WhatsApp aberto no celular até terminar.

### O celular não está com você?

**1. Peça o link**

Clique em **O celular não está aqui? Mandar o link para ele**.

**2. Informe o WhatsApp do celular da empresa**

Preencha o campo **WhatsApp do celular da empresa** e clique em **Mandar link**.

**3. Quem está com o celular abre o link**

A pessoa toca em Conectar e pronto. Não precisa entrar no sistema nem ter senha.

O link vai pelo WhatsApp da agência, vale 15 minutos e só funciona uma vez. Ele abre uma página pública (`/conectar/...`) com o QR e os passos. No celular, a página também oferece um código para digitar, em **Conectar com número de telefone**.

## O que acontece depois

Aparece "Pronto! WhatsApp conectado". As conversas novas chegam em Conversas, e as últimas dos 7 dias são trazidas. No fluxo da primeira vez, o botão **Continuar a Primeira semana** leva ao próximo passo.

Na tela de quem enviou o link, aparece "Link enviado para..." e a tela muda sozinha quando a pessoa conecta. Se precisar, use **Reenviar** ou **Mostrar o código**. O horário do envio e da validade aparece no fuso do seu navegador.

## Erros comuns

* "Este link já foi usado": ele só vale uma vez. Peça um novo.
* "Este link venceu": o link de conexão vale 15 minutos. Peça um novo à agência.
* "Este link já está aberto em outro navegador": por segurança, só funciona no navegador que abriu primeiro.
* "Link não encontrado": confira o endereço ou peça outro.
* "Não deu para gerar o código": pode ser a internet ou o WhatsApp fora do ar. Use **Tentar de novo**.
* "Este número já está conectado": não precisa ler o QR de novo.
* "A agência não tem um WhatsApp para mandar o link": use **Copiar o link** e mande você mesmo.
* "O link foi criado, mas o WhatsApp não enviou": o mesmo, copie e mande.
* "Esta caixa é da API Oficial: reconecte pela Meta em Ajustes › Canais": o QR não serve para ela.

## Próximo passo

* [WhatsApp Oficial](https://docs.stchat.app/subcontas/whatsapp-oficial.md)
* [A tela de Canais](https://docs.stchat.app/subcontas/tela-de-canais.md)
* [Aquecimento do número](https://docs.stchat.app/subcontas/aquecimento-do-numero.md)
* [Canal desconectado](https://docs.stchat.app/subcontas/canal-desconectado.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.