O que é o Bloco CRM Action?
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 ferramentaexecute_crm_action, baseada no contexto e na posição do bloco no fluxo.
Por que usar?
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.).
Quando usar
Use o bloco CRM Action nos momentos em que o estado do negócio muda na conversa. Exemplos típicos:- Depois de enviar uma cotação → mover o deal para “Proposta enviada”
- Quando o cliente confirma compra → fechar como ganho
- Quando o cliente desiste explicitamente → fechar como perdido com motivo
- Quando um lead frio volta → criar novo deal no pipeline de reengajamento
Como funciona
find_open_deal_for_conversation para localizar automaticamente o deal aberto vinculado à conversa atual.
Campos principais
Identificação
Tipo de ação
Três variantes disponíveis:Campos por variante
Criar deal:
Mover deal:
Fechar deal:
Exemplo de uso em fluxo
Cenário — Pipeline B2B completo:- ID da ação:
crm_proposta_enviada - Tipo: Mover deal
- Pipeline: “Novos Leads”
- Stage destino: “Proposta”
Boas práticas
- Use ID de ação descritivo — algo como
crm_proposta_enviadaajuda a debugar,crm_action_1nã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.
Blocos relacionados
Bloco Qualificação
Cria o deal inicial ao qualificar o lead.
Bloco Condição
Decida entre ganho/perdido usando o modo LLM.
Bloco Handoff
Transfira para humano depois de atualizar o deal.
Bloco Roteador
Direcione leads para o fluxo comercial.