Simulações permitem validar Procedimentos Fin, aumentar a confiança na sua automação e identificar problemas antes que afetem seus clientes. Ao modelar conversas completas, as simulações ajudam sua equipe a lidar com cenários complexos ou de alto volume, como cancelamentos e reembolsos, com segurança.

Projetadas para substituir verificações manuais demoradas, as simulações ajudam a identificar problemas ou mudanças graduais no comportamento do Fin conforme a lógica do seu negócio evolui.

Acessando simulações

As simulações estão localizadas no painel de testes de um Procedimento. Para acessá-las:

Abra o Procedimento que deseja testar.
Clique em Testar no canto superior direito da tela.
Selecione a aba Simulações no painel à direita.

Nota: Para acessar Simulações, são necessárias as seguintes permissões:

"Pode gerenciar dados do workspace",
"Pode acessar páginas de perfil de lead e user" e
"Pode acessar listas de pessoas, empresas e contas".

Se o botão Simulações não responder, verifique com o administrador do workspace se essas permissões estão habilitadas para você em Configurações > Workspace > Teammates.

Simulações ignoram a correspondência de intenção. Diferente do Preview ou conversas ao vivo, simulações não verificam suas instruções de 'Quando usar este Procedimento', assumem que o Procedimento já foi acionado e o executam diretamente. Isso torna as simulações ideais para testar a lógica de execução isoladamente.

Importante:

Preview executa uma conversa de teste que nunca alcança um cliente real, usando seu conteúdo real. Por padrão, Data Connectors retornam dados de exemplo. Se você testar como um user específico e selecionar “Acessar e atualizar dados reais do user quando acionado” nas configurações do Preview (ícone de engrenagem no painel de teste), Data Connectors chamam seus sistemas reais, então quaisquer ações que seu Procedimento realizar (como reembolsos ou atualizações de registros) serão feitas para esse user. Use uma conta de user de teste, nunca um cliente real.
Simulações nunca chamam sistemas externos. Fin usa os valores de teste que você define, tornando-as a forma mais segura de validar a lógica antes de entrar em produção.

Use Preview para verificações rápidas; execute Simulações antes de cada publicação.

Criando uma simulação

Você pode criar uma simulação de duas formas: usando sugestões geradas por AI para um início rápido, ou definindo manualmente o cenário para controle total.

Simulações geradas por AI: Use estas para cobrir rapidamente cenários comuns ou esperados de clientes com base em suas instruções. Fin AI gera testes "prontos" para economizar seu tempo.

Simulações manuais: Use estas quando precisar de controle preciso sobre dados, casos específicos ou ramificações particulares na sua lógica.

Simulações geradas por AI

Com base em suas instruções, Fin AI gerará testes iniciais para ajudar você a criar rapidamente simulações "prontas".

Abra a aba Simulações no painel direito do seu Procedimento.
Em Sugerido para estas instruções, revise a lista de cenários propostos (ex.: "Solicitação de cancelamento total").
Clique no ícone de reprodução ao lado de uma sugestão para executá-la instantaneamente.
Uma vez criada ou aceita uma simulação das sugestões, ela aparecerá na sua lista. Você pode então clicar em Executar tudo para rodar todas as simulações salvas de uma vez.

Simulações criadas manualmente

Você também pode construir uma simulação do zero para testar casos específicos com base nas instruções do Procedimento.

Na aba Simulações, clique em + Novo.
Nome da simulação: Dê um título claro para sua simulação.
Simular como: Escolha um user ou marca específica para testar a personalização. Você pode selecionar na lista suspensa de users reais do seu workspace.
Mensagem inicial do cliente: Insira a primeira mensagem que o cliente envia (ex.: "Preciso de ajuda com meu pedido"). Você também pode anexar uma imagem, como uma captura de tela de um erro, para testar como o Fin lida com contexto visual.
Detalhes adicionais: Forneça orientações sobre a situação do cliente ou ações específicas que ele tenha tomado.

Selecione um canal

Simulações permitem selecionar o canal que o Fin usará para esta simulação, para que você possa testar como o Fin se comporta. Use o menu suspenso do canal para alternar entre Messenger e Email antes de executar sua simulação.

