Jornadas — entradas, gatilhos, audiências e agendamento

Uma jornada começa quando uma pessoa atende às condições de entrada definidas pelo time. Isso pode acontecer no momento em que um evento chega, quando um trait muda, quando a pessoa entra ou sai de um segmento ou num horário agendado.

Escolher bem a entrada é o que faz a jornada atuar na hora certa e com a audiência certa. Um pedido recusado pode pedir uma resposta imediata. Uma campanha de renovação pode executar uma vez numa data e horário definidos ou se repetir nos dias e horários planejados, sempre considerando o fuso da operação. Uma jornada de boas-vindas pode aceitar cada pessoa uma única vez.

Gatilho, política de entrada e instância

Três decisões trabalham juntas:

• Gatilho: define o sinal que faz o PrismaFlow considerar uma pessoa para a jornada.
• Política de entrada: decide se essa pessoa pode participar naquele momento.
• Instância: é criada quando o sinal e a política permitem a entrada.

Receber o sinal não garante uma nova instância. A jornada precisa estar ativa, possuir uma versão publicada e aceitar a pessoa de acordo com sua política. O PrismaFlow também protege a operação contra o processamento repetido da mesma ocorrência.

Evento recebido

Use um evento quando a jornada precisa reagir a um acontecimento específico.

Exemplos:

• dar boas-vindas depois de um cadastro;
• oferecer outra forma de pagamento depois de uma tentativa recusada;
• iniciar o acompanhamento de uma compra;
• atuar depois de uma fricção no checkout.

O gatilho seleciona o nome e a versão do evento. Quando ele é recebido e relacionado a um perfil, a pessoa pode ser avaliada para entrada. As propriedades daquele evento ficam disponíveis no contexto inicial da instância.

Por exemplo, uma jornada iniciada por PAGAMENTO_RECUSADO@1 pode usar o valor, o produto e o motivo da recusa nas próximas decisões, desde que esses campos façam parte do evento.

Entrada e saída de segmento

Segmentos funcionam como audiências vivas. Uma jornada pode reagir quando uma pessoa entra ou sai de uma delas.

Uma entrada pode iniciar uma campanha para pessoas que acabaram de se tornar elegíveis. Uma saída pode encerrar uma estratégia, iniciar uma recuperação ou registrar que a pessoa deixou de atender a uma condição importante.

Exemplos:

• entrar no segmento “clientes com alto interesse” inicia uma abordagem comercial;
• sair do segmento “assinaturas em dia” inicia uma ação de recuperação;
• entrar no segmento “carrinho abandonado elegível para benefício” inicia a avaliação de frete grátis.

O gatilho reage à mudança de membership. Ele não inicia novamente a jornada apenas porque a pessoa continua dentro ou fora do segmento.

Atualização de trait

Use esse gatilho quando a entrada depende da mudança de um estado mantido no perfil.

É possível observar:

• qualquer atualização de uma chave;
• somente um novo valor;
• uma transição exata entre o valor anterior e o novo.

Uma jornada pode começar quando plano_atual passar a ser premium. Outra pode ser mais específica e começar apenas na transição de trial para premium.

Quando a diferença entre o estado anterior e o atual importa, prefira a transição completa. Isso evita tratar como novidade uma atualização que apenas repetiu o mesmo estado esperado.

Merge de perfis

Uma jornada também pode reagir quando dois perfis da mesma pessoa são unidos. Esse gatilho atende a operações que precisam acompanhar uma mudança importante na identidade do perfil.

Por exemplo, o merge pode chamar um webhook de auditoria do próprio cliente, criar um log ou enviar um alerta para investigação.

Esse caso também mostra que jornadas não servem apenas para falar com a pessoa da instância. O uso principal continua sendo ativar e se comunicar com usuários, mas uma ação pode apoiar a operação. Uma venda, por exemplo, pode iniciar uma jornada ligada ao comprador e enviar uma notificação para o celular do responsável pelo negócio.

Entrada manual

A entrada manual permite selecionar perfis e solicitar sua participação numa jornada ativa. Ela é útil para testes controlados, validações e operações pontuais.

Uma solicitação manual não ignora as proteções da jornada. Cada perfil ainda passa pela política de entrada e pelo limite de instâncias ativas. Perfis repetidos na mesma solicitação são considerados uma única vez.

Agendamento único e recorrente

Use um agendamento quando o momento planejado é mais importante do que um novo evento individual.

Existem dois tipos: o agendamento único executa uma vez numa data e horário; o recorrente repete a execução nos dias e horários configurados.

Agendamento único

Executa a audiência uma vez, na data e no horário configurados.

Exemplos: lançamento de uma campanha, comunicação de uma mudança programada ou ativação de uma audiência numa data comercial.

