BUC/BUER - Criar Negócio e Contato Check

Visão Geral

Este workflow é um componente crítico de governança de dados no HubSpot. Ele garante que, antes de qualquer interação ou disparo de campanha, o lead possua um Contato e um Negócio (Deal) válidos e atualizados. O fluxo gerencia diferentes origens (App, Web, Planilhas), realiza validação de CPF e verifica se há bloqueios para criação de novos negócios (como negócios já abertos).

Objetivo

• Consistência de Dados: Garantir que todo lead tenha um registro único no HubSpot.
• Prevenção de Duplicidade: Validar CPFs e buscar contatos existentes antes de criar novos.
• Governança de CRM: Controlar a criação de negócios para evitar poluição no pipeline.
• Valor gerado: Dados limpos para o time de vendas e automação de marketing sem disparos duplicados.

Diagrama de Fluxo

graph TD
    1["1-trigger---execute-workflow-trigger"] --> 3{"3-conditional---tem-cpf"}
    1 --> 2["2-execution-data---salvar-dados-na-execucao"]
    
    3 -- "Não" --> 35["35-flow-variable---modelar-resposta-s-cpf"]
    3 -- "Sim" --> 4{"4-conditional---e-do-app-ou-web"}
    
    4 -- "Sim" --> 8["8-code---retornar-contato"]
    4 -- "Não" --> 5["5-flow-variable---salvar-cpf"]
    
    5 --> 6["6-execute-workflow---encontrar-contato"]
    6 --> 7["7-flow-variable---salvar-contato-encontrado"]
    8 --> 7
    
    7 --> 9{"9-conditional---e-do-app-ou-web-1"}
    
    9 -- "Sim" --> 30["30-flow-variable---definir-dados-recebidos-2"]
    9 -- "Não" --> 10["10-flow-variable---salvar-cpf-1"]
    
    10 --> 11["11-execute-workflow---validar-cpf"]
    11 --> 12{"12-conditional---cpf-e-valido"}
    
    12 -- "Não" --> 36["36-stop-and-error---invalid-cpf"]
    12 -- "Sim" --> 13["13-flow-variable---definir-campos"]
    
    13 --> 14{"14-conditional---verificar-existencia-de-contato"}
    
    14 -- "Sim" --> 15["15-flow-variable---selecionar-cpf"]
    15 --> 16["16-execute-workflow---verificar-bloqueio-criar-negocio"]
    16 --> 17{"17-conditional---bloquear-criacao-de-negocio"}
    
    17 -- "Sim" --> 34["34-flow-variable---modelar-resposta"]
    17 -- "Não" --> 18["18-flow-variable---definir-dados-recebidos-1"]
    18 --> 19["19-flow-variable---definir-find-contact-datacontato"]
    19 --> 20["20-execute-workflow---atualizar-contato"]
    20 --> 21["21-flow-variable---salvar-cpf-2"]
    21 --> 22["22-execute-workflow---encontrar-contato-1"]
    22 --> 23["23-flow-variable---salvar-contato-encontrado-1"]
    23 --> 30
    
    30 --> 31["31-flow-variable---definir-contact-id"]
    31 --> 32["32-execute-workflow---criar-negocio"]
    32 --> 33["33-flow-variable---definir-hubspot-contact-already-exists"]
    33 --> 34
    
    14 -- "Não" --> 24["24-code---modelar-dados"]
    24 --> 25["25-execute-workflow---criar-contato"]
    25 --> 26["26-flow-variable---definir-dados-recebidos"]
    26 --> 27["27-execute-workflow---criar-negocio-1"]
    27 --> 28["28-flow-variable---definir-hubspot-contact-already-exists-1"]
    28 --> 29["29-flow-variable---modelar-resposta-1"]

Variáveis do Fluxo

Variáveis de Entrada (Input)

Fluxo Detalhado

Fase 1: Identificação e Roteamento Inicial

Nós: 1 → 3 → 4

O fluxo começa validando a presença do CPF. Se a origem for interna (App), os dados de contato já são aceitos diretamente. Caso contrário, inicia-se uma busca no HubSpot via CPF.

Fase 2: Validação e Verificação de Existência

Nós: 11 → 14

Para leads externos, o CPF passa por uma validação matemática. Em seguida, verifica-se se o contact.id já existe no HubSpot.

Fase 3: Gestão de Contatos e Negócios do CRM

Branch A: Contato Novo Nós: 24 → 25 → 27 Os dados são modelados e um novo contato e negócio são criados.

Branch B: Contato Existente Nós: 16 → 20 → 32 Verifica se há bloqueio para novos negócios. Se não houver, atualiza o contato e cria o negócio. Se houver bloqueio, apenas retorna os dados existentes.

Dependências Externas

Fluxos Chamados (Subflows)

Saída (Output)

O fluxo retorna um objeto padronizado com:

• hubspot.deal_created: boolean
• hubspot.contact_id: string
• hubspot.deal_id: string
• hubspot.contact_already_exists: boolean

Changelog