Nota: O Fin se comporta de forma diferente dependendo do canal. No Email, o Fin agrega várias informações em uma única resposta em vez de enviar várias mensagens. Orientações e Conteúdo direcionado também podem ser configurados por canal — por exemplo, respostas por Email podem usar um tom mais formal ou incluir uma introdução específica.

Definir dados disponíveis

A seção Dados do cliente disponíveis para o Fin permite definir os dados que o Fin terá acesso durante o teste. Isso garante que você teste com valores de dados precisos em vez de descrições vagas.

Hora da simulação: Use para definir "quando" o cenário está acontecendo. Definir data e hora específicas permite testar lógica sensível ao tempo, como verificar se o cliente está dentro do prazo de reembolso de 30 dias.
Atributos e Data Connectors: Esta seção é preenchida com os atributos referenciados no seu Procedimento. Atualize esses valores (ex.: defina People.Plan como "Pro") para testar diferentes resultados de ramificação.

Nota: Para garantir que sua simulação funcione corretamente, coloque os dados com base em quando o Fin deve "saber" deles:

Use Atributos: Se o Fin deve já conhecer a informação no início da conversa (ex.: o Plano atual do cliente ou data de cadastro).
Use Detalhes adicionais: Se a informação deve ser fornecida pelo cliente durante a conversa (ex.: o cliente fornece o "ID do pedido" em uma resposta posterior). Isso permite testar se o Fin captura e armazena corretamente esses dados em um atributo.

Nota:

Data Connectors não usam dados reais de user em simulações. Em vez de chamar seu sistema externo, o Fin usa os valores de teste que você define na seção Dados do cliente disponíveis para o Fin. Certifique-se de preencher os campos do Data Connector com os valores que deseja que o Fin use durante o teste — caso contrário, o conector retornará resultados vazios.
A seção Dados do cliente disponíveis para o Fin mostra e mantém apenas atributos explicitamente referenciados nas instruções do seu Procedimento ou em um bloco de código. Se você adicionar manualmente um atributo usando o botão + Adicionar atributo, mas esse atributo não for referenciado em nenhum lugar do Procedimento, o sistema não o salvará — ele desaparece após salvar porque não afeta a simulação. Para adicionar um valor personalizado que persista, certifique-se de que o atributo seja usado primeiro no próprio Procedimento.

Avalie o comportamento do Fin

Defina os critérios que devem ser verdadeiros para o teste passar. Clique em + Adicionar critérios e selecione:

Fin reply: Especifique o que Fin deve (ou não deve) dizer durante a conversa.
Atributos: Verifique se um atributo foi definido, não foi definido, era igual ou não era igual a um valor específico.
Conector de dados: Verifique se um conector foi acionado, não foi acionado ou foi acionado exatamente X vezes.
Resultado da instrução: Verifique se a conversa chegou a uma conclusão específica, como finalizar, ser transferida para um colega ou outros resultados, como mudar para um Procedimento diferente.

Depois de configurado, clique em Salvar.

Nota: Quando você clicar em Salvar, Fin usa AI para revisar seu formulário de simulação. Se as instruções estiverem confusas ou se os critérios de sucesso forem inconsistentes, você verá recomendações para melhorar o teste e obter resultados mais precisos.

Melhores práticas para cobertura de simulação

Para aproveitar ao máximo as simulações, estruture seu conjunto de testes com base nestes princípios:

Teste um ramo por simulação. Se seu Procedimento tiver Condições ou subprocedimentos com múltiplos caminhos, crie uma simulação separada para cada ramo. Isso cria uma rede de segurança contra regressões — se uma edição futura quebrar um caminho específico, você perceberá imediatamente.
Cubra tanto os caminhos de sucesso quanto os de falha para Conectores de Dados. Execute uma simulação onde seu conector retorna dados válidos e outra onde não retorna nada ou falha. Isso verifica se sua lógica de fallback (por exemplo, um passo @Condition que trata uma resposta vazia) funciona corretamente.
Execute todas as simulações antes de publicar as alterações. Após editar um Procedimento, clique em Executar tudo para reexecutar todo o seu conjunto antes de entrar no ar. Qualquer simulação que falhar sinaliza uma regressão introduzida pela sua edição.
Use nomes descritivos para as simulações. Nomeie cada simulação de acordo com o cenário que representa (por exemplo, "Reembolso total — dentro de 30 dias" ou "Cancelamento — pedido não encontrado"). Isso facilita identificar qual teste cobre qual caminho ao revisar os resultados.

