Documentações

input-cpf

3 min read

Nota esboço para estudo de conceito

input.cpf

Variável 🔴 CRÍTICA | 🔒 SENSÍVEL

Descrição

CPF do lead obtido como entrada inicial do fluxo. Esta variável é obrigatória e serve como identificador principal do lead/cliente no sistema. É uma variável de entrada que é mapeada para flow.cpf no início do processamento e posteriormente pode ser persistida como user.cpf para uso global no contexto do usuário.

Especificações Técnicas

PropriedadeValor
Escopoinput
Tipo de DadoString
Formato11 dígitos numéricos, sem formatação (sem pontos ou hífen)
Exemplo12345678901
Crítica✅ Sim
Sensível✅ Sim (pii)

Origem

Tipo: Input de Usuário
Detalhes: Obtido através de arquivo Excel de entrada (.xlsx) no fluxo de disparo RCS, ou entrada direta via interface do Hyperflow. A variável é coletada no nó inicial 1-flow-variables do fluxo disparo-rcs.

Uso nos Fluxos

disparo-rcs

  • Nós: 1-flow-variables, 2-user-variables---salvar-variaveis-de-user, 18-request---lead-input hyperflow-unified-lead-3
  • Propósito:
    • No nó 1-flow-variables: Mapeia input.cpf para flow.cpf (variável de contexto do fluxo)
    • No nó 2-user-variables: Persiste flow.cpf como user.cpf para uso global no contexto do usuário
    • No nó 18-request: Envia o CPF para o webhook N8N lead-input/hyperflow-unified-lead para processamento e busca de dados do lead no HubSpot

Persistência de Dados

HubSpot

  • Campo: cpf_unico_sync
  • Operação: SELECT (busca de deals existentes), potencialmente CREATE/UPDATE em novos leads

Dependências

Variáveis Relacionadas:

  • N/A (variável de entrada inicial, não depende de outras variáveis)

Variáveis que dependem desta:

  • flow-cpf - flow.cpf é criado a partir de input.cpf
  • user.cpf - criado a partir de flow.cpf (que vem de input.cpf)

Validações e Regras

  • Obrigatória: Sim, o fluxo não pode prosseguir sem um CPF válido
  • Formato: Deve conter exatamente 11 dígitos numéricos (sem formatação)
  • Validação de existência: No nó 19b-conditional-validacao-hubspot, o sistema verifica se input.body.cpf é undefined ou null para determinar se o lead foi encontrado na base
  • Validação de negócio: Se o CPF não for encontrado ou for inválido, o fluxo segue para tratamento de erro (19a-flow-variable---lead-input-error)

Impacto de Falha

Se esta variável falhar/for null ou undefined:

  1. Fluxo interrompido: O fluxo não pode prosseguir, pois o CPF é obrigatório para identificação do lead
  2. Erro no lead-input: A requisição para o webhook N8N falhará ou retornará erro, ativando o branch de erro (19a-flow-variable---lead-input-error)
  3. Sem identificação: Impossibilidade de buscar dados do lead no HubSpot ou criar novos registros
  4. Sem persistência: Não será possível salvar o CPF no contexto do usuário (user.cpf)
  5. Impacto em analytics: Eventos de analytics não poderão ser rastreados corretamente sem identificação do lead

Observações Técnicas

Escopo de uso:

  • A variável é transformada de input.cpf → flow.cpf → user.cpf ao longo do fluxo
  • No nó 1-flow-variables, o valor é mapeado diretamente: "cpf": "{{input.cpf}}"
  • O CPF é enviado no body da requisição HTTP para o webhook N8N no formato: "cpf": "{{flow.cpf}}"
  • Variável relacionada mas diferente: input.body.cpf é uma variável distinta que vem da resposta HTTP do webhook lead-input (nó 18-request), não é uma entrada inicial. A validação de existência do CPF na base é feita através desta resposta, verificando se input.body.cpf está presente e não é null/undefined
  • Esta variável contém dados pessoais sensíveis (PII) e deve ser tratada de acordo com LGPD/GDPR

Esta seção será preenchida automaticamente pelo Obsidian com links de notas que referenciam esta variável

Graph View