Gatilho: Registro concluído

O gatilho Registro concluído (record.completed) inicia um workflow quando um registro dos seus módulos de CRM, Projetos ou Quadros — uma tarefa, um negócio, um item de quadro — é marcado como concluído ou "feito". É útil para automatizar o próximo passo de um processo assim que uma etapa se fecha: avisar a equipe, disparar uma pesquisa de satisfação ou criar o próximo registro da sequência.

Quando dispara

Dispara quando o status do registro muda para concluído, seja essa alteração feita por um usuário na interface ou por uma integração via API.

Requisitos

• Ter o módulo correspondente ativo (Quadros, CRM ou Projetos) com pelo menos um registro.

Configuração do gatilho

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

Variáveis disponíveis

• $record.object_type — Tipo de registro (contact, deal, task, item…)
• $record.object_id — ID do registro
• $record.workspace_id — Workspace do registro

Exemplo

Um workflow disparado por record.completed com Tipo de registro = task: quando uma tarefa de onboarding de cliente é concluída, o workflow publica uma mensagem no Espaço de Team "Onboarding" avisando à equipe que esse cliente terminou o processo.

Dicas

• Combine com record.stage_changed se o seu processo tem várias etapas antes de chegar a "concluído" e você precisa reagir a cada uma delas.
• Para negócios de CRM, considere também o gatilho semântico "Negócio ganho" (deal.won), mais específico do que este genérico.

Solução de problemas

Se o workflow não disparar ao marcar manualmente um item como feito num Quadro, confirme que a coluna usada realmente representa o status "concluído" do item, e não apenas uma etiqueta visual.