Diagnóstico e solução de problemas
Comece sempre pela Atividade do agente. Ela permite separar quatro situações diferentes: o evento não chegou, a condição não foi atendida, uma ferramenta falhou ou o resultado foi produzido e não foi entregue pelo canal.
Roteiro de diagnóstico
- Confirme estrutura, agente, gatilho e horário da execução.
- Localize a atividade pelo horário e pelo gatilho.
- Verifique o estado: em andamento, aguardando resposta, concluída, ignorada ou com erro.
- Leia condição, entrada e saída antes de alterar a instrução.
- Confira entrada, saída, erro e duração das etapas.
- Valide o retorno registrado pela etapa de comunicação.
- Abra a edição do agente ativo já salvo e use a ação com ícone de play para fazer um teste com contexto equivalente.
Sintomas mais comuns
| Sintoma | O que conferir | Ação recomendada |
|---|---|---|
| Não há atividade | Agente ativo, escopo de pessoas, gatilho e horário do evento. Em lançamentos, confira também o filtro de categoria. | Corrija a configuração e aguarde um novo evento ou abra a edição do agente ativo para fazer um teste manual. |
| Atividade ignorada | Condição registrada e dados disponíveis na entrada. | Torne a instrução verificável ou ajuste a condição. |
| Tempo fora do horário | Fuso, frequência, dia e horário configurados. | Corrija a configuração de tempo e valide a próxima ocorrência. |
| Novo lançamento não acionou | Pessoa, categoria e escopo. | Compare o lançamento real com o filtro de categoria e com o escopo; mantenha os demais critérios na instrução. |
| B3 ou Open Finance não acionou | Se era a primeira sincronização ou apenas mudança de saldo, preço ou quantidade. | Teste com uma posição realmente nova após a base inicial. |
| Meta ou objetivo repetiu | Ciclo, transição de estado e identidade do evento. | Verifique se houve nova transição válida; preserve os IDs em caso de duplicidade. |
| Ferramenta não foi chamada | Ferramentas selecionadas e decisão registrada. | Adicione a capacidade necessária ou torne a instrução mais explícita. |
| Ferramenta falhou | Argumentos, validação, retorno e duração registrados na etapa. | Corrija dados ou configuração; repita manualmente somente após entender o efeito. |
| Mensagem não foi entregue | Canal, dados de contato e retorno do provedor. | Corrija o cadastro ou o canal; não confunda geração com entrega. |
| Resposta não retomou | Estado aguardando, conversa, validade e mensagem correlacionadas. | No WhatsApp, responda à mensagem original; no iPhone, use Responder no balão do agente; no e-mail, use o link seguro. |
Particularidades dos gatilhos
Primeiro carregamento de investimentos
A primeira sincronização da B3 ou do Open Finance forma uma linha de base. Ela não deve gerar eventos para investimentos antigos. Depois disso, somente um investimento que ainda não existia inicia Novo investimento; atualização de valor não é inclusão.
Metas e objetivos
Uma meta dispara na transição para atingida dentro do ciclo. Um objetivo dispara quando todas as metas ativas e não canceladas vinculadas a ele forem atingidas. Eventos repetidos da mesma transição devem apontar para a mesma identidade de processamento, sem duplicar o efeito.
Resposta recebida
A retomada por resposta pertence à execução que fez a pergunta:
- no iPhone, ocorre no ChatView compartilhado quando a pessoa desliza o balão ou escolhe Responder no menu da mensagem do agente;
- no WhatsApp, usa por até sete dias a relação com a mensagem do provedor;
- no e-mail, usa um link autenticado, de uso único e válido por sete dias.
Quando essa relação não pode ser comprovada, a mensagem permanece na conversa principal da Rica para não contaminar o contexto do agente errado.
Repetição e idempotência
Uma entrega repetida do mesmo evento não deve produzir outra alteração ou mensagem. Quando a infraestrutura recupera uma execução interrompida, o histórico deve continuar associado à atividade original sempre que essa correlação estiver disponível.
Antes de abrir a edição e executar novamente pela ação com ícone de play, verifique se a tentativa anterior teve efeito. Isso é especialmente importante em ferramentas de alteração e comunicação.
Informações para suporte
Registre:
- estrutura e agente;
- horário, gatilho e estado da atividade;
- data e horário com fuso;
- pessoa e canal envolvidos;
- estado, etapa e ferramenta com falha;
- resultado esperado e observado.
Não copie tokens, segredos, documentos completos ou dados não mascarados. Com esses elementos, o suporte consegue reconstruir o fluxo usando a rastreabilidade da execução.