🇪🇸 Español 🇬🇧 English 🇧🇷 Português

Gatilho: Etapa/status alterado

Inicia um workflow quando um registro de CRM, Projetos ou Quadros muda de etapa ou status.

Jul 11, 2026

O gatilho Etapa/status alterado (record.stage_changed) inicia um workflow quando um registro — um negócio de CRM, uma tarefa, um item de quadro — se move de uma coluna ou etapa para outra. É o gatilho básico para automatizar qualquer processo em etapas: pipelines de vendas, quadros Kanban de suporte ou fluxos de aprovação.

Quando dispara

Dispara assim que a mudança de coluna/etapa é salva, trazendo o valor anterior e o novo.

Requisitos

  • Um registro com uma coluna do tipo etapa/status configurada (pipeline de CRM ou coluna de status num quadro).

Configuração do gatilho

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

Variáveis disponíveis

  • $trigger.column_old — Valor anterior da coluna
  • $trigger.column_new — Valor novo da coluna
  • $record.object_type, $record.object_id, $record.workspace_id

Exemplo

Um workflow disparado por record.stage_changed com Tipo de registro = deal, com uma condição em que $trigger.column_new é "Proposta enviada": o workflow envia automaticamente um WhatsApp ao cliente com o link da proposta e notifica o vendedor responsável.

Dicas

  • Se o seu caso é especificamente um negócio de CRM que passa para "ganho" ou "perdido", use os gatilhos semânticos deal.won / deal.lost em vez de montar a condição manualmente sobre este genérico.
  • Para quadros, existe também board.column_changed para colunas que não são do tipo status — use o que corresponder ao tipo de coluna que você está movendo.

Solução de problemas

Se o workflow não distinguir bem as etapas, verifique se você está comparando com o nome exato da coluna (sensível a maiúsculas/acentos) conforme configurado no pipeline ou quadro.

Isso foi útil?

Artigos relacionados