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)
Seção intitulada “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
Seção intitulada “Conectando”- Abra o agente no painel admin.
- Vá para Gatilhos.
- No card WhatsApp QR Code, clique em Conectar.
- 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.
- Quando o WhatsApp valida, o card mostra Conectado com o número.
Se o QR expirar, clique em Atualizar QR Code para gerar um novo.
Como funciona
Seção intitulada “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), o card muda para Desconectado.
Desconectando
Seção intitulada “Desconectando”No card já conectado, clique em Desconectar. O SquadOS encerra a sessão Wuzapi do agente. Você também pode encerrar manualmente pelo celular, em Aparelhos conectados → remover o aparelho “WhatsApp Web”.
Limitações
Seção intitulada “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
Seção intitulada “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.