Mover etapa: como usar o bloco | Conecta-se

O que faz

Leva o negócio aberto do contato para outra etapa do funil, conferindo antes os campos obrigatórios da etapa.

Quando usar: Use quando a conversa mostrar que o negócio avançou, por exemplo depois que o cliente aceita uma proposta, para levar o negócio à etapa certa sem ninguém arrastar o cartão.

Exemplo de situação: Depois de coletar o segmento e o tamanho da empresa, o fluxo move o negócio de Novo para Qualificado. Se a etapa exigir um campo que ainda falta, o fluxo pergunta antes de mover.

O fluxo nunca ganha nem perde negócio: só move entre etapas abertas. Ganho e perda ficam com a equipe.

Antes de começar

Conexão necessária: CRM do workspace ligado.

Adicione **Mover etapa** a partir da seção CRM e escolha a etapa de destino.

Passo a passo

Ligue o CRM do workspace em Vendas. Com o CRM desligado, a seção CRM some da aba Blocos e os blocos que já estão no fluxo seguem sem fazer nada, com o motivo no registro do fluxo.
Adicione Mover etapa a partir da seção CRM e escolha a etapa de destino.
Ligue a saída Faltam campos a perguntas que preencham os campos obrigatórios da etapa e volte para este bloco depois do Salvar no campo.
Deixe o campo Negócio vazio para usar o negócio guardado pelo Criar ou atualizar negócio ou o negócio aberto do contato.

Campos

Etapa de destino
Obrigatório
Etapa aberta para onde o negócio vai. Pode ser de outro funil.
Exemplo:
(escolha na lista do campo)
Negócio (variável)
Em campos adicionais
Vazio usa o negócio guardado pelo Criar ou atualizar negócio ou, sem ele, o negócio aberto do contato desta conversa.
Exemplo:
<fluxo.negocioId>

Saídas

Caminhos do bloco

MovidoO negócio está na etapa de destino (ou já estava, com <moveretapa.jaEstava> verdadeiro).
Faltam camposA etapa exige campos que o negócio não tem. <moveretapa.faltam> lista os nomes, separados por vírgula.
ErroO CRM está desligado, o negócio não existe neste workspace ou o CRM recusou a ação. Sem esta saída ligada, o bloco anota o motivo no registro e segue pela saída padrão.

Para usar um resultado deste bloco em uma etapa seguinte, digite < no campo e escolha o bloco e o campo. A referência tem o formato <moveretapa.negocioId>: antes do ponto vai o nome do bloco no seu fluxo, em minúsculas, sem espaços e sem acentos.

Referência	Tipo	O que contém
`<moveretapa.negocioId>`	string	Id do negócio movido.
`<moveretapa.etapa>`	string	Nome da etapa onde o negócio ficou.
`<moveretapa.jaEstava>`	boolean	Verdadeiro quando o negócio já estava na etapa de destino.
`<moveretapa.faltam>`	string	Nomes dos campos obrigatórios que faltam, separados por vírgula.
`<moveretapa.camposFaltando>`	json	Lista de campos que faltam, com chave e nome.

Exemplo de uso

Objetivo: Qualificar o negócio quando o cliente informa o segmento.

Criar ou atualizar negócioMover etapaFaltam campos: pergunta e Salvar no campoMover etapa de novo

Etapa de destino: Vendas · Qualificado

Os valores são ilustrativos. Teste primeiro com dados fictícios ou de homologação.

Erros comuns e como resolver

O registro do fluxo mostra “O CRM está desligado neste workspace”: Ligue o CRM em Vendas. Enquanto ele estiver desligado, o bloco vai para a saída Erro, se estiver ligada, ou segue pela saída padrão sem gravar nada.
O registro do fluxo mostra “Não há negócio aberto para este contato”: Coloque um bloco Criar ou atualizar negócio antes deste, ou confira se o negócio do contato não foi ganho, perdido ou excluído.
O bloco sempre sai por Faltam campos: Use <moveretapa.faltam> numa mensagem para ver quais campos faltam e grave cada um com Salvar no campo antes de mover de novo.
O bloco não executa: Confira se existe um caminho de setas que parte do gatilho (ou do Início) até este bloco. Blocos soltos no desenho são ignorados.
Aparece “Validação do fluxo” no terminal: Há campo obrigatório vazio. Clique no aviso, abra o bloco indicado e preencha o campo marcado.