Quando usar
- Você identificou no dashboard que Erros de Chamada do Fluxo Controlado estão impactando a retenção da ClaudIA
- Você precisa de um roteiro prático para priorizar quais fluxos corrigir primeiro
- Você quer um checklist de análise para auditar fluxos com falhas recorrentes
Pré-requisitos
- Acesso ao dashboard de retenção da ClaudIA
- Permissão para editar fluxos do Fluxo Controlado do projeto
- (Recomendado) Ler antes: Como acompanhar e aumentar a retenção da ClaudIA
Sobre este artigo
Erros de Chamada do Fluxo Controlado são uma das razões de transferências da ClaudIA para agentes humanos. Para validar se o foco deve ser nesses erros, consulte primeiro a FAQ de Retenção da ClaudIA. Este artigo orienta como agir imediatamente nos erros que mais geram transferência, ajudando a reduzir o volume de tickets enviados para humano.
Como usar este guia: leia tudo primeiro para entender os conceitos e o passo a passo. Depois, abra o dashboard para colocar as orientações em prática.
Por onde começar a análise
Dentro do dashboard, acesse a aba Transferido por falha na chamada do Fluxo Controlado. Lá você encontra tabelas que ajudam a identificar rapidamente os maiores impactos na retenção.

Tabelas principais

% de Erros de Chamada do Fluxo Controlado por Fluxo
Mostra, para cada Fluxo Controlado, a porcentagem semanal de tickets que voltaram ao N2 porque o bot falhou.
Dica: analise pela última semana completa e ordene clicando no nome da coluna para ver os maiores ofensores primeiro.

Tickets com Erro de Chamada por Fluxo
Indica quais tickets específicos estão vinculados aos fluxos com falhas. É possível ordenar por nome do fluxo para facilitar análises e auditorias.
Hora de agir
Checklist de análise
-
As integrações/APIs estão corretas?
-
Dados de entrada/variáveis estão validados?
-
Existem condições conflitantes no fluxo?
-
O erro ocorre em fluxos críticos de alto volume?
Sugestões práticas
-
Corrigir fluxos com maior percentual de erros (foco em volume)
-
Criar fallback para evitar má experiência do cliente em casos de falha
Observações
-
Para entender as causas técnicas das falhas: Como identificar e evitar falhas nos fluxos e requisições do Fluxo Controlado
-
Para monitorar fluxos pelo Hub: Como monitorar e melhorar continuamente os fluxos do Fluxo Controlado via Hub
-
Para evitar loops desnecessários no mesmo fluxo: Como configurar o Repeat Handover do Fluxo Controlado
-
Para validar fluxos antes de publicar: Validação de erros nos fluxos do Fluxo Controlado