Movendo cards e disparando automações por etapa

Mover um card de coluna não é só uma atualização visual: cada movimento atualiza funnel_stage, registra atividade na timeline, dispara as automações de etapa configuradas e pode acionar o envio de eventos para Meta CAPI e Google Ads. Este artigo descreve cada um desses gatilhos e mostra como compor regras úteis.

Drag-and-drop entre etapas

No quadro, basta clicar e arrastar o card para a coluna de destino. A plataforma:

Atualiza funnel_stage e marca um novo stage_entered_at.
Adiciona ao card os checklist_templates da nova etapa (sem duplicar os já existentes).
Registra a atividade na timeline com agente e horário.
Executa as regras stage_automations da etapa de destino via FunnelStageAutomations::Apply.
Dispara o callback send_meta_capi_event e send_google_ads_event (se as integrações estão ativas).
Faz broadcast do kanban_item.updated por ActionCable para todos os agentes conectados.

A movimentação reflete instantaneamente em todos os tipos de visualização (quadro, lista, agenda, mapa).

Catálogo de automações de etapa

Cada etapa pode ter múltiplas regras encadeadas. As ações disponíveis no fork:

Ação	O que faz
`move_to_stage`	Move o card para outra etapa do mesmo funil
`move_to_funnel`	Move para outra etapa de outro funil
`assign_agent`	Atribui um agente específico se ele ainda não estiver no card
`clear_assigned_agents`	Remove todos os agentes do card
`set_item_status`	Define `open`, `won` ou `lost`
`set_item_priority`	Define prioridade (`low`/`medium`/`high`/`urgent`)
`set_item_value`	Atualiza o valor monetário
`set_item_custom_attribute`	Insere ou atualiza um atributo personalizado
`update_checklist`	Marca itens de checklist como completos ou edita texto
`complete_required_checklist`	Conclui todos os itens obrigatórios de uma vez
`create_note`	Adiciona nota interna autorada como "Sistema"
`notify_team`	Registra notificação no log para o time (extensível)
`webhook`	POST JSON para uma URL externa com `event`, `kanban_item_id`, `account_id`, `funnel_id`, `funnel_stage` e payload extra

Há ainda regras de envio de mensagem por canal (template oficial WhatsApp com parâmetros, mídia, conteúdo customizado por etapa) configuradas dentro de message_templates e disparadas pelo handler de templates.

Gatilhos: ao entrar na etapa e por mudança de status

As automações disparam em dois momentos:

Ao entrar na etapa: rodam quando funnel_stage muda, quando o checklist muda, quando agentes mudam ou quando a conversa é vinculada — tratado no handle_stage_enter_automations.
Por mudança de status: regras com trigger_type: status_change disparam quando item_details.status muda para o valor configurado (status_automations).

A regra move_to_stage só executa se todos os itens obrigatórios do checklist estiverem completos, exceto quando a regra vem de uma automação da própria coluna (que pode mover na criação).

Ações em massa

O quadro suporta seleção múltipla via barra de ferramentas. As operações em massa cobrem:

Mover vários cards para outra etapa (BulkMoveModal).
Atribuir agente em lote (BulkAssignAgentModal).
Definir prioridade (BulkSetPriorityModal).
Enviar mensagem em lote (BulkSendMessageModal).
Excluir em massa (BulkDeleteModal).
Importar várias conversas como cards (KanbanImportConversationsModal).
Exportar dados (KanbanExportModal).

Cada operação em massa respeita as automações da etapa de destino — em volume alto, mensagens vão para fila para respeitar limites de canal.

Webhook: integrando com sistemas externos

A ação webhook envia POST JSON com timeout de 5 s. URLs de localhost e 127.x são bloqueadas para evitar SSRF interno. Ideal para notificar ERP, CRM externo ou n8n quando um card avança em uma etapa-chave.

Reverter movimentos

Se mover por engano, mova manualmente de volta. As automações já executadas (mensagens enviadas, eventos de conversão registrados) não são revertidas automaticamente — você precisa cancelar agendamentos pendentes na aba de mensagens agendadas e, se necessário, reenviar correção.

Próximos passos

Continue com Follow-up automático. Para integrar conversões com ad networks ao chegar na etapa Ganho, veja Integração Meta CAPI e Google Ads.