Definições

​

As peças de uma definição

​

Onde encontrar

​

Criar uma definição

1

Abra o criador

Na aba Definições, clique em Nova definição (canto superior direito).

2

Defina os campos do evento

Aqui você descreve quais informações o evento carrega. Há dois caminhos:

• Importar JSON (mais rápido)
• Criar manualmente

Cole um exemplo real do evento e o PrismaFlow descobre os campos e os tipos sozinho.

A detecção automática marca todo número como number. Se algum campo precisa ser inteiro (integer), ajuste o tipo manualmente depois de importar.

Adicione um campo de cada vez: escolha o tipo, dê um nome e marque se ele é obrigatório. Em listas (array), você ainda escolhe o subtipo dos itens.

Os tipos de campo disponíveis:

Tipo	O que é	Exemplo
string	Texto	"abc123"
number	Qualquer número, inclusive com casas decimais	12.5
integer	Apenas número inteiro, sem casas decimais	42
boolean	Verdadeiro ou falso	true
date	Uma data ou data com hora	2026-04-20T10:00:00Z
array	Uma lista de valores (você escolhe o subtipo)	["shirt", "pants"]
object	Um grupo de campos dentro do campo	{ "rua": "...", "cep": "..." }

number ou integer? Use number quando o valor pode ter vírgula (preço, peso). Use integer só quando o valor é sempre inteiro (quantidade, idade). Na dúvida, number aceita os dois. Um valor como 12.5 enviado num campo integer é recusado.

Campos date aceitam tanto uma data (2026-04-20) quanto uma data com hora. O PrismaFlow padroniza o valor automaticamente, então você não precisa se preocupar com o formato exato.

3

(Opcional) Promova campos a características do perfil

Um trait mapping pega um campo do evento e o grava como uma característica (trait) no perfil da pessoa. Exemplo: o campo amount da compra vira o trait last_purchase_amount no perfil.

Para criar, escolha de qual campo vem o valor, qual trait ele alimenta e o tipo do valor.

O valor mais recente sempre vence. A cada novo evento, o trait é atualizado com o valor que chegou — o anterior é sobrescrito. Para cálculos que somam, contam ou fazem médias ao longo do tempo, use os Computed Traits.

O trait mapping só passa a valer dos próximos eventos em diante — ele não recalcula o histórico já recebido. E você só consegue promover um campo que existe no molde (por isso “Campo do schema” é uma lista, não um texto livre).

4

Dê um nome e escolha o modo de validação

Por fim, informe o nome do evento, uma descrição e tags opcionais, e escolha o modo de validação.

Estrito (recomendado)

Eventos que trazem campos fora do molde são recusados e enviados para a Quarentena. Mantém seus dados limpos.

Permissivo

Campos extras passam pela validação. Apenas os campos obrigatórios são conferidos.

No modo Estrito, um evento com campo a mais não some e não retorna erro para o seu sistema — ele é desviado para a aba Quarentena, onde você pode revisar o motivo. Vale a pena dar uma olhada lá de tempos em tempos.

5

Criar definição

Clique em Criar definição. Pronto — a partir daí, todo evento daquele tipo passa a ser conferido contra o molde.

​

Editar uma definição

• Trocar o modo de validação de Permissivo para Estrito — eventos com campos extras, que antes passavam, passariam a ser recusados.
• Adicionar um novo campo obrigatório — eventos antigos que não enviam esse campo falhariam na validação.

​

Bom saber