O Sandbox v2 do ShopIA bloqueia envios e registra logs. Existem dois toggles separados — um para o Canal 1 (Memo, ShopIA → lojista) e outro para o Canal 2 (Otto, lojista → comprador). Você pode ativar um sem afetar o outro.
O Sandbox v2 substituiu o modelo antigo de "redirecionar para número de teste". Em vez de redirecionar, o sistema agora bloqueia o envio no chokepoint final e registra a mensagem exata que teria sido enviada com status sandbox. Você inspeciona depois para validar conteúdo.
Por que dois toggles separados
Memo e Otto são canais distintos com casos de teste independentes:
- Você pode estar testando uma automação Otto nova e querer ver mensagens de carrinho serem bloqueadas, sem afetar comunicação Memo com outros lojistas em produção.
- Você pode estar validando broadcast Memo para uma campanha interna, sem afetar automações Otto que estão rodando para compradores reais.
Os dois toggles são totalmente independentes. Ativar um não toca o outro.
Onde ficam os toggles
Apenas Super Admin acessa os toggles, em /admin/configuracoes/sandbox:
Sandbox Memo (Canal 1)
└── [ON / OFF] — Bloqueia comunicações ShopIA → lojistas
Kill Switch Otto (Canal 2)
└── [ON / OFF] — Bloqueia comunicações lojas → compradoresLojistas comuns não veem nem alteram esses toggles. Caso queira testar mudanças em sua própria loja em ambiente seguro, solicite ao super admin que ative a configuração para sua conta.
O que cada toggle bloqueia
Sandbox Memo (Canal 1)
Quando ativo, bloqueia toda comunicação do tipo:
- Memo respondendo no WhatsApp do lojista
- Brief semanal, alertas de carrinho, lembretes
- Calendário editorial gerado pela equipe
- Broadcasts da ShopIA
- Email Memo (
[email protected])
A mensagem que teria sido enviada é registrada na tabela whatsapp_messages ou email_logs com status sandbox. Você pode revisar em /admin/memo/mensagens filtrando por status.
Kill Switch Otto (Canal 2)
Quando ativo, bloqueia toda automação do tipo:
- Recuperação de carrinho (4 disparos)
- Pós-venda (4 etapas)
- Win-back (3 marcos)
- Newsletter Otto
- Cross-sell, compra complementar, aniversário
- Campanhas multicanal (canal Otto)
Mensagens são registradas com status sandbox em whatsapp_messages ou email_logs. Você pode revisar em /admin/otto/mensagens filtrando por status.
O pipeline roda inteiro, só o envio para
A decisão arquitetural mais importante do Sandbox v2: o pipeline executa por completo até o chokepoint final. Isso significa:
- Template é resolvido com dados reais
- Personalização IA roda
- Renderização HTML do email é gerada
- Variáveis são substituídas
Apenas no momento exato de chamar Evolution API (WhatsApp) ou SES (email), o sistema verifica o toggle e bloqueia.
Por que isso é crítico: o log mostra a mensagem exata que teria ido para o destinatário. Sem aproximação. Você valida o resultado real do pipeline, não uma versão simplificada.
Banner visual
Quando algum toggle está ativo, o painel exibe banner vermelho fixo:
- SANDBOX MEMO ATIVO — quando Memo bloqueado
- SANDBOX OTTO ATIVO — quando Otto bloqueado
Os banners são separados — você pode ver os dois simultaneamente ou apenas um. O banner reduz risco de esquecer o toggle ligado em produção.
Como validar mensagens bloqueadas
Memo
- Acesse /admin/memo/mensagens.
- Filtro Status: marque Sandbox.
- Visualize cada linha.
- No detalhe, você vê:
- Destinatário original (que teria recebido) - Conteúdo exato da mensagem - Timestamp - Razão do bloqueio (sandbox: memo_enabled)
Otto
- Acesse /admin/otto/mensagens.
- Filtro Status: marque Sandbox.
- Mesma visualização — conteúdo + destinatário + razão.
Quando usar Sandbox
Caso 1: testar nova automação
Ative Sandbox Otto. Crie a automação. Dispare em loja real (com pedidos reais ou simulados). Confira no log se as mensagens saíram com texto correto. Desative quando aprovado.
Caso 2: validar broadcast antes de disparo
Ative Sandbox Memo. Crie e dispare o broadcast. Confira no log para todas as lojas-alvo se o conteúdo foi montado corretamente. Desative e dispare novamente, agora real.
Caso 3: troubleshooting de cliente reportando mensagem ruim
Sem ativar sandbox, vá em /admin/[memo|otto]/mensagens filtrando por destinatário ou loja. Você vê o que foi enviado, com mesmo nível de detalhe.
Quando NÃO usar Sandbox
- Ambiente de produção comercial. Ativar sandbox em produção bloqueia comunicação para todos os lojistas (Memo) ou todos os compradores (Otto). Isso quebra a operação. Use apenas em ambiente de homologação ou em janela controlada.
- Para "pausar temporariamente" comunicação. Pause a automação ou o canal específico, não o sandbox global. Sandbox bloqueia tudo, inclusive transacional crítico (confirmação de pedido, etc.).
Diferença entre Sandbox v2 e Sandbox v1
A versão antiga (v1) redirecionava mensagens para número/email de teste. Removida em 2026-04-15. A v2 bloqueia e registra, sem redirecionar. A vantagem: você inspeciona o conteúdo real, em volume real, sem poluir caixa de teste.