O bloco CRM Action permite que o agente execute ações no CRM do Chatwoot durante a conversa — criar um novo deal, mover um deal existente para outra stage ou fechar como ganho/perdido. A IA escolhe quando executar a ação usando a ferramenta execute_crm_action, baseada no contexto e na posição do bloco no fluxo.
Vendedor não precisa clicar para mover o deal de stage
Ganho/perda registrados
Quando o cliente fecha (ou desiste), o deal é atualizado na hora
Rastreabilidade
Cada ação é registrada com origem flow_builder
Para criar um deal ao qualificar, o bloco Qualificação já faz isso nativamente com a “Integração CRM”. Use o CRM Action quando precisar de controle granular em outros pontos do fluxo (mover stage, fechar, criar um segundo deal, etc.).
Fluxo chega no bloco CRM Action ↓IA identifica que é o momento de executar a ação ↓Chama execute_crm_action(action_id=<id>) ↓Sistema resolve a ação configurada: • create_deal → POST /deals • move_deal → encontra deal aberto + muda stage • close_deal → encontra deal aberto + marca ganho/perdido ↓Ação registrada no CRM com fonte "flow_builder"
Para mover ou fechar deals, o sistema usa find_open_deal_for_conversation para localizar automaticamente o deal aberto vinculado à conversa atual.
Identificador estável usado pela IA na chamada da tool
crm_action_proposta_enviada
O ID da ação é referenciado pela IA (execute_crm_action(action_id=...)). Evite renomear depois que o fluxo estiver publicado — isso quebra a referência.
[Roteador] └── "Quer orçamento" ↓ [Qualificação] → cria deal na stage "Qualificado" ↓ [Cotação] ↓ [CRM Action: Proposta enviada] → move para "Proposta" ↓ [Condição LLM: Cliente aceitou?] ├── Sim → [CRM Action: Fechar como ganho] → [Handoff: financeiro] └── Não → [CRM Action: Fechar como perdido] → fim
Configuração do “CRM Action: Proposta enviada”:
ID da ação: crm_proposta_enviada
Tipo: Mover deal
Pipeline: “Novos Leads”
Stage destino: “Proposta”
Quando o fluxo chega nesse bloco (depois da cotação), a IA executa a ação e o deal já criado na Qualificação avança para a stage “Proposta” automaticamente.
Use ID de ação descritivo — algo como crm_proposta_enviada ajuda a debugar, crm_action_1 não.
Para criar o primeiro deal do fluxo, prefira a Integração CRM do bloco Qualificação. O CRM Action é para ações subsequentes.
Em fluxos com múltiplos pontos de fechamento (venda direta vs. transferência para humano), crie um CRM Action para cada cenário.
O owner padrão (atendente da conversa) costuma ser a escolha certa — use “fixo” apenas quando o deal deve ir para uma pessoa específica independente de quem atende.
