--- title: "Conecte o WhatsApp por QR Code" category: "Canais / WhatsApp" updatedAt: "2026-10-23T14:24:45Z" url: "https://spryx.ai/help/canais/whatsapp/como-conectar-o-whatsapp-por-qr-code" --- # Conecte o WhatsApp por QR Code Conecte por QR Code e entenda os riscos da integração não oficial. A conexão por QR Code liga um número de WhatsApp à Spryx do mesmo jeito que o WhatsApp Web: você escaneia um código com o celular e pronto. Não precisa de conta na Meta. Use quando quiser começar rápido ou atender também em grupos, e leia os riscos antes de decidir. **Pré-requisitos** - **Permissão:** Precisa da permissão Canais no nível Gerenciar. Nos papéis padrão, só o Admin tem. ## QR Code ou WhatsApp oficial? {#qr-code-ou-whatsapp-oficial} A própria Spryx descreve essa opção como "WhatsApp não oficial". Na prática: - **Sem templates e sem janela de 24 horas.** Você envia mensagens livres a qualquer momento, mas não tem templates aprovados pela Meta. - **Sem perfil e sem saúde do número.** As abas **Saúde** e a seção **Perfil do WhatsApp** existem só no WhatsApp oficial. - **Grupos entram no Ao Vivo.** As conversas de grupo aparecem com a etiqueta **Grupo**. - **Histórico opcional.** Você pode trazer conversas e contatos que já estão no celular. > **Risco** > > **Risco de bloqueio e interrupção.** A conexão por QR Code não usa a API oficial da Meta. Ela depende de uma sessão semelhante ao WhatsApp Web, pode desconectar e não possui as garantias da integração oficial. Os [Termos de Serviço do WhatsApp](https://www.whatsapp.com/legal/terms-of-service) proíbem usos não autorizados ou automatizados e permitem suspender ou desativar contas que violem as regras. Para um número que não pode parar, prefira o WhatsApp oficial. [Conecte o WhatsApp oficial](https://spryx.ai/help/canais/whatsapp/como-conectar-o-whatsapp-oficial) — Conecte um número à Spryx pela API oficial da Meta. ## Quando evitar a conexão por QR Code {#quando-evitar-a-conexao-por-qr-code} Não use essa opção como primeira escolha quando: - o número é crítico para vendas, suporte ou autenticação; - uma desconexão pode interromper uma operação importante; - você precisa iniciar conversas com templates aprovados; - precisa acompanhar qualidade, limite e saúde do número na Meta; - sua empresa exige uma integração oficialmente suportada pelo WhatsApp. O QR Code pode ser útil para testes controlados, operações temporárias ou cenários que dependem de grupos. Mesmo nesses casos, monitore o canal e mantenha um plano para migrar ao WhatsApp oficial. ## Conectar o número {#conectar-o-numero} 1. Vá em **Configurações → Canais** e clique em **Conectar canal**. 2. Escolha a opção de WhatsApp não oficial, a que diz **Conecte com QR Code** na descrição, e clique em **Continuar**. 3. Preencha o **Nome do Canal**, por exemplo "WhatsApp Vendas". Só o seu time vê esse nome. 4. Se quiser trazer as conversas antigas, ative **Sincronizar histórico** (veja a próxima seção). 5. Se quiser que um agente de IA ou um workflow responda automaticamente, ative **Usar IA** e escolha em **IA**. A lista mostra só agentes e workflows publicados. 6. Em **Visibilidade**, escolha **Todos do workspace** ou **Times específicos**. 7. Clique em **Conectar**. A janela **QR Code do WhatsApp** abre com o código. 8. No celular, abra o WhatsApp, vá em **Aparelhos conectados**, toque para conectar um aparelho e escaneie o código. 9. Quando a conexão completa, a janela fecha sozinha e aparece **WhatsApp conectado com sucesso**. ![Configuração do WhatsApp por QR Code com nome do canal, sincronização de histórico e uso de IA.](https://cdn.sanity.io/images/qbc9enz0/production/22fd517bae8e4ffc1c7766222895af7e4cc30fad-1120x536.png?w=1600&fit=max&auto=format) _Escolha se o canal deve importar o histórico e responder automaticamente._ ![Opções de visibilidade Todos do workspace e Times específicos na configuração do canal.](https://cdn.sanity.io/images/qbc9enz0/production/bc5024a52c16bdf76b8f471c831d916f86d8db87-1048x262.png?w=1600&fit=max&auto=format) _Defina quem poderá acessar as conversas antes de gerar o QR Code._ O canal é criado assim que você clica em **Conectar**. Se fechar a janela do QR Code sem escanear, o canal fica na lista como **Desconectado**. Para terminar, abra o canal e clique em **Reconectar** (veja abaixo). ## Trazer o histórico do celular {#trazer-o-historico-do-celular} Com **Sincronizar histórico** ligado, a Spryx puxa conversas, contatos e mensagens que já existem nesse WhatsApp logo depois de conectar. - O andamento aparece na aba **Visão Geral** do canal, como **Importando histórico — 350 mensagens**. - No fim, aparece quantas conversas e contatos foram criados. - Em históricos muito grandes, pode aparecer **Histórico importado parcialmente**: parte das mensagens antigas não pôde ser trazida. Essa opção só existe na hora de conectar. Ela não aparece depois, ao editar o canal. ## Grupos do WhatsApp {#grupos-do-whatsapp} Os grupos do número conectado também chegam ao **Ao Vivo**, com a etiqueta **Grupo** na conversa. Por padrão, todos os grupos entram. ## Quando o canal desconecta {#quando-o-canal-desconecta} O canal aparece como **Desconectado** quando a conexão com o WhatsApp cai, quando alguém remove a Spryx dos **Aparelhos conectados** no celular ou quando você clica em **Desconectar**. A Spryx avisa com a notificação **Canal desconectado**. Para reconectar: 1. Em **Configurações → Canais**, clique em **Configurar** no canal. 2. Clique em **Reconectar**. A janela **QR Code do WhatsApp** abre com um código novo. 3. Escaneie pelo celular, em **Aparelhos conectados**. 4. A janela fecha sozinha quando conecta. Ao reconectar, a Spryx busca as mensagens que chegaram enquanto o canal estava desconectado. Se aparecer **Erro ao carregar QR Code**, feche a janela e clique em **Reconectar** de novo. ## Perguntas frequentes ### Preciso de conta na Meta para conectar por QR Code? Não. Basta o celular com o WhatsApp do número que você quer conectar. ### Posso enviar templates por um canal conectado por QR Code? Não. Templates existem só no WhatsApp oficial. Por outro lado, o canal de QR Code não tem a janela de 24 horas, então você envia mensagens livres a qualquer momento. ### Posso ativar a sincronização de histórico depois de conectar? Não. **Sincronizar histórico** só aparece na hora de conectar o canal. ### Perdi mensagens enquanto o canal estava desconectado? Assim que o canal reconecta, a Spryx busca as mensagens que chegaram nesse período e as traz para o Ao Vivo.