Campos Personalizados

notes

O que dá para fazer com Campos Personalizados

Use campos personalizados para registrar informações importantes de cada conversa.

Ações disponíveis:
- Criar campo em Novo campo personalizado ou Criar meu primeiro campo personalizado
- Editar campo (inclusive o Nome do campo direto na lista)
- Excluir campo
- Definir Instruções para IA (opcional) para preenchimento automático

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, Texto Grande, Número, Data, Moeda).
Se quiser, escreva Instruções para IA (opcional).
Clique em Salvar campo (ou Salvar alterações).
Para editar depois, clique no ID ou no ícone de editar; para remover, use o ícone de lixeira.

Resultado esperado: O campo aparece na listagem com ID, Nome do campo, Tipo, Prompt IA e Data de criação.

format_list_numbered

Como criar, editar e excluir um campo

1

Abrir a criação

Clique em Novo campo personalizado.

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

2

Definir o nome

Preencha Nome do campo.

Use um nome claro (ex.: no placeholder aparecem ideias como “Telefone, Profissão, Empresa...”).

3

Escolher o tipo

Em Tipo do campo, selecione uma opção:
- Texto
- Texto Grande
- Número
- Data
- Moeda

Use a Pré-visualização para conferir como fica.

4

Opcional: orientar o preenchimento automático

Em Instruções para IA (opcional), descreva o que a IA precisa identificar na conversa para preencher o campo.

Dica prática: escreva instruções diretas e claras, como no exemplo do próprio campo.

5

Salvar

Clique em Salvar campo.

Ao salvar, o botão pode mostrar Salvando... até terminar.

6

Editar um campo existente

Use uma destas opções:
- Clique no ID do campo.
- Clique no nome do campo.
- Clique no ícone de editar.

No modal, clique em Salvar alterações.

7

Editar rápido só o nome (na lista)

Clique no ícone de lápis ao lado do nome.

Para finalizar:
- Clique no ícone de check para salvar.
- Clique no ícone de X para cancelar.

8

Excluir um campo

Clique no ícone de lixeira.

Confirme na mensagem: “Tem certeza que deseja excluir o campo ...?”

edit_note

Campos principais (ao adicionar/editar)

Nome do campo

edit_notetexto

Obrigatório

Descrição: Digite o nome que fica visível no sistema.

Use um nome fácil de entender, para achar rápido depois.

Regras/validações: - Limite de 100 caracteres (maxlength).
- Se ficar vazio, aparece o aviso: “Preencha todos os campos obrigatórios”.

Exemplos: - Telefone
- Profissão

Tipo do campo

edit_noteseleção

Valor padrão: Texto

Obrigatório

Descrição: Selecione como a informação é preenchida e apresentada.

A descrição do tipo aparece logo abaixo (ex.: “Ideal para informações curtas...”).

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

Se não estiver selecionado, aparece o aviso: “Preencha todos os campos obrigatórios”.

Exemplos: - Texto (para “Cidade”)
- Data (para “Data de nascimento”)

Instruções para IA (opcional)

edit_notetexto_grande

Opcional

Descrição: Escreva uma instrução para a IA entender quando e como preencher o campo automaticamente.

A ajuda abaixo do campo reforça que a IA usa esta instrução para preencher “este campo”.

Regras/validações: Campo marcado como (opcional).

Exemplos: - Identifique como o cliente conheceu a empresa quando isso for mencionado na conversa, como Google, indicação ou redes sociais.

notes

Regras e comportamentos importantes

Preencha Nome do campo e selecione Tipo do campo para conseguir salvar; caso contrário aparece “Preencha todos os campos obrigatórios”.
Nome do campo aceita no máximo 100 caracteres.
A Pré-visualização é apenas visual; o texto informa que “O valor real será preenchido nos contatos e conversas onde o campo estiver disponível”.
Na listagem, Prompt IA pode aparecer cortado quando for longo (mostra “...” ao passar de um certo tamanho).
Ao excluir, aparece uma confirmação: “Tem certeza que deseja excluir o campo ...?”.

