WhatsApp (QR Code)

O gatilho WhatsApp QR Code conecta o agente a um número de WhatsApp via leitura de QR Code, usando a API não oficial. É a forma mais rápida de testar, mas não tem SLA da Meta — a sessão pode cair a qualquer momento e o número pode ser banido se for usado para spam.

Quando usar (e quando não)

Use para	Não use para
Testes rápidos com seu número pessoal	Atendimento ao cliente real
Demos curtas para mostrar o agente	Volume alto de mensagens
Validação de prompt em ambiente próximo do real	Qualquer operação que dependa de estabilidade

Para qualquer cenário de produção, use o WhatsApp Oficial (Cloud API).

Conectando

O WhatsApp QR Code é conectado pela tela Caixas de entrada — cada caixa é um canal conectado, e você escolhe depois quem atende.

No menu lateral, abra Caixas de entrada.
Clique em Conectar caixa de entrada.
Em Escolha o canal, no grupo WhatsApp, selecione WhatsApp QR Code.
O SquadOS gera um QR Code que expira em 2 minutos.
No celular, abra o WhatsApp → Aparelhos conectados → Conectar um aparelho → aponte para o QR Code.
Em Quem atende esta caixa?, escolha o agente que vai responder — ou deixe no atendimento humano, e um operador responde pela tela de Conversas.
Dê um Nome da caixa e clique em Concluir.

Se o QR expirar, gere um novo pelo botão de atualizar antes de escanear.

Como funciona

O SquadOS hospeda uma sessão WhatsApp Web por trás (via Wuzapi).
Mensagens recebidas viram conversas no SquadOS e o agente responde.
A resposta sai como se você tivesse digitado.

A sessão é validada periodicamente em background — se o WhatsApp do celular se desconectar (sem internet, bateria, ou desligamento manual da sessão pelo próprio app), a caixa passa a aparecer como Desconectada na lista.

Desconectando

Encerre a sessão pelo celular, em Aparelhos conectados → remover o aparelho “WhatsApp Web”. A caixa correspondente passa a Desconectada em Caixas de entrada.

Limitações

Não há SLA — o WhatsApp pode encerrar a sessão sem aviso.
Risco de banimento — uso indevido pode resultar em banimento do número.
Sem templates — não dá para iniciar conversa proativamente como na Cloud API.
Sem suporte oficial — qualquer mudança no protocolo do WhatsApp pode quebrar a conexão.

Problemas comuns

QR Code não escaneia — confira se o WhatsApp do celular está atualizado. Gere um novo QR pelo botão de atualizar.
Sessão cai sozinha — o WhatsApp invalidou a sessão; gere novo QR e reconecte. Se acontecer com frequência, use o WhatsApp Oficial.
Mensagens recebidas mas agente não responde — confira se o agente está ativo e se o prompt está OK. Veja em Conversas se a mensagem chegou.