Consultar origem do negócio

Consultar a origem registrada do negócio e as referências de anúncios recebidas na conversa, sem confundir ganho com pagamento.

Lógica e processamentoVendas e CRMConexão: CRM do workspace ligado

O que faz

Consulta a referência Meta registrada na origem e os contatos posteriores com anúncios. Não envia conversões nem muda o negócio.

Quando usar: Use para consultar a origem do negócio e identificar anúncios recebidos na conversa antes de decidir o próximo passo.

Exemplo de situação: Um cliente chega por um anúncio do WhatsApp. O fluxo consulta origem.attribution.adId e encaminha o atendimento conforme a origem registrada.

Título do anúncio não é nome da campanha. Referências posteriores não substituem a origem. Ganho comercial não confirma pagamento; a consulta não muda etapas nem envia conversões à Meta.

Antes de começar

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

Escolha o negócio ou use o negócio da conversa.

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.
Escolha o negócio ou use o negócio da conversa.
Leia origem.attribution e origem.touches na saída. Sem referência de anúncio, não invente campanha.
Para obter a campanha, use o ID do anúncio no bloco Meta Ads, operação Identificar campanha de um anúncio, com uma conta autorizada.

Campos

Guardar em
Variável do fluxo com os dados, por exemplo <fluxo.crm.negocio.etapa>.
Padrão:
crm
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

PróximoOrigem e histórico disponíveis na saída origem.
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 <consultarorigemdonegocio.origem>: 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
`<consultarorigemdonegocio.origem>`	json	Origem e referências de anúncios registradas, sem inventar campanha ou atribuir pagamento. Use origem.attribution.adId e origem.attribution.campaignId quando disponíveis.
`<consultarorigemdonegocio.negocio>`	json	Dados do negócio: numero, titulo, funil, etapa, valor, temperatura, responsavel e campos.
`<consultarorigemdonegocio.contato>`	json	Campos escolhidos do contato.

Exemplo de uso

Objetivo: Encaminhar oportunidades conforme a origem registrada.

InícioConsultar origem do negócioCondição pelo ID do anúncioCriar tarefa no CRM

Negócio: Negócio da conversa

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.
No simulador o CRM não mudou: É de propósito: o simulador usa negócios de mentira e só mostra, em Ações, o que o bloco faria. Para gravar de verdade, publique o fluxo.
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.