bug_report

Problemas comuns e como resolver

errorMensagem: “Preencha todos os campos obrigatórios”

Causa provável: Algum campo obrigatório ficou vazio (por exemplo, Nome do campo ou Tipo do campo).

Como corrigir: - Preencha Nome do campo.
- Selecione um valor em Tipo do campo.
- Clique em Salvar campo (ou Salvar alterações).

Como confirmar: O salvamento termina e aparece mensagem de sucesso (ex.: “criado com sucesso!” ou “atualizado com sucesso!”).

errorMensagem: “Erro ao carregar campos personalizados”

Causa provável: Falha ao carregar a lista de campos naquele momento.

Como corrigir: - Tente novamente mais tarde.
- Se o erro continuar, recarregue e tente abrir novamente.

Como confirmar: A lista volta a mostrar colunas como ID, Nome do campo, Tipo, Prompt IA e Data de criação.

errorMensagem: “Erro ao salvar o campo”

Causa provável: Falha ao salvar naquele momento.

Como corrigir: - Verifique se os campos obrigatórios estão preenchidos.
- Clique em Salvar campo (ou Salvar alterações) novamente.

Como confirmar: Aparece a mensagem de sucesso com o nome do campo e o modal fecha.

errorMensagem: “Erro ao excluir campo”

Causa provável: Falha ao excluir naquele momento.

Como corrigir: - Tente excluir novamente.
- Se existir confirmação, confirme de novo quando aparecer.

Como confirmar: Aparece: Campo "..." excluído com sucesso! e o item some da listagem.

errorMensagem: “Erro ao carregar o campo”

Causa provável: Falha ao abrir os dados do campo para edição.

Como corrigir: - Feche e abra novamente a edição do campo.
- Se continuar, tente abrir clicando no ID na listagem.

Como confirmar: O título muda para Editar Campo Personalizado e os dados aparecem preenchidos.

notes

O que muda ao usar campos personalizados

Alterações no sistema: - Os campos personalizados “aparecem no chat para coletar informações dos clientes”.
- Ao criar, editar ou excluir, a listagem muda (campos com ID, Nome do campo, Tipo, Prompt IA, Data de criação).
- Ao preencher Instruções para IA (opcional), a descrição informa que “A IA utilizará esta instrução para entender quando e como preencher este campo automaticamente”.

Nenhum item informado.

Logs: Não há informação visível sobre registros (logs) nesta funcionalidade.

notes

Termos que aparecem e o que significam

Prompt IA: É o texto de instruções para a IA.

Na lista, aparece na coluna Prompt IA e pode ficar como “-” quando não existir.
Instruções para IA (opcional): Campo de texto para explicar o que a IA deve identificar na conversa.

Use para deixar o preenchimento automático mais consistente.
Pré-visualização: Mostra uma representação aproximada de como o campo fica.

O texto avisa: “Esta prévia é apenas visual.”

notes

Tour guiado: o que aparece e para que serve

Ações principais: - Use Novo campo personalizado para criar um novo.
- Use Criar meu primeiro campo personalizado quando ainda não existir nenhum campo.
Listagem de campos: A lista mostra as colunas:
- ID
- Nome do campo
- Tipo
- Prompt IA
- Data de criação

Ações rápidas:
- Clique no ID para abrir edição.
- Use os ícones de editar e excluir no final da linha.
Modal: Configuração do campo: Preencha:
- Nome do campo (com dica em ícone de informação)
- Tipo do campo (com opções como Texto, Número, Data, etc.)

Ícones de informação (i) mostram dicas quando passar o mouse ou focar.
Modal: Pré-visualização: Confere uma prévia do campo com:
- Nome
- Tipo
- Um controle desabilitado (apenas exemplo visual)

O texto reforça que a prévia é só visual.
Modal: Preenchimento automático pela IA: Use Instruções para IA (opcional) para orientar a IA.

O texto explica que instruções objetivas ajudam o preenchimento automático a ficar mais consistente.