Ações Agendadas

Os agentes da REDA AI podem propor ações para serem realizadas no futuro — como enviar um e-mail, criar um registro do Salesforce ou notificar uma equipe. Quando o usuário concorda, o agente cria um registro de Ação Agendada que é executado automaticamente no horário ou evento especificado. Este artigo explica como as ações agendadas funcionam, como visualizá-las e gerenciá-las, e como monitorar sua execução.

O Que São Ações Agendadas?

Uma Ação Agendada é uma tarefa que a IA propõe durante uma conversa e que é executada automaticamente em um momento posterior ou com base em um gatilho. Em vez de criar imediatamente um registro ou enviar uma mensagem, o agente pode agendá-la para depois, dando aos usuários flexibilidade e controle.

Exemplos Comuns de Ação Agendada

• Baseada em tempo: "Criar uma tarefa de lembrete para amanhã às 9h"
• Baseada em tempo: "Enviar um e-mail de acompanhamento ao cliente em 3 dias"
• Baseada em tempo: "Agendar uma solicitação de reunião para a próxima segunda-feira às 14h"
• Baseada em evento: "Enviar um e-mail à equipe de vendas quando chegar uma resposta do cliente"
• Baseada em evento: "Criar uma tarefa de acompanhamento se a oportunidade não avançar para Fechado Ganho em até 14 dias"

Como as Ações Agendadas São Criadas

Durante uma conversa, quando um usuário pede à IA para fazer algo mais tarde, o agente usa a ferramenta schedule_action para criar um registro de Ação Agendada:

1. O usuário pede ao agente para agendar algo — Exemplo: "Lembre-me de fazer o acompanhamento com o John em 2 horas."
2. O agente avalia a solicitação — A IA determina se a solicitação é válida e cria um registro de Ação Agendada usando a ferramenta schedule_action.
3. A ação é armazenada — Um registro de Ação Agendada é criado com os detalhes (tipo de ação, horário de execução, dados a enviar etc.).
4. O agente confirma ao usuário — A IA responde com uma confirmação: "Agendei um lembrete para daqui a 2 horas."
5. O job em lote executa mais tarde — No horário agendado, o job em lote da REDA AI processa a ação (verificando o horário de disparo ou aguardando o evento de disparo).

Tipos de Disparo

As Ações Agendadas suportam dois mecanismos de disparo:

Disparos Baseados em Tempo

Executam em uma data e horário específicos (UTC). O agente especifica um horário de execução alvo, e um job da REDA AI que roda a cada 15 minutos captura qualquer ação cujo horário já chegou:

• Alcance futuro: Pode ser agendado com até 30 dias de antecedência
• Janela de execução: Executado na próxima passagem do job de 15 minutos após o horário agendado — uma ação marcada para 14h00 UTC roda por volta das 14h15 UTC, não de madrugada
• Exemplo: Um horário de disparo de "2026-03-15 14:00:00 UTC" significa que a ação é executada em 15 de março às 14h

Disparos por Resposta de E-mail

Executam quando uma resposta é recebida para um e-mail monitorado. Em vez de um horário específico, o disparo é um evento de resposta de e-mail:

• Monitorar e-mails rastreados: A REDA AI monitora os endereços de e-mail especificados em busca de respostas
• Disparo na resposta: Quando uma resposta é recebida, a ação é executada imediatamente (sem passar pelo job em lote)
• Exemplo: "Executar quando uma resposta for recebida de customer@example.com referente ao Caso X"
• Análise de IA: A REDA AI pode analisar o conteúdo da resposta (usando o Prompt de Análise de IA configurado) para decidir se deve executar ou ignorar a ação

Campos do Registro de Ação Agendada

Acessando as Ações Agendadas

A Partir do Modo de Exibição de Lista de Ações Agendadas

1. Abra o app REDA AI — Clique no Iniciador de aplicativos e selecione REDA AI.
2. Clique no menu "Mais" — Na navegação da REDA AI, clique em Mais (três pontos) para exibir guias adicionais.
3. Selecione "Ações Agendadas" — O modo de exibição de lista mostra todas as ações agendadas na sua organização, ordenadas por horário de disparo ou status.
4. Revise a lista — As colunas incluem Conversa, Status, Horário de Disparo, Tipo de Ação e Mensagem de Erro (em caso de falha).
5. Clique em uma ação para abri-la — O registro da ação mostra os detalhes completos e o histórico de execução.

A Partir de um Registro de Conversa

Ao abrir um registro de conversa, uma seção Ações Agendadas Relacionadas mostra quaisquer ações criadas durante aquela conversa. Clique em uma para visualizá-la.

Entendendo os Status da Ação Agendada

Execução Condicional

Uma ação agendada pode ter uma condição que é verificada novamente no momento em que ela é executada — e não quando foi agendada. É isso que impede que uma ação siga adiante depois que a situação mudou: “enviar o acompanhamento somente se ainda não responderam”, “aplicar isto somente se o registro ainda não foi fechado”. Se a condição não for atendida, a ação é Ignorada e o motivo fica registrado nela.

Como uma condição é montada

Uma condição é uma comparação simples com um campo do registro de contexto da ação. Ela é formada por três partes e não é uma consulta nem uma fórmula:

A ação também precisa ter um registro de contexto (um Id de registro e seu objeto) para que a condição possa lê-lo. Sem ele não há o que verificar, e a ação é ignorada em vez de ser executada sem verificação.

As comparações disponíveis

