Conecte o WhatsApp por QR Code

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.

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.

Quando evitar a conexão 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

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.

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

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

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

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.