Ações e pessoas acompanhadas

As ações são o que o agente faz depois do acontecimento: consultar dados, mandar mensagem ou categorizar um lançamento. Elas rodam na ordem em que aparecem no texto, para cada pessoa acompanhada.

Para incluir uma ação, digite / no ponto da frase em que ela deve acontecer ou clique em / Ação. A lista abre sobre o texto; digite em Buscar ações para filtrar. A lista só mostra ações compatíveis com todos os acontecimentos do roteiro. Sem acontecimento, aparece “Incorpore primeiro um acontecimento com @.”

Lista de ações de um agente com o acontecimento Novo lançamento. Ela vem em ordem alfabética e rola para mostrar as outras quatro ações. Categorizar só aparece nesse caso.

Tela real com dados fictícios.

Ações disponíveis

Ação	Ícone	O que faz	O que precisa existir
Consultar lançamentos		Lê os lançamentos de um período.	Lançamentos na estrutura.
Listar objetivos		Lê objetivos, pessoas e metas.	Objetivos na estrutura.
Listar metas		Lê metas, projetos, objetivos e o ciclo atual.	Metas na estrutura.
Detalhar meta		Lê os números e a evolução de uma meta.	Metas na estrutura.
Calcular indicador		Faz um cálculo com os dados da estrutura.	Dados do cliente para o cálculo.
Enviar WhatsApp		Manda mensagem ao WhatsApp da pessoa.	WhatsApp cadastrado na pessoa. Fora da janela de 24 horas, depende de Mensagens cobradas por WhatsApp (veja limites e custos).
Enviar e-mail		Manda e-mail à pessoa.	E-mail cadastrado na pessoa.
Enviar push no iOS		Manda notificação ao app da pessoa. Título até 80 caracteres e texto até 500.	Pessoa com conta na Rica e o app instalado no iPhone.
Categorizar		Reavalia o lançamento e atualiza a categoria e, se marcado, o tipo.	Acontecimento Novo lançamento sozinho no roteiro.

As consultas servem de contexto: a IA dos agentes usa o resultado para redigir as mensagens seguintes. As mensagens vão sempre para a pessoa da execução, no contato cadastrado dela. Um número ou e-mail diferente é recusado.

Opções de cada ação

Clique na ação incorporada no texto para abrir as opções. Feche com Confirmar ou remova com Excluir ação.

Primeira ação do Fiscal Pix: a mensagem pergunta e o agente espera a resposta de Marina.

Tela real com dados fictícios.

Esperar resposta aparece nas três ações de mensagem. Ligue quando a mensagem faz uma pergunta e o restante do roteiro depende da resposta. A execução para depois do envio e continua quando a pessoa responde. Só uma ação por roteiro pode esperar; ao ligar em uma, as outras desligam. A pessoa tem 7 dias para responder.

Em Categorizar há duas chaves:

• Avaliar o tipo também, ligada por padrão: depois da categoria, a Rica avalia se o lançamento é entrada, saída, provisão, investimento ou circular. Desligue para mudar só a categoria.
• Usar a resposta da pessoa, que só aparece quando a ação vem depois de uma espera: a resposta de Marina entra inteira como informação para a categorização.

Categorizar no Fiscal Pix, usando a resposta da pessoa.

Tela real com dados fictícios.

O texto em volta de cada ação orienta a mensagem. “Enviar WhatsApp perguntando do que se trata, em uma frase curta” faz a IA dos agentes escrever uma pergunta curta. As instruções do texto não são enviadas como mensagem literal.

Ordem das ações

As ações rodam exatamente na ordem do texto, uma depois da outra. Se uma falhar, o roteiro para ali e as seguintes não rodam. O resumo Como o agente vai funcionar mostra a ordem: “Percebe”, “Depois” e, depois de uma espera, “Com a resposta”.

No Fiscal Pix:

1. Percebe: Novo lançamento com 1 condição.
2. Depois: Enviar WhatsApp e aguarda a pessoa responder.
3. Com a resposta: Categorizar.
4. Com a resposta: Enviar WhatsApp.

Quem o agente acompanha

O painel Quem o agente acompanha define quem pode despertar o agente e quem recebe as mensagens dele. Todas as pessoas da estrutura começam marcadas. Desmarque quem não deve participar.

O efeito muda com o acontecimento:

• Em Novo lançamento, Mensagem no WhatsApp, Mensagem no iOS e nos investimentos, o agente roda só para a pessoa do acontecimento, se ela estiver marcada. Um Pix de Rafael desperta o Fiscal Pix só para Rafael.
• Em Tempo e em Executar agente agora, o agente roda uma vez para cada pessoa marcada.
• Em Meta atingida e Objetivo atingido, roda para a pessoa do lançamento que levou a meta a 100%.

Exemplo: na Família Costa, Lia tem 5 anos e não tem WhatsApp, e-mail nem app. Ana desmarca Lia em todos os agentes. Se Lia ficasse marcada num agente de Tempo com Enviar WhatsApp, toda semana haveria uma execução com falha para ela.

Pessoas novas ficam de fora

A lista de pessoas é gravada quando você salva. Quem for incluído depois na estrutura não entra sozinho no agente. Abra o agente, marque a pessoa e salve de novo.

Combinar ações e acontecimentos

Acontecimento	Ações que aparecem
Novo lançamento sozinho	Todas, inclusive Categorizar.
Qualquer outro, ou Novo lançamento junto com outro	Todas, menos Categorizar.

Para revisar metas com consulta e mensagem, combine Tempo + Listar metas + Enviar push no iOS. Para entender um gasto, use Novo lançamento + Enviar WhatsApp com espera + Categorizar. Veja os roteiros completos em exemplos com a Família Costa.

Como conferir o que cada ação fez

Abra Ver histórico de atividade e clique na ativação. Em O que aconteceu, cada ação aparece com o estado. Nas mensagens de WhatsApp, o estado mostra se a mensagem foi aceita, entregue ou lida. A leitura completa está em histórico de atividade e respostas.

Uma categorização feita pelo agente também aparece no histórico do lançamento, em Estúdio → Lançamentos, com a origem “Agente Rica”.

Se uma ação falhou

Mensagem no histórico	Causa	O que fazer
“Nao foi possível enviar WhatsApp: a pessoa atual não possui WhatsApp cadastrado.”	Pessoa sem WhatsApp.	Cadastre o WhatsApp 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 para essa pessoa.
Push com falha e, nos dados técnicos, "dispositivosNotificados": 0	A pessoa não tem o app no iPhone ou não permitiu notificações.	Peça para ela instalar o app e permitir notificações, ou use outro canal.
Estado Não enviado numa mensagem de WhatsApp	A pessoa não falou com a Rica nas últimas 24 horas e as mensagens cobradas estão desligadas.	Veja limites e custos.
“O lançamento ainda está no processamento inicial de categorização e tipagem.”	Categorizar rodou antes de a Rica terminar a categorização inicial.	Coloque uma pergunta com Esperar resposta antes de Categorizar, como no Fiscal Pix.
“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 Estúdio → Lançamentos.