Campos personalizados em fluxos

Campos personalizados sao variaveis que armazenam informacoes especificas do lead (cidade, interesse, valor da compra). Sao a forma de fazer fluxos personalizados, em que cada cliente recebe mensagens com dados proprios.

Para ver a lista completa de campos disponiveis (do sistema + personalizados criados na conta), va em Configurações > Campos.

Onde nascem os campos personalizados

Diferente de etiquetas e departamentos, campos personalizados nao sao criados em uma tela de configuracao. Eles nascem em dois lugares:

Via Bate Papo — editar dados do lead

Durante o atendimento humano, ao abrir um lead e editar seus dados, voce pode adicionar um novo campo (ex: cidade, valor_orcamento). Ele passa a existir para todos os leads da conta.

Via Fluxo — blocos Salvar e Manipulador

Os dois blocos do Flowbuilder que criam campos personalizados sao:

• Salvar — captura a resposta do cliente e armazena num campo nomeado.
• Manipulador — define/altera o valor de um campo sem precisar perguntar ao cliente.

Exemplo: coletando dados em sequencia

Fluxo de boas-vindas que coleta nome e cidade:

1. Conteudo: “Ola! Qual seu nome?”
2. Salvar com Nome do campo: nome_lead
3. Conteudo: “Prazer, [nome_lead]! Em qual cidade voce esta?”
4. Salvar com Nome do campo: cidade_lead
5. Conteudo: “Atendemos em [cidade_lead]? Confirme.”

A cada execucao do fluxo:

• A primeira vez que algum cliente passa pelos blocos Salvar, os campos nome_lead e cidade_lead passam a existir na conta.
• O valor de cada campo e gravado no perfil daquele lead.
• Nas mensagens seguintes, a sintaxe de interpolacao do flowbuilder substitui o nome do campo pelo valor real.

A sintaxe exata de interpolacao no Flowbuilder e mostrada pelo autocomplete do editor de mensagem. Quando voce digita o nome do campo, o flowbuilder formata corretamente.

Diferenca entre os tres “tipos de variavel” do Sagazchat

Tipo	Escopo	Onde criar	Onde usar
Campo personalizado	Por lead — cada cliente tem seu valor.	Bate Papo ou bloco Salvar/Manipulador.	Mensagens de fluxo, audiencia, relatorios.
Variavel global	Por empresa — valor unico para toda a conta.	Configuracoes > Variavel global.	Mensagens de fluxo, condicoes.
Campo do sistema	Por lead — nome, email, data, saudacao etc.	Ja existe na conta — nao criar.	Igual ao campo personalizado.

Use campo personalizado quando o valor muda por cliente. Use variavel global quando e a mesma informacao para toda a empresa (ex: link do checkout, telefone do gestor).

Boas praticas

• snake_case sem acentos: valor_compra, cidade_lead, data_aniversario.
• Prefixo por contexto: compra_valor, compra_produto, compra_data — facilita buscar tudo de “compra”.
• Tipo no nome: email_secundario, tel_whatsapp — explicitam o que cada campo guarda.
• Padronize antes de criar: uma vez existindo no sistema, campos criados com erro de digitacao ficam la. Combine convencao com o time antes de sair criando.

Onde NAO funciona interpolacao

• Respostas rapidas — texto e literal, sem substituicao.
• Mensagem fora de horario (Configurações > Horários > Ação > Mensagem) — provavelmente literal tambem.

Se precisa de mensagem personalizada fora do fluxo, use Fluxo como acao em vez de Mensagem.

Onde gerenciar

A listagem de campos esta em Configurações > Campos. A criacao sempre acontece via Bate Papo ou blocos do Flowbuilder.