Runbook - Campos personalizados do Sagazchat

Manual operacional para entender e gerenciar Configurações > Campos no Sagazchat. Campos sao variaveis que armazenam informacoes dos leads e podem ser usadas em fluxos, mensagens e relatorios.

Status: validado em 2026-05-11 na conta exemplo. A pagina /fields e somente leitura/listagem — campos personalizados nao sao criados aqui. Regra confirmada pelo administrador: campos sao criados no Bate Papo (editar dados do lead) ou em blocos Salvar / Manipulador dentro do fluxo.

1. Onde fica

• Sidebar: Configurações > Campos
• URL: https://app.sagazchat.com/fields
• Endpoint backend: /fields (provavelmente — nao validado nesta sessao).

2. Estrutura da tela

A pagina /fields tem:

• breadcrumb Painel de controle > Campos;
• campo de busca Procurar por nome;
• tabela com colunas Campo, Descrição, Uso;
• SEM botao “Adicionar” — diferente das outras telas de configuracao.

Quirk: a coluna Uso mostra “X” em todas as linhas. NAO e botao — e texto dentro de <p> com cursor: default. Provavelmente marcacao visual de status (“campo disponivel”). Nao clicavel.

3. Campos do sistema (validados 2026-05-11)

A tela lista 14 campos pre-definidos na conta exemplo:

Campo	Descricao
nome	Nome completo do Lead
pnome	Primeiro nome do Lead
unome	Ultimo nome do Lead
email	Email do Lead
numero	Numero de telefone do Lead
datanascimento	Data de nascimento do Lead
data	Data atual (calculada na hora)
hora	Horario atual (calculado na hora)
saudacao	”Bom dia”, “Boa tarde” ou “Boa noite” conforme horario
horarioescassez1	Aviso: oferta acaba em 1 hora
horarioescassez5	Aviso: oferta acaba em 5 horas
horarioescassez10	Aviso: oferta acaba em 10 horas
horarioescassez24	Aviso: oferta acaba em 24 hora2 (typo do backend — deveria ser “horas”)
horarioescassez48	Aviso: oferta acaba em 48 horas

Esses sao campos do sistema — vem prontos em toda conta Sagazchat, nao podem ser excluidos nem criados pelo usuario.

4. Como sao criados campos personalizados

Regra confirmada pelo administrador: campos personalizados (criados pela empresa, alem dos do sistema) nascem em duas vias:

4.1 Via Bate Papo > Editar dados do lead

1. Abrir conversa no Bate Papo ao vivo.
2. No painel lateral CRM/lead, clicar para editar.
3. Adicionar um campo novo (ex: interesse, cidade, valor_compra).
4. O campo passa a existir no banco da empresa e aparece tambem no painel de outros leads.

Detalhes UI exatos (botao “Adicionar campo”, validacao de nome, tipo) [a validar] — sera mapeado quando auditarmos Bate Papo a fundo.

4.2 Via blocos do fluxo

No Flowbuilder, dois blocos criam/setam campos:

• Salvar — ao definir Nome do campo (ex: qtd_atendentes), o campo e criado quando o fluxo executa pela primeira vez com aquela variavel populada para um lead. Configurar o bloco sem rodar nao cria.
• Manipulador — analogamente, manipula valor de campo existente ou cria novo se nao existir.

Ver runbook fluxos para mecanica detalhada dos blocos.

5. Uso em mensagens

Campos podem ser referenciados em blocos do fluxo (Conteudo, Salvar, etc) para interpolar valor no texto.

Sintaxe: {nome} (chave simples). Confirmado pelo administrador em 2026-05-14. O user-facing antigo usava {{nome_lado}} erroneamente — ignorar.

Importante: variaveis NAO sao interpoladas em:

• Respostas rapidas (texto literal) — confirmado pelo administrador.
• Mensagem de fora de horario (/outOfHours com type=msg) — [a validar, provavelmente texto literal tambem].

6. Acoes seguras e perigosas

Acao	Impacto	Regra
Abrir /fields	Leitura	Seguro.
Buscar campo	Leitura	Seguro.
Criar campo em fluxo (bloco Salvar/Manipulador)	Cria registro permanente	Atencao com nomes — duplicados nao se fundem; criar com erro de digitacao gera bagunca.
Criar campo no Bate Papo	Cria registro permanente	Igual acima.

Nao ha exclusao via UI conhecida. Para limpar campos personalizados criados errado, contatar suporte ou usar API (endpoint nao mapeado).

7. Quirks

• Pagina /fields nao cria nada — so lista campos do sistema (e provavelmente personalizados quando existirem, a validar).
• Coluna Uso = “X” decorativo — nao e botao.
• Typo 24 hora2 no campo horarioescassez24.
• Campos personalizados podem nascer em 2 caminhos (Bate Papo OU fluxo) — fluxo cria so na execucao real.
• Sem interpolacao em Respostas rapidas — fluxo sim.

8. Pendencias

• Validar UI exata de “Editar dados do lead” no Bate Papo — mapeado: clicar no nome do contato com chat aberto abre o painel CRM lateral (direita); lápis ✏️ no header “Dados do contato” edita; seção “Outras informações” lista campos personalizados. Ver sagazchat-bate-papo.md §3.9.
• Validar sintaxe de variavel — resolvido: {nome} (chave simples), confirmado 2026-05-14.
• Capturar endpoint backend que cria campo personalizado.
• Mapear se /fields lista tambem campos personalizados quando existirem.
• Confirmar comportamento de variaveis na mensagem fora de horario (outOfHours.config.msg).

9. Imagens

• public/media/nova-ui/campos-lista.png

10. Scripts validados

node scripts/sagaz-campos-mapear.mjs       # lista
node scripts/sagaz-campos-inspect-x.mjs    # confirma que X nao e botao