--- title: "Conectando o WhatsApp por QR Code (API não oficial)" url: https://ajuda.botconversa.com.br/aula/conectando-o-whatsapp-por-qr-code section: "Primeiros passos" date_modified: 2026-09-22T18:00:35.399267+00:00 language: pt-BR --- # Conectando o WhatsApp por QR Code (API não oficial) [Vídeo da aula](https://www.youtube.com/watch?v=qS3Jx0dGRHU) ## Resposta rápida Na API não oficial, conectar é como usar o WhatsApp Web: em **Configurações → Conexão**, clique em **Conectar meu WhatsApp** e escaneie o QR Code com o celular em **WhatsApp → Aparelhos conectados → Conectar um aparelho**. Quando a tela deixar de mostrar "A automação não está ativa" e passar a exibir o número conectado, o robô já responde. O celular não precisa ficar ligado o dia todo, mas o número precisa continuar ativo no aparelho e o WhatsApp precisa ser aberto nele pelo menos a cada 14 dias. **Tempo de leitura:** ~7 min**Para quem é:** Quem usa a API não oficial Ao final desta aula o seu número estará conectado ao BotConversa e você terá enviado a primeira mensagem de teste. Se a sua conta é da **API Oficial** (conexão pela Meta, sem QR Code), esta aula não é para você: siga [Conectando o WhatsApp por coexistência](/aula/conectando-o-whatsapp-por-coexistencia). Na dúvida, [descubra o seu tipo de conexão](/aula/tipo-de-conexao-oficial-ou-nao-oficial) antes. ## O que preciso antes de escanear? - Um **número de WhatsApp ativo em um celular**, no aplicativo comum ou no WhatsApp Business. O BotConversa vira um "aparelho conectado" desse número. - O celular com **internet** na hora de escanear. - Acesso de **dono ou administrador** da companhia no BotConversa. - De preferência, um **número dedicado ao atendimento**. Um número usado por vários sistemas ao mesmo tempo, ou o WhatsApp pessoal do dono, é a principal fonte de conexões instáveis e de bloqueios. **O número ainda não existe no celular?** Instale o WhatsApp Business, ative o número com o chip e só depois volte aqui. O BotConversa não cria o número: ele se conecta a um WhatsApp que já funciona. ## Como conecto? ![Tela Configurações → Conexão com o aviso ](https://lfdfrrdzcfagillurinx.supabase.co/storage/v1/object/public/article-images/01-primeiros-passos/conectando-o-whatsapp-por-qr-code/passo-1.png) Sem número conectado, a tela de **Conexão** mostra o aviso e o botão **Conectar meu WhatsApp**. 1. No painel do BotConversa, vá em **Configurações → Conexão**. Enquanto nada está conectado, a tela mostra o aviso **A automação não está ativa**. 2. Clique em **Conectar meu WhatsApp**. Abre uma janela com o QR Code, que é renovado a cada 30 segundos por segurança. 3. No celular, abra o WhatsApp e toque em **Configurações** (no Android, o menu de três pontos). 4. Toque em **Aparelhos conectados** e depois em **Conectar um aparelho**. 5. Aponte a câmera para o QR Code na tela do computador. 6. Aguarde alguns segundos. A janela fecha sozinha e a tela de Conexão passa a mostrar o número conectado e a automação ativa. 7. Confira, no celular, que "BotConversa" aparece na lista de aparelhos conectados. ![Janela Conectar meu WhatsApp com as instruções, o QR Code e o aviso de que um novo QR será gerado em 30 segundos](https://lfdfrrdzcfagillurinx.supabase.co/storage/v1/object/public/article-images/01-primeiros-passos/conectando-o-whatsapp-por-qr-code/passo-2.png) A janela traz as instruções e o QR Code. Se demorar para escanear, ele se renova sozinho: basta escanear o novo. ## O celular precisa ficar ligado? Não o tempo todo. O WhatsApp permite até **quatro aparelhos conectados** ao mesmo número, e eles funcionam mesmo com o celular desligado ou sem internet, porque a conexão passa pelos servidores do próprio WhatsApp. Isso significa que o BotConversa pode ser um desses aparelhos ao lado do WhatsApp Web do seu computador. Duas condições continuam valendo, e são elas que derrubam a maioria das conexões: - O **número precisa continuar ativo** no celular. Desinstalar o aplicativo, trocar o chip ou registrar o número em outro celular desconecta todos os aparelhos. - O WhatsApp precisa ser **aberto no celular pelo menos uma vez a cada 14 dias**. Passado esse prazo sem uso do aparelho principal, o próprio WhatsApp desconecta os aparelhos vinculados. ## Como sei que está funcionando? A tela de **Configurações → Conexão** é a fonte da verdade: com o número conectado, ela deixa de mostrar o aviso de automação inativa e exibe os dados da conexão. O teste definitivo é prático: peça para alguém, ou use um segundo número seu, mandar um "oi" para o número conectado. A conversa deve aparecer no **Inbox** em poucos segundos. Enquanto você não tem um fluxo ativo, o robô não responde nada, e isso é normal: a resposta automática começa na aula 9. ## Por que a conexão caiu e como reconecto? O que aconteceu O que fazer Alguém tocou em **Desconectar** na lista de aparelhos do celular Gere um novo QR Code e escaneie de novo. O celular ficou mais de 14 dias sem abrir o WhatsApp Abra o WhatsApp no celular e escaneie de novo. Crie o hábito de abrir o aplicativo toda semana. Troca de celular, reinstalação ou novo chip Ative o número no aparelho novo e reconecte pelo QR Code. O número foi banido ou restringido pelo WhatsApp A conexão não volta enquanto o número estiver bloqueado. Veja [Boas práticas para evitar bloqueio](/aula/boas-praticas-para-evitar-bloqueio), que inclui o que fazer no caso de banimento. A tela mostra o número conectado, mas as mensagens não chegam Feche e abra o WhatsApp no celular, confira a internet do aparelho e, se persistir, desconecte pela lista de aparelhos e escaneie de novo. ## O que muda em relação à API Oficial? A conexão por QR Code é a mais simples de começar, e é bom saber o que ela traz junto: - **Não existe janela de 24 horas nem modelo de mensagem.** Você e o robô mandam texto livre a qualquer momento, inclusive em transmissões. - **Não existe cobrança por mensagem.** O custo é só o plano do BotConversa. - **O risco de bloqueio é maior.** O WhatsApp trata o número como um usuário comum, e volume alto de mensagens sem resposta parece spam. Por isso as transmissões têm o ajuste de **Atraso**, e a aula 13 é inteira sobre isso. - **Não há selo de conta verificada** nem os limites oficiais de envio da Meta. Quando o negócio crescer, migrar para a API Oficial é um caminho de mão única e vale ser planejado. A última aula desta trilha, [Migrando da API não oficial para a Oficial](/aula/migrando-para-a-api-oficial), mostra quando faz sentido e como fazer. ## Dicas - **Não conecte o mesmo número em duas ferramentas de automação.** Elas disputam as mensagens e o comportamento fica imprevisível. - **Deixe o WhatsApp Web do computador conectado também.** Ele não atrapalha o BotConversa e ajuda a acompanhar as conversas no começo. - **Número novo pede aquecimento.** Nos primeiros dias, converse normalmente com poucos contatos antes de qualquer disparo em massa. - **Mantenha o celular carregado e com internet** nos primeiros dias, até confirmar que a conexão está estável. **🎯 Missão desta aula:** conecte o número e, de um segundo WhatsApp, mande uma mensagem para ele. **Checkpoint:** a tela de Conexão mostra o número conectado e a mensagem de teste aparece no Inbox. ## Perguntas frequentes Posso usar o meu número pessoal? Tecnicamente sim, mas não recomendamos. O robô vai responder a todo mundo que mandar mensagem, inclusive família e amigos, e um bloqueio derrubaria o seu número pessoal junto. Use um número só para a empresa. Preciso do WhatsApp Business? Não é obrigatório: o aplicativo comum também conecta. O WhatsApp Business é recomendado porque traz perfil comercial, catálogo e etiquetas no próprio aplicativo. Quantos aparelhos posso conectar ao número? Até quatro, contando o BotConversa. O celular com o chip é o aparelho principal e não entra nessa conta. Posso conectar dois números na mesma companhia? Cada companhia conecta um número. Para um segundo número, é preciso uma segunda companhia. Fale com o suporte para entender as opções do seu plano. O QR Code expirou antes de eu escanear. Normal: ele tem validade curta. Recarregue a tela ou clique para gerar outro e escaneie com o WhatsApp já aberto na tela de conectar aparelho. Meu WhatsApp Web deslogou depois que conectei o BotConversa. Tem relação? Não deveria: são aparelhos independentes. Se isso aconteceu, provavelmente você atingiu o limite de quatro aparelhos ou o celular ficou muito tempo sem abrir o WhatsApp.