Estratégia de teste: caminho feliz, caminho de risco e casos extremos

Um conjunto de simulações bem equilibrado cobre três tipos de cenários. Juntos, eles dão confiança de que seu Procedimento funciona corretamente em condições normais, lida com falhas de forma adequada e não quebra quando os clientes se comportam de forma inesperada.

Caminho feliz
O caminho feliz representa o fluxo ideal e ininterrupto — um cliente que fornece exatamente as informações corretas e atende a todas as condições para que Fin complete o Procedimento com sucesso. Sempre comece por aqui. Se o caminho feliz falhar, depurar caminhos mais complexos fica muito mais difícil.
Exemplo: Um cliente solicita um reembolso dentro do prazo de 30 dias, tem um ID de pedido válido e o Conector de Dados retorna os detalhes do pedido. Fin processa o reembolso e confirma em uma única passagem.
Caminho de risco
Os caminhos de risco testam os cenários mais propensos a falhas em produção — tipicamente onde dados externos estão ausentes, condições não são atendidas ou um ramo de fallback deve ser acionado. Esses testes protegem seus clientes de respostas incorretas ou incompletas.
Exemplos: O Conector de Dados não retorna pedido (teste se Fin pede ao cliente o ID do pedido). O cliente está fora do prazo de reembolso (teste se Fin comunica a política correta e oferece a transferência adequada). Um atributo está vazio quando um passo Condition o avalia (teste se o caminho de fallback do Fin é acionado corretamente).
Casos extremos
Casos extremos cobrem entradas incomuns ou em condições-limite que são tecnicamente válidas, mas incomuns. Esses testes são especialmente importantes para Procedimentos com lógica sensível ao tempo, limites numéricos ou entradas de texto livre do cliente.
Exemplos: Um cliente solicita reembolso exatamente no dia 30 (o limite do prazo). Um cliente envia uma mensagem inicial ambígua que pode corresponder a múltiplas intenções. Um cliente fornece seu ID de pedido em um formato inesperado ou inclui texto extra junto com ele.

Dica: Use nomes descritivos para as simulações para indicar a qual categoria cada teste pertence — por exemplo, "Reembolso — caminho feliz", "Reembolso — pedido não encontrado (risco)" ou "Reembolso — dia limite 30 (extremo)". Isso facilita identificar lacunas na cobertura rapidamente.

Executando e revisando resultados

Depois de executar um teste, ele aparece no painel Testes no lado direito com um indicador de status:

Executando: O teste está sendo executado ativamente.
Aprovado: O teste foi executado e atendeu com sucesso a todos os critérios de sucesso definidos.
Falhou: O teste foi executado, mas não atendeu aos critérios de sucesso definidos.
Na fila: O teste foi iniciado, mas está aguardando a simulação anterior terminar antes de executar.

Para investigar um resultado, clique em Ver conversa. Isso abre a transcrição completa da troca entre o cliente simulado e Fin, facilitando ver exatamente como o fluxo ocorreu e por que o teste passou ou falhou.

Depurando uma simulação que falhou

Quando uma simulação é marcada como Falhou, a transcrição disponível via Ver conversa contém tudo que você precisa para identificar a causa raiz. Veja como lê-la efetivamente:

Pensamentos do Fin
Em cada passo da conversa, expanda o raciocínio do Fin para ver como ele interpretou a mensagem do cliente, qual passo do Procedimento estava executando e qual decisão tomou. Se Fin seguiu um caminho inesperado, seus pensamentos geralmente mostram exatamente onde sua interpretação divergiu da sua intenção. Procure passos onde a interpretação de um atributo ou condição pelo Fin não corresponde ao esperado.
Eventos da conversa
Eventos da conversa aparecem na transcrição e mostram ações de baixo nível, como atualizações de atributos, chamadas de Conector de Dados e gatilhos de transferência. Use-os para verificar se os conectores certos foram acionados no momento certo e se os atributos foram definidos com os valores esperados antes de cada passo de ramificação.
Localizando a falha
Cruze o que você vê nos pensamentos do Fin e nos eventos da conversa com seus critérios de sucesso definidos. Um padrão comum é um passo Condition avaliando para o ramo errado — tipicamente porque um atributo estava vazio ou tinha um valor inesperado. Verifique sua configuração Customer data available to Fin para garantir que todos os atributos necessários foram preenchidos antes da simulação ser executada.