Estes são valores literais. Digite-os exatamente como mostrado — eles não são traduzidos em nenhum idioma, e qualquer outro valor é rejeitado ao agendar a ação, com uma mensagem informando os valores aceitos.

Um exemplo prático

Um agente agenda um acompanhamento automático para dali a dois dias, mas somente se a oportunidade ainda não tiver sido fechada. Na ação agendada, ele define a oportunidade como registro de contexto e, em seguida:

• Campo da Condição: StageName
• Operador da Condição: not_equals
• Valor da Condição: Closed Won

Dois dias depois, o job lê StageName novamente. Se ainda não for Closed Won, o acompanhamento é enviado. Se alguém tiver fechado a oportunidade nesse meio-tempo, a ação é Ignorada e o registro informa o motivo.

Quando a condição não pode ser verificada

Uma condição existe para impedir uma ação, portanto, se ela não puder ser avaliada, a ação não segue adiante. Ela é Ignorada, com o motivo registrado, em cada um destes casos:

• O operador não é um dos seis acima.
• O campo ou o objeto não existe mais — normalmente porque foi renomeado ou excluído depois que a ação foi agendada.
• Uma condição foi definida, mas a ação não tem registro de contexto para verificá-la.
• O próprio registro de contexto foi excluído.

Se a verificação falhar por um erro temporário, e não por uma condição quebrada, a ação é repetida e só é reportada depois que as tentativas se esgotam. As condições são respeitadas da mesma forma, seja a ação disparada por agendamento ou em resposta a uma resposta de e-mail.

As condições são opcionais. Se nenhuma condição for definida, a ação sempre é executada.

Ações Agrupadas e Cancelamento

Ações agendadas relacionadas podem ser agrupadas de modo que, quando uma é bem-sucedida, as demais são canceladas automaticamente. Isso evita ações duplicadas:

Exemplo de Caso de Uso

Um usuário agenda duas ações de acompanhamento:

1. Ação A: "Enviar lembrete por e-mail se não houver resposta em 3 dias"
2. Ação B: "Enviar lembrete por e-mail se não houver resposta em 5 dias"

Ambas recebem a mesma chave de grupo. Se o cliente responder dentro de 3 dias e a Ação A for executada, a Ação B é cancelada automaticamente — nenhum segundo e-mail é enviado.

Como Funciona

• Quando uma ação de um grupo é executada com sucesso, a REDA AI localiza todas as outras ações pendentes com a mesma chave de grupo
• Essas ações são marcadas como Ignoradas (ou Canceladas) e não são executadas
• Isso evita ações redundantes ou conflitantes

Lógica de repetição para ações com falha

Quando uma ação agendada falha — um erro de API do Salesforce, dados ausentes, um problema de permissão —, a REDA AI a repete, e o mecanismo é mais simples do que parece:

• Número de tentativas: até 3 no total. O campo Retry Count no registro mostra quantas foram feitas.
• Como uma repetição acontece: a falha incrementa o Retry Count e devolve o status para Pending. A ação é então retomada na próxima varredura do job em lote — em até 15 minutos, já que o job roda às :00, :15, :30 e :45.
• Não há espera progressiva. As repetições não são espaçadas em intervalos crescentes, então uma ação que falha sempre esgota as três tentativas em cerca de 45 minutos, não ao longo de dias.
• Após a terceira falha: o status vira Failed e para. A REDA AI grava um Log de incidentes com todo o contexto — nome, tipo, descrição, objeto, registro, contagem de repetições e horário agendado —, então você não precisa reconstruir isso a partir do registro da ação.

Como a janela é curta, Failed normalmente indica um problema real de configuração, e não uma falha passageira — as passageiras se resolvem na segunda tentativa, um quarto de hora depois.

Processamento do Job em Lote

A REDA AI executa um job em lote a cada 15 minutos — quatro entradas de cron, às :00, :15, :30 e :45 — que processa as ações agendadas pendentes:

Ações Baseadas em Tempo

• O job em lote verifica todas as ações baseadas em tempo com status Pendente
• Se o horário de disparo de uma ação já passou, o job em lote tenta executá-la
• Se a execução for bem-sucedida, o status vira Executed. Se falhar, o status volta para Pending para outra tentativa, e só vira Failed após a terceira

Ações de Resposta de E-mail

• O job em lote monitora os endereços de e-mail em busca de respostas
• Quando uma resposta é detectada, o job em lote processa a ação imediatamente (sem esperar pela próxima execução agendada)
• Se um Prompt de Análise de IA estiver definido, a IA analisa a resposta antes de decidir se deve executar

Ações de e-mail, registros e agendamento

Ações de e-mail distinguem o destinatário Contato ou Lead do registro de negócio relacionado, aceitam listas Para/Cc e verificam os casos compatíveis de recusa de e-mail. Contatos/Leads fornecidos como registros relacionados são tratados como destinatários. Confirmações de registros mostram campos não aplicados. As etapas do plano são conciliadas individualmente e horários relativos preservam UTC. Agentes desativados e ações aninhadas não permitidas são verificados antes de executar confirmações. Vínculos de arquivos usam a rota com controle de acesso. Novas ações pendentes ou reagendadas por horário exigem processador disponível; rastreamento de respostas e atualizações normais de histórico/status continuam válidos. Jobs posteriores usam seu proprietário de agendamento, sem personificar o solicitante. Orientações reduzem duplicação por outro conector, mas não garantem o comportamento do assistente.

Perguntas frequentes