🎫 Custom fields e contexto do cliente

Custom field é um placeholder no prompt que é preenchido em runtime com dado do CRM, da sessão ou de um webhook. O mesmo prompt vira personalizado por cliente sem refatoração.

# Contexto do cliente atual
Nome: {{nome}}
Cidade: {{cidade}}
Plano: {{plano}}
Lead score (0-100): {{lead_score}}
Última interação: {{ultima_interacao}}

# Comportamento baseado em contexto
- Se lead_score > 70: trate com prioridade, ofereça contato direto
- Se plano == "trial": destaque benefícios do plano pago
- Se ultima_interacao < 24h: refira sem repetir o que já foi dito

Custom field só é útil se o dado chega certo. As fontes típicas: CRM (Hubspot, RD, Salesforce), banco interno, payload do webhook que iniciou a sessão, cookie ou JWT da sessão web.

Não jogue 50 campos no prompt. Escolha os 5-8 que realmente mudam o comportamento. Cada campo é uma alavanca; campo demais é ruído que custa token.

Campo nem sempre vem preenchido. "{{nome}}" cru no chat é o bug que mais viraliza no Twitter. Defina default e regra de uso para cada campo crítico.

# Regras para campos vazios
- Se {{nome}} vazio: chame de "você" (nunca de "{{nome}}")
- Se {{cidade}} vazia: pergunte na primeira interação relevante
- Se {{lead_score}} vazio: trate como score=50 (neutro)
- Se {{plano}} vazio: assuma plano gratuito

# Sanitização (no backend, antes de injetar)
- Remova chaves curly se valor é null
- Escape caracteres especiais (" \ <)
- Trunque strings > 200 chars

Custom field captura o "perfil". Memória de sessão captura o "agora": preferências aprendidas na conversa atual, decisões tomadas, status da tarefa em andamento.

Custom field carrega dado pessoal direto para o prompt — e o prompt vai para o provedor do LLM. LGPD multa pesado. Provedor pode (e às vezes loga) o prompt para abuse detection.