Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.crmspark.com.br/llms.txt

Use this file to discover all available pages before exploring further.

No Spark, campos personalizados são informações extras que você cria para registrar dados estruturados em cada conversa. Em vez de depender só de anotações soltas, você define campos como “Valor do contrato”, “Score do cliente” ou “Data de vencimento” — e esses campos aparecem no painel lateral de todos os chats da organização.

Para que servem

  • Padronizar dados que o time precisa preencher em cada atendimento.
  • Registrar informações que depois ajudam a filtrar, priorizar ou reportar conversas.
  • Manter um histórico estruturado por conversa, sem depender da memória de quem atendeu.

Como funciona no Spark

  1. Um administrador acessa CRM > Campos personalizados e cria os campos que a organização precisa.
  2. Cada campo recebe um nome, um tipo (texto, número, data etc.) e configurações opcionais.
  3. Os campos criados aparecem no painel lateral de todas as conversas.
  4. Qualquer usuário pode clicar em “Editar campos personalizados” dentro de um chat para preencher ou alterar os valores daquela conversa específica.

Tipos de campo disponíveis

TipoO que aceitaExemplo
TextoQualquer texto livre”Plano Premium”
NúmeroValor numérico1500.00
DataData no formato ISO2025-12-31
Data e horaData com horário2025-12-31T14:30:00Z
Sim / nãoValor verdadeiro ou falsoSim
O tipo é escolhido na criação do campo e determina como o valor é validado, exibido e editado.

Campos obrigatórios e valor padrão

Ao criar um campo, você pode marcá-lo como obrigatório. Campos obrigatórios precisam de um valor padrão, porque:
  • O valor padrão é preenchido automaticamente em todas as conversas existentes que ainda não tinham aquele campo.
  • Novas conversas também recebem o valor padrão assim que são criadas.
Isso garante que nenhum chat fique sem a informação mínima esperada, mesmo os que já estavam abertos antes do campo existir.
Use campos obrigatórios para dados que o time sempre precisa ter em mãos, como “Etapa de negociação” ou “Tipo de cliente”. Para informações complementares que nem sempre fazem sentido, deixe o campo opcional.

Ordem dos campos

Você define a ordem em que os campos aparecem arrastando e soltando na tela de CRM > Campos personalizados. Essa ordem vale para todos os chats.

Origem dos campos

Cada campo tem uma origem:
  • Usuário: criado manualmente por um administrador na tela de CRM. Você pode editar e excluir normalmente.
  • Integração: criado automaticamente por uma integração conectada ao Spark. Esses campos exibem um selo “Integração” e podem ter edição ou remoção restrita — tudo depende de como a integração os configurou.

Editando valores em uma conversa

Dentro de qualquer chat, abra o painel lateral e clique em “Editar campos personalizados”. Uma janela mostra todos os campos da organização com os valores atuais daquela conversa. Altere o que precisar e salve — os valores são salvos por conversa, então a mudança não afeta outros chats. Campos gerenciados por integração podem aparecer como somente leitura, sem opção de edição manual.

O que acontece ao remover um campo

Ao excluir um campo personalizado, ele desaparece da organização inteira e todos os valores preenchidos em cada conversa são apagados junto. Essa ação não pode ser desfeita.
Antes de remover um campo, verifique se ninguém da equipe depende daquele dado. A exclusão é permanente e afeta todas as conversas.

Boas práticas

  • Comece com poucos campos e adicione mais conforme a equipe sente falta. Campos demais sobrecarregam o painel.
  • Dê nomes claros e diretos: “Valor do contrato” é melhor que “VC”.
  • Use o tipo certo para cada dado. Números devem ser “Número”, não texto — assim ficam mais fáceis de filtrar e comparar.
  • Marcou como obrigatório? Escolha um valor padrão que faça sentido como ponto de partida (ex: 0 para valores numéricos, “Não” para campos de sim/não).
  • Revise os campos periodicamente e remova os que não estão sendo usados.
Para entender melhor como as conversas se organizam no Spark, veja também CRM baseado em mensagens e Rastreamento.