Agendamento recorrente

Executa a audiência seguindo os dias, horários, frequência e fuso configurados. Por exemplo, a jornada pode executar toda segunda-feira às 9h ou no primeiro dia de cada mês.

Exemplos: lembrete semanal, rotina mensal de relacionamento ou uma ação recorrente para uma audiência que muda ao longo do tempo.

O fuso merece atenção. Confirme sempre se o horário representa a operação e a audiência que você quer alcançar.

Como a audiência agendada é escolhida

Uma jornada agendada pode trabalhar com:

• uma lista definida de perfis;
• a audiência de um segmento.

A lista de perfis é fixa para aquele agendamento. Já o segmento é consultado durante a execução. Num agendamento recorrente, cada ocorrência pode encontrar uma audiência diferente, porque pessoas continuam entrando e saindo do segmento.

Audiências grandes podem ser distribuídas em lotes. Isso permite controlar o ritmo da entrada e o impacto das ações seguintes sem transformar toda a audiência em instâncias no mesmo instante.

Mesmo fazendo parte da audiência, uma pessoa só entra se passar pela política configurada.

Políticas de entrada

Uma única vez

A pessoa pode participar dessa jornada somente uma vez durante toda a vida dela.

É uma boa escolha para um onboarding que nunca deve ser repetido, mesmo que o gatilho aconteça novamente.

Uma vez enquanto estiver ativa

A pessoa não pode possuir duas instâncias simultâneas da jornada. Depois que a instância atual termina, uma nova entrada pode ser aceita.

Esse modo funciona bem para fluxos recorrentes nos quais duas execuções ao mesmo tempo causariam mensagens ou decisões conflitantes.

Reentrada após um intervalo

A pessoa precisa terminar a instância atual e aguardar o período configurado antes de entrar novamente.

Use esse intervalo para controlar frequência. Por exemplo, uma jornada de recuperação pode aceitar nova tentativa depois de sete dias, mas não a cada sinal recebido durante esse período.

Reentrada até converter

A pessoa pode participar novamente depois que uma instância termina, enquanto ainda não tiver convertido na jornada. Depois da conversão, novas entradas são bloqueadas.

Esse modo combina com estratégias que podem fazer novas tentativas, mas devem parar definitivamente quando o objetivo for alcançado.

Limite de instâncias ativas

Também é possível limitar quantas instâncias da jornada podem ficar ativas ao mesmo tempo. O limite vale para a jornada inteira.

Essa proteção é especialmente útil no início de uma operação. Imagine uma audiência de 10 mil pessoas. Em vez de liberar todas de uma vez, o time pode começar com um limite de 100 instâncias, observar se as pessoas avançam como esperado e só então ampliar a capacidade.

Quando o teto é atingido, novas entradas são recusadas. Elas não ficam numa fila esperando uma vaga. Se aquela pessoa precisar ser considerada novamente, será necessário existir um novo sinal ou uma nova execução de audiência que seja aceita pela política.

O limite controla concorrência, mas não substitui a escolha correta da audiência nem uma estratégia de lançamento gradual.

Proteção contra duplicações

O PrismaFlow impede que a mesma ocorrência seja processada duas vezes para criar entradas duplicadas. Isso protege integrações contra repetições de mensagens e evita duas instâncias causadas pelo mesmo disparo agendado.

Essa proteção não substitui a política de entrada:

• a deduplicação reconhece a repetição da mesma ocorrência;
• a política decide o que fazer quando ocorrências diferentes alcançam a mesma pessoa.

Como escolher

Antes de publicar, responda:

1. Qual acontecimento torna a pessoa elegível?
2. A resposta precisa acontecer agora ou pode ser agendada?
3. A jornada depende de um evento, de um estado do perfil ou de uma audiência?
4. A mesma pessoa pode participar mais de uma vez?
5. Duas instâncias simultâneas fariam sentido?
6. Existe um intervalo mínimo entre tentativas?
7. Uma conversão deve impedir qualquer nova entrada?
8. É mais seguro começar com um limite pequeno de instâncias ativas?

Assuntos relacionados

• Jornadas — fundamentos, autoria, versões e publicação [blocked]
• Jornadas — condições, decisões, esperas e progressão [blocked]
• Segmentos — fundamentos, criação e ciclo de vida
• Traits e evolução do perfil
• Identidades e formação de perfis

Revisão editorial

• Estado: Em revisão
• Fatos confirmados em: serviço de jornadas, DSL e contratos atuais
• Walkthrough: conhecimento operacional fornecido pelo Darlysson na PF-1372 em 15/08/2026
• Lacunas conhecidas: nomenclatura técnica de evento no dashboard precisa ser conciliada