Diagnóstico e solução de problemas
Comece sempre pelo histórico do agente: Estúdio → Acompanhamento → Agentes, clique no agente e em Ver histórico de atividade. O que aparece ali separa os casos:
- não há cartão: o acontecimento não chegou ou não atendeu às condições;
- há cartão com Falhou: uma ação deu erro, e o detalhe mostra qual;
- há cartão com Aguardando resposta: o agente espera a pessoa;
- há cartão sem estado: o agente terminou, e o detalhe mostra o que ele fez.
O agente não fez nada
| O que conferir | Por quê |
|---|---|
| A chave do agente está em Ativo? | Agente pausado não reage. |
| A pessoa do lançamento ou da mensagem está marcada em Quem o agente acompanha? | O agente só roda para pessoas marcadas. Pessoas incluídas na estrutura depois de salvar ficam de fora. |
| O lançamento atende a Origem, Categorias, Conceitos e Condições? | Casos que não atendem não deixam cartão no histórico. |
| A condição Valor usa o sinal certo? | Saídas do Open Finance são negativas. Para gastos de R$ 500,00 ou mais, use até -500, sem vírgula. Com vírgula, -500,00 é lido como -50.000. |
| O lançamento veio do histórico de uma conexão nova? | O histórico trazido na primeira conexão de um banco não dispara agentes. |
| O agente de Tempo é semanal ou mensal? | Semanal roda só na segunda-feira; mensal, só no dia 1. A execução sai até 5 minutos depois do horário. |
| A posição da B3 ou do Open Finance já existia? | Só posições novas disparam. A primeira sincronização vira a base. |
| A meta já estava em 100% antes do lançamento? | Meta atingida só dispara na passagem para 100%, uma vez por ciclo. |
O agente mandou mensagem a mais
| Sintoma | Causa | O que fazer |
|---|---|---|
| Cada pessoa recebeu a mesma mensagem | Em Tempo e Executar agente agora, o agente roda uma vez para cada pessoa marcada. | Deixe marcada só quem deve receber. |
| Uma mensagem do agente para cada mensagem da pessoa à Rica | Acontecimento Mensagem no WhatsApp ou Mensagem no iOS com ação de envio. | Pause o agente e troque o acontecimento, ou deixe só ações de consulta. |
| A pessoa recebeu mensagem num caso que o texto excluía | O texto não filtra; as ações rodam sempre que o acontecimento atende às condições. | Leve o filtro para Condições do acontecimento. |
| Mensagem duplicada vinda de dois agentes | Dois agentes reagem ao mesmo acontecimento. | Remova ou pause um deles. |
| Mensagens continuam depois de desligar “Receber feedback dos agentes” | A chave não interrompe os agentes. | Pause o agente ou desmarque a pessoa. |
Para parar na hora, abra o agente, desligue Ativo e clique em Salvar agente.
A mensagem não chegou
Abra a ativação e veja a etapa de envio.
| Estado ou mensagem | Causa | O que fazer |
|---|---|---|
| Não enviado no WhatsApp | A pessoa não falou com a Rica nas últimas 24 horas e Mensagens cobradas por WhatsApp está desligada. | Veja limites e custos. |
| “Nao foi possível enviar WhatsApp: a pessoa atual não possui WhatsApp cadastrado.” | Pessoa sem WhatsApp. | Cadastre em Estrutura ou desmarque a pessoa. |
| “A pessoa atual nao possui e-mail cadastrado.” | Pessoa sem e-mail. | Cadastre o e-mail ou desmarque a pessoa. |
| “Pessoa com UsuarioId e obrigatoria para enviar push.” | A pessoa não tem conta na Rica. | Use WhatsApp ou e-mail. |
Push com falha e "dispositivosNotificados": 0 nos dados técnicos | Sem app no iPhone ou sem permissão de notificação. | Peça para instalar o app e permitir notificações. |
| Aceito pelo provedor e o cliente diz que não recebeu | O WhatsApp aceitou, mas a entrega não foi confirmada. | Confira o número da pessoa e se ela bloqueou o contato da Rica. |
Depois de uma falha de envio, as ações seguintes do roteiro não rodam.
A resposta do cliente não retomou o agente
| Situação | O que fazer |
|---|---|
| A pessoa respondeu sem usar Responder na mensagem do agente | Peça para responder citando a mensagem do agente. A resposta solta foi para a conversa com a Rica. |
| Passaram mais de 7 dias | A espera expirou. O agente atua de novo no próximo acontecimento. |
| A pergunta foi por e-mail | A página do botão “Responder ao agente na Rica” não existe mais, então a resposta por e-mail não retoma o agente hoje. Use WhatsApp ou push para perguntas. |
| O agente foi pausado ou removido | Agente pausado ou removido não continua. Reative ou recrie. |
O passo a passo para o cliente está em base.rica.com.br/agentes/responder-e-acompanhar.
A categorização falhou ou ficou estranha
| Mensagem ou sintoma | Causa | O que fazer |
|---|---|---|
| “O lançamento ainda está no processamento inicial de categorização e tipagem.” | Categorizar rodou antes de a Rica terminar a categorização inicial. | Pergunte antes, com Esperar resposta, e categorize com a resposta. |
| “O lançamento recebeu uma alteração mais recente durante a recategorização.” | Alguém mudou o lançamento ao mesmo tempo. | Confira o lançamento em Lançamentos. |
| “Nenhuma categoria existente disponivel na estrutura” | A estrutura não tem categorias. | Crie as categorias em Estrutura. |
| Categoria nova sem relação com a resposta | Usar a resposta da pessoa estava desligado, ou a resposta foi curta demais. | Ligue a opção e peça na pergunta uma descrição do gasto. |
Para corrigir a categoria escolhida pelo agente, abra o lançamento em Estúdio → Lançamentos. O histórico do lançamento mostra a mudança com origem “Agente Rica”.
Erros que interrompem a execução
| Etapa ou mensagem | Causa | O que fazer |
|---|---|---|
| Nova tentativa seguida de Concluída | Falha passageira resolvida na nova tentativa. | Nada. |
| Limite de tentativas atingido | A falha passageira se repetiu 5 vezes. | Aguarde o próximo acontecimento. Se repetir, procure o suporte. |
| “A ação … não foi concluída; o roteiro foi interrompido sem executar ações posteriores.” | Uma ação falhou e as seguintes não rodaram. | Veja a etapa anterior para saber qual ação falhou. |
| “O roteiro excede o limite de 64 ações.” | Roteiro grande demais. | Divida em dois agentes. |
Informações para o suporte
Anote o nome do cliente e do agente, a data e a hora da ativação, o estado e o nome da etapa com falha. Copie a mensagem de erro e o código que aparecem na caixa de erro. Não envie senhas nem documentos do cliente.