O Memo depende de Evolution API + WhatsApp + provider de IA + worker. Falha em qualquer ponto interrompe o canal. Esta página descreve diagnóstico em ordem de probabilidade.
Sintomas comuns
- Você manda mensagem para o Memo, ele não responde
- Memo responde com atraso longo (>2 minutos)
- Memo responde algo sem nexo
- Memo erra dado da loja (vendas, clientes)
- Painel mostra Memo como offline ou degradado
Como saber rapidamente o estado
No painel: Painel > Status dos agentes ou indicador colorido ao lado do Memo na sidebar.
| Cor | Estado |
|---|---|
| Verde | Memo operacional |
| Amarelo | Degradado (latência alta) |
| Vermelho | Offline |
| Cinza | Sandbox ativo |
Causa 1: Sandbox Memo está ativo
A causa mais comum de Memo "não responder" é Sandbox ligado.
Como verificar
- Banner vermelho no topo da sidebar: SANDBOX MEMO ATIVO
- Indicador cinza no Memo
- Em Mensagens > Memo, mensagens recentes têm status
sandbox
Como resolver
Apenas super admin desliga sandbox. Se você é Owner da loja, acesse Configurações > Sandbox (se permissão habilitada) ou abra ticket pedindo desativação.
Detalhes em Sandbox: ambiente seguro.
Causa 2: Evolution desconectada
O Memo usa Evolution API para enviar/receber WhatsApp. Se Evolution cai, Memo cai junto.
Como verificar
- Acesse Configurações > WhatsApp Memo > Status.
- Olhe o estado da conexão Evolution.
- Se desconectada, há QR Code para reconectar.
Como resolver
- Escaneie o QR Code com o mesmo telefone que iniciou o Memo.
- Aguarde 30s.
- Status volta para conectado.
Detalhes em WhatsApp Memo via Evolution.
Causa 3: rate limit de envio
Memo tem rate limit por loja para evitar ban do WhatsApp:
- Lock global de 60s entre envios em batch
- Limite por hora variável conforme histórico
Como verificar
Em Mensagens > Memo, mensagens recentes com status queued que ficam paradas indicam rate limit ativo.
Como resolver
- Espere — o rate limit libera em 1-5 minutos
- Reduza batch (campanhas Memo grandes)
- Em casos persistentes, abra ticket
Causa 4: provider de IA com falha
O Memo usa cascata de providers (Anthropic, OpenAI, Gemini, DeepSeek). Se todos falham, ele não responde.
Como verificar
Painel admin mostra status do aiService. Como lojista, você só vê sintoma: latência alta ou resposta vazia.
Como resolver
Falha de provider é raríssima e o time ShopIA monitora. Se persiste por mais de 15 minutos:
- Veja status.shopia.com.br.
- Se não há incidente publicado, abra ticket.
Causa 5: worker travado
O Memo processa mensagens via worker BullMQ. Se o worker trava, fila acumula.
Como verificar (admin)
Admin vê em Monitoramento > Filas (admin only) se messaging queue está acumulada.
Como resolver (lojista)
Reportar ao suporte — só admin reinicia worker. Sintoma de fora: mensagens que demoram 5+ minutos.
Causa 6: número da loja errado
O Memo tem um número compartilhado que conversa com lojistas autorizados. Se o telefone que está mandando mensagem não está autorizado, o Memo não responde.
Como verificar
- Acesse Memo > Configurar > Equipe autorizada.
- Confirme que seu número está listado.
Como resolver
- Adicione seu número (com código país, ex:
+5511999999999). - Memo envia mensagem de confirmação no número.
- Confirme.
Causa 7: mensagem cair em debounce
Memo agrupa mensagens picadas em debounce de 7s antes de processar. Se você manda várias mensagens em sequência, ele espera o silêncio.
Como verificar
Não há sintoma direto — apenas atraso de até 7s na primeira resposta.
Como resolver
Não é problema. Espere 10-15s antes de declarar como falha.
Causa 8: áudio não transcrevendo
Se você manda áudio e Memo não entende:
- Whisper (provider de transcrição) pode estar com latência.
- Áudio pode ter qualidade baixa.
- Áudio pode estar em idioma não suportado.
Como resolver
- Mande novamente em texto
- Em áudio, fale claro e em português
- Áudios muito longos (>2 min) podem timeout
Detalhes em Memo entende áudio? Whisper STT.
Causa 9: tools do Memo travadas
Memo usa "tools" internas (consulta estoque, métricas, calendário). Se uma tool trava, ele pode demorar ou responder incompleto.
Como verificar
Resposta com texto tipo "deixa eu verificar..." e nada vem depois sugere tool travada.
Como resolver
- Refaça a pergunta de outra forma
- Espere 2-3 minutos e refaça
Causa 10: capability boundary recusou
Memo se recusa a responder fora do escopo dele (Canal 1 — consultor de lojistas). Pedidos de venda, recuperação direta, ou ações para clientes finais são encaminhados ao Otto automaticamente.
Como verificar
Memo responde algo como: "Isso é função do Otto, não minha. Posso te direcionar para configurar?".
Como resolver
Não é falha — é design. Reformule perguntando algo dentro do escopo dele (consultoria, métricas, sugestões).
Quando entrar em contato com suporte
Após percorrer as causas acima, se Memo continua falhando:
- Abra ticket informando:
- Hora aproximada da falha - Mensagem que você mandou - O que esperava receber - Print da conversa (se possível)
- Suporte verifica logs específicos da sua loja.