Documentações

user-cpf

4 min read

Nota esboço para estudo de conceito

user.cpf

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

Descrição

CPF do lead persistido no contexto global do usuário no Hyperflow. Esta variável é uma variável de contexto persistente que mantém o CPF do usuário durante toda a sessão e entre diferentes fluxos. Diferente de flow.cpf (que é local ao fluxo), user.cpf é global e pode ser acessado por qualquer fluxo que tenha acesso ao contexto do usuário.

Especificações Técnicas

PropriedadeValor
Escopouser
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: Processamento Interno
Detalhes: Esta variável é criada através do processamento interno do Hyperflow. No fluxo disparo-rcs, é criada no nó 2-user-variables---salvar-variaveis-de-user a partir de flow.cpf (que por sua vez vem de input.cpf). Em outros fluxos como transbordo-app, a variável já existe no contexto do usuário e é utilizada diretamente.

Uso nos Fluxos

disparo-rcs

  • Nós: 2-user-variables---salvar-variaveis-de-user
  • Propósito:
    • No nó 2-user-variables: Persiste flow.cpf como user.cpf para uso global no contexto do usuário. Esta variável é salva para permitir identificação e consultas em fluxos subsequentes.

transbordo-app

  • Nós: 1-flow—salvar-variáveis-do-csv, 8b-request-procurar- acompanhamento
  • Propósito:
    • No nó 1-flow--salvar-variáveis-do-csv: Mapeia user.cpf para flow.cpf para uso no fluxo atual
    • No nó 8b-request-procurar- acompanhamento: Utiliza flow.cpf (que vem de user.cpf) para buscar deals relacionados nas últimas 15 horas através do webhook cpf-deals-konsigleads. O CPF é enviado como parâmetro na query string da URL: ?cpf={{flow.cpf}}

Persistência de Dados

HubSpot

  • Campo: cpf_unico_sync
  • Operação: SELECT (busca de deals existentes através do webhook cpf-deals-konsigleads)

Nota: O CPF deve estar no formato esperado pelo HubSpot (cpf_unico_sync) para que as buscas funcionem corretamente.

Dependências

Variáveis Relacionadas:

  • input-cpf - No fluxo disparo-rcs, user.cpf é criado a partir de flow.cpf, que vem de input.cpf
  • flow-cpf - user.cpf é criado a partir de flow.cpf no fluxo disparo-rcs

Variáveis que dependem desta:

  • flow.cpf - No fluxo transbordo-app, flow.cpf é criado a partir de user.cpf

Validações e Regras

  • Obrigatória: Sim, especialmente no fluxo transbordo-app onde é obrigatória para busca de acompanhamentos
  • Formato: Deve conter exatamente 11 dígitos numéricos (sem formatação)
  • Formato HubSpot: Deve estar no formato esperado pelo HubSpot (cpf_unico_sync) para que as buscas funcionem corretamente
  • Validação de formato: Não há validação de formato do CPF antes da busca no fluxo transbordo-app (pode ser uma melhoria futura)

Impacto de Falha

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

  1. Fluxo transbordo-app interrompido: A busca de deals relacionados não poderá ser realizada, impedindo a verificação de acompanhamentos existentes
  2. Sem identificação do usuário: Impossibilidade de identificar o usuário em fluxos subsequentes
  3. Erro na busca de deals: O webhook cpf-deals-konsigleads não poderá buscar deals relacionados, afetando a lógica de decisão do fluxo
  4. Impacto em analytics: Eventos de analytics não poderão ser rastreados corretamente sem identificação do usuário
  5. Perda de contexto: A persistência do CPF no contexto do usuário permite que diferentes fluxos identifiquem o mesmo usuário, sem essa variável essa capacidade é perdida

Observações Técnicas

  • Persistência global: Diferente de flow.cpf (que é local ao fluxo), user.cpf persiste no contexto global do usuário e pode ser acessado por qualquer fluxo
  • Criação no disparo-rcs: No fluxo disparo-rcs, a variável é criada no nó 2-user-variables através do mapeamento: user.cpf = flow.cpf
  • Uso no transbordo-app: No fluxo transbordo-app, a variável já existe no contexto do usuário e é mapeada para flow.cpf no nó 1-flow--salvar-variáveis-do-csv através de: flow.cpf = user.cpf
  • Busca de deals: No fluxo transbordo-app, o CPF é usado para buscar deals criados nas últimas 15 horas com fup_id preenchido através do webhook cpf-deals-konsigleads
  • Formato: O CPF deve estar no formato esperado pelo HubSpot (cpf_unico_sync) para que as buscas funcionem corretamente
  • Dados sensíveis: Esta variável contém dados pessoais sensíveis (PII) e deve ser tratada de acordo com LGPD/GDPR
  • Validação ausente: Não há validação de formato do CPF antes da busca no fluxo transbordo-app, o que pode ser uma melhoria futura

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

Graph View