O simulador é um chat interno que te permite testar seu fluxo de IA manualmente antes de expô-lo a clientes reais, com a vantagem de poder iniciar a conversa a partir de um contexto já configurado.
🔄 Qual versão é testada? (Regra de publicação)
O comportamento do simulador muda dependendo do estado atual do seu fluxo. Preste muita atenção a esta regra:
Se o fluxo é novo (Apenas Rascunho): O simulador utilizará sua versão em rascunho. Ao pressionar o botão de simular, o sistema salva suas alterações automaticamente antes de abrir o chat (não é necessário salvar manualmente). Se o salvamento falhar, um erro é exibido e o chat não será aberto.
Se o fluxo já está Publicado: O sistema o obrigará a Publicar antes de poder simular. Você não pode simular alterações em rascunho em um fluxo que já está em produção; para ver seus novos ajustes no simulador, terá que clicar no botão "Publicar" obrigatoriamente.
💡 Dica de testes: Aproveite a fase de rascunho inicial para editar, simular, corrigir e simular novamente livremente sem afetar nada. Uma vez que o fluxo esteja em produção, lembre-se de que cada teste de uma nova alteração exigirá atualizar a versão publicada.
📍 Como é aberto?
Para acessar o simulador, a rota é direta: Canvas → Botão de simulação (Canto superior direito).
Compilação: Ao abri-lo, o sistema compila o fluxo em um grafo executável. Se o fluxo é válido, abre o chat. Se a compilação falhar ou tiver erros de validação, mostrará o detalhe dos erros em vez de abrir o simulador.
O painel pode ser fechado a qualquer momento sem perder o progresso do seu fluxo.
🧠 Contexto inicial e Presets
Antes de iniciar a conversa, você pode pré-carregar informações (contexto) para testar cenários específicos sem ter que reconstruí-los mensagem por mensagem (ex: testar como a IA responde se o cliente já é VIP ou se começa de uma etapa avançada do funil).
Como se configura: Na tela do simulador há uma seção recolhível chamada Contexto inicial. Ao expandi-la, você verá a lista de todos os campos configurados no seu fluxo. Você pode deixá-los vazios ou pré-carregar um valor. Você também pode configurar a etapa inicial do funil e as tipificações já aplicadas para testar comportamentos condicionais.
Presets (Modelos de teste): Sua configuração de contexto atual pode ser salva como um Preset para reutilizá-la em simulações futuras (são salvos no nível do fluxo). Exemplos úteis: "Cliente premium identificado", "Lead novo sem dados", "Cliente com reclamação anterior".
O que acontece ao iniciar: O nó inicia com esses valores já disponíveis em sua memória. O modelo de IA os recebe como se tivessem sido capturados organicamente pelo bot. O painel de rastreamento mostrará exatamente qual contexto foi pré-carregado para que você audite seu teste.
🛠️ Simulação de Ferramentas e APIs
Ao testar um agente, não é mais necessário que as ferramentas consultem de verdade seus sistemas externos ou bancos de dados em tempo real. Você pode configurar manualmente o que cada uma deve responder.
Opções de execução: Antes de começar o teste, você pode escolher o que fazer com as ferramentas: permitir que consultem os sistemas reais, simulá-las todas, ou simular apenas algumas em específico.
Formas de simular respostas:
Modo Simples: Você descreve a situação em linguagem natural (ex: "sem estoque do produto X", "o CRM está indisponível") e o sistema monta automaticamente a resposta técnica para você.
Modo Avançado: Você escreve manualmente a carga técnica de resposta.
Simulação de Erros: Os erros também podem ser simulados para validar que o agente reaja corretamente diante de uma falha do sistema real.
Rastreabilidade: No painel de rastreamento, essas chamadas ficarão explicitamente marcadas com a tag
SIMULADA, para não confundi-las com execuções reais.
Requisito indispensável: Uma ferramenta só pode ser simulada se em sua configuração tiver declarada a forma (estrutura) de sua resposta.
💬 Comportamento do chat
A interface do simulador foi projetada para ser ágil e realista diante do comportamento de um usuário:
Ação do usuário | Comportamento do simulador |
Enviar uma mensagem | Pressione Enter. Use Shift + Enter para adicionar uma quebra de linha sem enviar. |
Escrever mensagens longas | O campo cresce automaticamente até cerca de 6 linhas; depois aparece um scroll interno. Ao enviar, volta ao seu tamanho normal. |
Enquanto o nó processa | É exibido o indicador dinâmico de "Digitando…". |
Ao receber mensagem nova | A visualização desce automaticamente até que a mensagem fique completamente visível na tela. |
Ao rolar para cima | O scroll automático é pausado e aparece um botão flutuante para voltar à última mensagem e retomá-lo. |
(Observação: Cada sessão de chat recebe um identificador único, o que permite testar de forma real o comportamento de memória e continuidade da IA).
👁️ O que o simulador renderiza
O simulador reproduz fielmente todos os tipos de mensagem que o nó pode enviar e receber em produção (baseado visualmente em WhatsApp por padrão). Cada mensagem mostra seu papel (IA ou usuário), timestamp e status.
Tipo de mensagem | Como é renderizado visualmente |
Texto | Respeita quebras de linha e formatação (negrito, itálico, tachado, monoespaciado). URLs mostram prévia. |
Áudio | Reprodutor com play, pausa e duração. Diferencia visualmente mensagens de voz de áudios genéricos. |
Imagem | Miniatura inline com legenda. Ao clicar, expande para tamanho completo. |
Vídeo | Miniatura com camada sobreposta de reprodução e legenda. Ao clicar, é reproduzido ali mesmo. |
Documento | Ícone de acordo com a extensão, nome do arquivo, tamanho e botão de download. |
Botões | Até 3 abaixo da mensagem (o sistema avisa se o texto exceder os 20 caracteres permitidos). |
Listas | Botão inicial que abre a lista completa com opções agrupadas em seções. |
Botão CTA | Abre a URL configurada em uma nova aba. Suporta cabeçalho, corpo e rodapé. |
💡 Interatividade total: Tocar um botão, escolher uma opção de lista ou enviar mídia do lado do cliente faz o fluxo avançar exatamente como faria um usuário real. (Se você configurar uma mensagem que o canal não suporta, verá um aviso de incompatibilidade).
Experimente e quebre tudo antes de ir para a produção! 🚀
O simulador é seu banco de testes definitivo; permite validar variáveis complexas, respostas de ferramentas simuladas, formatos multimídia e decisões da IA, garantindo que seu fluxo conversacional esteja perfeitamente ajustado antes de interagir com seu primeiro cliente real. ✅