Dica: Após identificar a causa, ajuste seu Procedimento ou configuração da simulação e clique em Executar na mesma simulação para re-testar imediatamente. Não é necessário criar uma nova simulação — a existente mantém sua configuração.

Limites de uso da simulação

Há um limite para o número de simulações que você pode executar a cada mês. Esse limite é aplicado no nível do workspace e é reiniciado no primeiro dia de cada mês do calendário.

Cada workspace recebe uma cota mensal de execuções de Simulação. A cota é baseada no segmento de volume de conversas do seu workspace, com clientes maiores recebendo cotas maiores.

A cota de simulação é baseada no volume de conversas do seu workspace no Intercom.

Atribuímos seu workspace a um segmento usando o número de conversas no último mês do calendário.
Seu segmento é reavaliado mensalmente e sua cota refletirá o volume de conversas do mês mais recente.
Se o volume de conversas aumentar ou diminuir, sua cota de Simulação pode mudar no próximo ciclo mensal.

Segmento de Volume de Conversas	Limite de Simulação por mês
Menos de 1K	250
1K–15K	1.000
15K–100K	1.750
100K–1M	5.000
1M+	12.500

Monitorando seu uso

Para ajudar você a gerenciar seus testes, Fin fornece indicadores visuais na aba Simulations:

Aviso de uso

Quando seu workspace atingir 80% do limite mensal, um banner amarelo de aviso aparecerá. Ele mostra seu uso atual (ex.: "85/100") e lembra quando o limite será reiniciado.

Limite atingido

Quando você atingir 100% do limite mensal, uma mensagem de erro vermelha aparecerá. Você não poderá executar mais simulações até o início do próximo mês.

Nota: Se você atingir seu limite, ainda poderá revisar resultados e transcrições de simulações anteriores clicando em See conversation, mas os botões Run e Run all ficarão desativados.

FAQs

As simulações interagem com minhas APIs ao vivo ou dados externos?

Não. Diferente da ferramenta Preview, as simulações não acessam APIs reais ou sistemas externos (como Shopify ou Stripe). Não é possível ler ou alterar dados em uma API externa durante uma simulação. Isso garante que você possa testar a lógica com segurança sem impactar dados reais.

Por que usar Simulations em vez de testes manuais?

Simulations permitem validar Procedures em escala e garantir que Fin funcione de forma confiável em cenários complexos e de alto risco — diferente dos testes manuais, que são melhores para verificações rápidas ou revisões de configuração. Executar Simulations antes de cada lançamento ajuda a detectar comportamentos inesperados cedo.

O que acontece se uma Simulation falhar?

Uma Simulation que falhou pode ser revisada completamente — abra a conversa simulada para entender por que Fin não se comportou como esperado, ajuste seu Procedure e execute a Simulation novamente sem impactar os clientes.

Por que minha simulação está marcada como "Failed" mesmo que Fin tenha resolvido o problema?

Uma Simulation marcada como "Failed" apesar de Fin ter resolvido o problema geralmente significa que seus Success Criteria são muito rígidos. Por exemplo, se você exige que Fin "Peça um Order ID", mas Fin é inteligente o suficiente para encontrar o ID automaticamente, o teste falhará porque Fin pulou a pergunta. Atualize seus critérios para focar no resultado final (ex.: "Procedure finalizado") em vez de exigir etapas intermediárias específicas.

Fin para no meio da simulação. Por que está travando?

Fin frequentemente para se encontrar um "beco sem saída" nas suas instruções, como verificar uma variável que está vazia (ex.: People.signed_up). Se você não disse ao Fin o que fazer quando os dados estiverem faltando, ele para. Garanta que suas instruções tenham um plano de "fallback", como: "Verifique se a variável tem valor. Se estiver vazia, pergunte ao cliente a data."

Onde devo inserir dados de teste como "Sign up dates" ou "Order history"?

