Campos Personalizados

Crie, edite e exclua campos personalizados que aparecem no chat para registrar informações do cliente. Opcionalmente, defina instruções para a IA preencher automaticamente durante as conversas.

codeChat
labelCadastro
schooliniciante
error
schedule2026-03-13
notes

Para que serve

Use campos personalizados para coletar informações dos clientes no chat.
Crie, edite e exclua campos conforme a necessidade.
Defina instruções para a IA para tentar preencher automaticamente um campo com base no que for dito na conversa.
Também existe pré-visualização para ver como o campo fica.

notes

Resumo rápido

  • Clique em Novo campo personalizado (ou Criar meu primeiro campo personalizado).
  • Preencha Nome do campo.
  • Selecione o Tipo do campo (Texto, Número, Data ou Moeda).
  • Opcional: escreva Instruções para IA.
  • Clique em Salvar.
  • Para editar: clique no ícone de lápis ou clique no ID do campo.

Resultado esperado: Campo personalizado criado/atualizado e listado com ID, Nome do campo, Tipo, Prompt IA e Data de criação.

format_list_numbered

Como criar um campo personalizado

1

Abrir a criação

Clique em Novo campo personalizado.
Se ainda não existir nenhum campo, clique em Criar meu primeiro campo personalizado.

2

Definir o nome

Preencha Nome do campo com um nome fácil de entender.
Use o exemplo do próprio campo como guia (ex.: Telefone, Profissão, Empresa...).

3

Escolher o tipo

Selecione Tipo do campo.
Escolha conforme o que será guardado: Texto, Número, Data ou Moeda.

4

Opcional: orientar a IA

Se quiser, preencha Instruções para IA (opcional).
Escreva uma regra simples dizendo quando e como a IA deve preencher o campo durante as conversas.

5

Conferir a pré-visualização

Olhe Pré-visualização para conferir como o campo aparece.
Esse bloco é só para ver o formato (não dá para preencher ali).

6

Salvar

Clique em Salvar.
Enquanto salva, o botão muda para Salvando.

7

Confirmar que deu certo

Procure o campo na listagem.
Confira as colunas Nome do campo, Tipo e Prompt IA (se tiver preenchido).

edit_note

Campos principais (no formulário de Adicionar/Editar)

Nome do campo

edit_notetexto
Obrigatório

Descrição: Digite o nome que aparece para identificar esse campo.
Use um nome curto e bem claro, porque ele aparece junto da conversa.

Regras/validações: Máximo de 100 caracteres.
Quando estiver vazio, ao tentar salvar, aparece a mensagem "Preencha todos os campos obrigatórios".

Exemplos: - Telefone
- Empresa

Tipo do campo

edit_noteseleção
Obrigatório

Descrição: Selecione o tipo que combina com o dado.
Isso muda a forma do campo na Pré-visualização (por exemplo, Data fica como data).

Regras/validações: Opções disponíveis:
- Texto
- Número
- Data
- Moeda

Quando estiver vazio, ao tentar salvar, aparece a mensagem "Preencha todos os campos obrigatórios".

Exemplos: - Para data de nascimento: Data
- Para valor de compra: Moeda

Instruções para IA (opcional)

edit_notetexto longo
Opcional

Descrição: Descreva a regra para a IA entender como preencher automaticamente este campo durante as conversas.
Use frases bem diretas dizendo o que procurar na conversa e onde salvar.

Regras/validações: Campo marcado como (opcional).
Abaixo do campo aparece a orientação: "Defina a regra para que a IA possa entender e preencher automaticamente este campo durante as conversas."

Exemplos: - Identifique como o cliente conheceu a empresa/serviço quando mencionado na conversa (ex: Google, indicação, redes sociais, etc.).
- Se o cliente informar um CPF válido, salvar em “CPF/CNPJ”.

notes

Termos que aparecem e o que significam

  • Prompt IA: É o texto com as instruções para a IA.
    Na listagem, esse texto aparece na coluna Prompt IA.
  • Instruções para IA (opcional): Campo para explicar quando e como a IA deve preencher automaticamente o campo.
    Quando não for necessário, deixe em branco.
  • Pré-visualização: Mostra um exemplo de como o campo vai ficar.
    É apenas para ver; fica desativado para edição.
notes

Regras e comportamentos importantes

  • Nome do campo e Tipo do campo são obrigatórios (senão aparece: "Preencha todos os campos obrigatórios").
  • Nome do campo aceita até 100 caracteres.
  • Instruções para IA é opcional.
  • Na listagem, Prompt IA pode aparecer cortado com "..." quando for longo.
  • Para excluir, aparece a confirmação: "Tem certeza que deseja excluir o campo [nome]?".
bug_report

Problemas comuns e como resolver

errorAo salvar, aparece "Preencha todos os campos obrigatórios"

Causa provável: Nome do campo ou Tipo do campo ficou vazio.

Como corrigir: Preencha Nome do campo.
Selecione Tipo do campo.
Clique em Salvar novamente.

Como confirmar: Verifique se o campo foi salvo e aparece na listagem com o nome correto.

errorAparece "Erro ao salvar o campo"

Causa provável: O salvamento não foi concluído.

Como corrigir: Tente clicar em Salvar novamente.
Se estiver em Salvando, aguarde finalizar.

Como confirmar: Após salvar, deve aparecer uma mensagem de sucesso como "[Nome] criado com sucesso!" ou "[Nome] atualizado com sucesso!".

errorAparece "Erro ao carregar campos personalizados"

Causa provável: A lista não carregou corretamente.

Como corrigir: Atualize e tente acessar novamente.
Se o erro continuar, tente mais tarde.

Como confirmar: A listagem deve mostrar as colunas ID, Nome do campo, Tipo, Prompt IA e Data de criação.

errorAo excluir, aparece "Erro ao excluir campo"

Causa provável: A exclusão não foi concluída.

Como corrigir: Tente excluir novamente.
Confirme a pergunta "Tem certeza que deseja excluir o campo...".

Como confirmar: Deve aparecer "Campo "[Nome]" excluído com sucesso!" e o item deve sumir da listagem.

notes

O que muda quando usar

Alterações no sistema: Campos personalizados aparecem no chat para coletar informações dos clientes.
Quando Instruções para IA estiver preenchido, a IA pode tentar preencher automaticamente o campo durante as conversas, usando o que o cliente disser.

Nenhum item informado.

Logs: Não há indicação de registros (logs) visíveis aqui.

notes

Tour rápido do que aparece

  • Lista de campos: Veja os campos em formato de tabela com: ID, Nome do campo, Tipo, Prompt IA e Data de criação.
    Use os ícones do lado direito para Editar (lápis) e Excluir (lixeira).
  • Ações rápidas: Use Novo campo personalizado para criar um novo.
    Quando não existir nenhum campo, use Criar meu primeiro campo personalizado.
  • Edição rápida do nome: Clique no ícone de lápis ao lado do nome para editar direto.
    Use X para cancelar e ✓ para salvar.
  • Formulário de Adicionar/Editar: Preencha Nome do campo, selecione Tipo do campo e, se quiser, escreva Instruções para IA (opcional).
    Finalize em Salvar.
  • Pré-visualização: Confira como o campo fica antes de salvar.
    O campo de exemplo aparece desativado, só para mostrar o formato.