Gatilho: Negócio mudou de etapa

O gatilho Negócio mudou de etapa dispara sempre que um negócio do CRM se move de uma etapa para outra dentro do pipeline (por exemplo, de "Qualificação" para "Proposta"). Você pode deixá-lo genérico para qualquer mudança ou restringi-lo a uma etapa de destino específica.

Quando usar

• Enviar automaticamente uma proposta ou orçamento quando o negócio entra na etapa "Proposta".
• Notificar a equipe quando um negócio chega à última etapa antes do fechamento.
• Criar uma tarefa em um projeto do Tableros ao avançar de etapa.

Requisitos

O módulo CRM (Negócios/Pipelines) precisa estar habilitado no workspace.

Filtros disponíveis

• Pipeline específico (opcional).
• Etapa de destino específica: dispara só quando o negócio entra nessa etapa; vazio = qualquer mudança de etapa.

Variáveis disponíveis

• $trigger.deal_id, $trigger.title, $trigger.amount, $trigger.pipeline_id, $trigger.status
• $trigger.stage_name — nome da etapa nova (a que o negócio acabou de assumir).
• $changes.stage_id.old / $changes.stage_id.new — IDs numéricos da etapa anterior e nova.
• $trigger.contact_id + variáveis de contato
• ⚠️ $trigger.column_old / $trigger.column_new — não disponíveis nesse gatilho: essas chaves só são preenchidas para itens de Quadro, não para negócios do CRM. Uma mudança de etapa de negócio nunca as preenche, então se você usar em uma mensagem, o resultado sai vazio. Use $trigger.stage_name (etapa nova, com nome) e/ou $changes.stage_id.old / $changes.stage_id.new (IDs, sem nome) no lugar.

Como criar

1. Acesse Workflows → Novo fluxo de trabalho.
2. Arraste o Gatilho → escolha Negócio mudou de etapa (categoria CRM e registros).
3. Se quiser, escolha o pipeline e a etapa de destino específica.
4. Adicione uma ação usando $trigger.stage_name para personalizar a mensagem com o nome da etapa nova.
5. Salve e ative.

Exemplo

Fluxo "Entrou em Proposta": dispara só quando a etapa de destino específica = Proposta → Avisar equipe: 📄 {{trigger.title}} passou para {{trigger.stage_name}} — preparar orçamento para {{contact.display_name}}.

Dicas

Se cada pipeline representa um produto diferente, filtre por pipeline para que uma equipe não receba os avisos de outra.

Solução de problemas

• Se o fluxo disparar mais vezes do que o esperado, revise a etapa de destino específica — sem esse filtro, o gatilho reage a qualquer mudança de etapa, inclusive retrocessos.
• Se sua mensagem aparece em branco onde você esperava {{$trigger.column_old}} ou {{$trigger.column_new}}: é um problema conhecido, essas variáveis não existem para negócios do CRM (são exclusivas de itens de Quadro). Use {{$trigger.stage_name}} no lugar.