Dados de teste como datas de inscrição ou histórico de pedidos devem ser inseridos na seção Customer data available to Fin da configuração da simulação — não na mensagem inicial do Customer ou nos campos Additional details, pois Fin pode não percebê-los. Insira valores exatos (ex.: 2024-06-01) nos Attributes ou Variables específicos que você está testando.

Minha ferramenta funciona na vida real, mas falha na simulação. Por quê?

Simulations não buscam dados reais de sistemas externos, então seu Data Connector não retornará resultados ao vivo como em uma conversa real. Se seu conector funciona em conversas ao vivo mas falha na simulação, provavelmente é porque os valores esperados não foram definidos na seção Customer data available to Fin. Adicione os dados que seu conector normalmente retornaria como valores de teste lá e execute a simulação novamente.

Simulations são cobradas separadamente dos Procedures?

Simulations estão incluídas com os Procedures e não são cobradas como item separado. Você não terá cobranças adicionais por executar simulações.

Por que devo testar meu Procedure por Email?

Testar seu Procedure por Email valida comportamentos específicos do canal que diferem do Messenger. No Email, Fin agrega várias informações em um único email em vez de enviar várias mensagens. Guidance e Content também podem ser direcionados a canais específicos — por exemplo, respostas por Email podem usar um tom mais formal ou incluir uma introdução específica. Simular conversas por Email permite validar esse comportamento e implantar com confiança.

Por que há um limite para execuções de Simulation?

Cada execução de simulation requer recursos para gerar previsões precisas de AI. Fornecemos uma cota mensal para garantir que você possa testar seus Procedures livremente para casos padrão, evitando que uso extremo gere custos excessivos.

Posso simular um sub-procedure independentemente?

Não. Sub-procedures não têm painel de simulação próprio e não podem ser executados isoladamente. Para testar um sub-procedure, execute uma simulação no Procedure pai e configure o cenário para que o caminho de execução alcance o sub-procedure — definindo a mensagem do customer, atributos e detalhes adicionais para acionar o ramo específico que o chama.

Se você tiver múltiplos sub-procedures dentro do mesmo pai, crie uma simulação separada para cada um, com cada simulação cobrindo o cenário que leva à chamada daquele sub-procedure.

Meu Data Connector retorna resultados vazios na simulação. O que devo fazer?

Resultados vazios do Data Connector em simulação geralmente são causados por falta de dados de teste. Simulations não buscam dados ao vivo de sistemas externos — você precisa definir os valores que seu Data Connector deve retornar na seção Customer data available to Fin da configuração da simulação. Verifique se você preencheu os campos relevantes do Data Connector com os valores de teste que deseja que Fin use.

Se você está testando intencionalmente o caminho 'connector returns nothing', esse é o comportamento esperado — e exatamente o que você deve testar. Certifique-se de que seu Procedure tenha um passo @Condition de fallback que lide com respostas vazias do conector:

Se o conector retornar vazio mesmo para um usuário com dados reais, verifique se seu contato de teste tem um external_id válido que corresponda ao identificador do cliente no seu sistema externo.

Quantas simulações posso executar por mês?

Sua cota mensal de execuções de Simulation depende do volume de conversas do seu workspace no Intercom durante o mês calendário anterior. O limite é aplicado no nível do workspace e reinicia no primeiro dia de cada mês:

Segmento de Volume de Conversas	Limite de Simulations por mês
Menos de 1K	250
1K–15K	1.000
15K–100K	1.750
100K–1M	5.000
1M+	12.500

Quando meu limite de simulação é reiniciado?

Sua cota de Simulation é reiniciada no primeiro dia de cada mês do calendário, independentemente de quando você entrou ou quantas simulações usou. As execuções não utilizadas não são acumuladas — sua cota começa do zero a cada mês.

Posso aumentar meu limite de simulação?

Os limites de Simulation são definidos automaticamente com base no volume de conversas do seu workspace e reavaliados no início de cada mês do calendário. Se o volume de conversas crescer, sua cota aumentará no próximo ciclo mensal — não há opção para comprar execuções adicionais manualmente ou aumentar seu limite fora desse sistema de níveis. Se você atingir seu limite mensal antes da data de reinício, ainda poderá revisar resultados e transcrições de simulações anteriores, mas os botões Run e Run all ficarão desativados até que sua cota seja reiniciada.

Execute Simulações para Procedimentos Fin