Gatilho: Registro vencido

O gatilho Registro vencido (record.overdue) inicia um workflow quando um registro com prazo — uma tarefa, um item de quadro — ultrapassa a data limite sem ser marcado como concluído. Não é um evento instantâneo do usuário: é alimentado por uma varredura programada que verifica periodicamente registros com vencimento configurado (o mesmo mecanismo por trás do boards:detect-overdue).

Quando dispara

Dispara na execução periódica da varredura de vencidos, na primeira vez que detecta que o prazo do registro já passou e ele continua incompleto.

Requisitos

• Registros com uma data de vencimento configurada (em Quadros ou no módulo de Projetos/CRM correspondente).

Configuração do gatilho

• Tipo de registro: deixe em branco para qualquer tipo, ou especifique um (task, item, deal) para restringir o disparo.

Variáveis disponíveis

• $record.object_type — Tipo do registro vencido
• $record.object_id — ID do registro
• $record.workspace_id — Workspace do registro

Exemplo

Um workflow disparado por record.overdue com Tipo de registro = task: quando uma tarefa de um projeto vence sem ser concluída, o workflow reatribui a tarefa ao responsável da equipe e publica uma mensagem no Team marcando-o para retomar com prioridade.

Dicas

• Considere gatilhos semânticos como deal.no_activity se o seu caso específico for negócios de CRM parados, em vez do genérico record.overdue.
• Este gatilho depende de um cron interno — se a varredura do seu workspace tiver atraso, o disparo pode esperar até o próximo ciclo agendado, sem ser instantâneo no momento exato do vencimento.

Solução de problemas

Se um registro vencido nunca dispara o workflow, confirme que ele realmente tem uma data limite configurada (não apenas uma data de criação) e que a varredura correspondente está ativa no workspace.