Skip to main content

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 ferramenta execute_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

Para mover ou fechar deals, o sistema usa find_open_deal_for_conversation para localizar automaticamente o deal aberto vinculado à conversa atual.

Campos principais

Identificação

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.

Tipo de ação

Três variantes disponíveis:

Campos por variante

Criar deal: Mover deal: Fechar deal:
Placeholders disponíveis no título do deal: {contact.name}, {flow_name}, {lead_name}.

Exemplo de uso em fluxo

Cenário — Pipeline B2B completo:
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.

Boas práticas

  • 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.

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.