Jornadas — fundamentos, autoria, versões e publicação

Uma jornada transforma sinais e dados de uma pessoa numa sequência de decisões, esperas e ações. Ela pode receber alguém quando um evento acontece, quando um trait muda, quando a pessoa entra ou sai de um segmento ou quando chega um horário agendado.

O ponto central é simples: a jornada descreve o caminho; cada pessoa percorre esse caminho numa instância própria.

Jornada, versão e instância

Esses três conceitos trabalham juntos, mas não significam a mesma coisa.

Jornada

É a orquestração de negócio. Ela possui nome, descrição, identificador, estado e configurações gerais.

Uma jornada pode representar, por exemplo:

• boas-vindas depois do cadastro;
• recuperação de uma compra interrompida;
• acompanhamento após uma compra;
• comunicação depois de uma mudança de plano;
• uma campanha para a audiência de um segmento.

Versão

É o desenho da jornada salvo num momento específico. Ela reúne o gatilho, a política de entrada, os nós, as conexões e as configurações usadas pelo fluxo.

Uma versão em rascunho pode ser revisada sem substituir o que está em operação. Quando é publicada, passa a receber as novas entradas da jornada.

Instância

É a execução da jornada para uma pessoa. A instância guarda a versão em que começou e continua usando essa mesma versão até alcançar um estado terminal ou ser cancelada.

Uma mesma pessoa pode possuir mais de uma instância da mesma jornada. Isso depende da política de entrada: ela pode permitir apenas uma participação, impedir uma nova entrada enquanto outra estiver ativa, aceitar reentrada depois de um intervalo ou permitir novas tentativas até a conversão. Também é possível limitar quantas instâncias podem permanecer ativas ao mesmo tempo.

Cada entrada aceita cria uma instância própria, com estado, histórico e versão independentes. Veja como essas decisões funcionam em Jornadas — entradas, gatilhos, audiências e agendamento [blocked].

Publicar uma nova versão não muda o caminho de quem já estava dentro da jornada.

Por que versões protegem a operação

Imagine uma jornada de recuperação de carrinho.

Na versão 1, um teste A/B compara duas comunicações. Depois de observar os resultados, o time descobre qual delas funciona melhor. A versão 2 remove o teste e envia diretamente a comunicação vencedora.

Depois da publicação:

• pessoas que já estavam na v1 continuam no teste A/B da v1;
• novas entradas passam a seguir o caminho direto da v2;
• métricas e históricos continuam ligados à versão correta.

Isso permite experimentar sem quebrar waits, decisões ou ações de instâncias que já começaram.

O que forma a definição

O editor representa a jornada como um fluxo conectado. Toda definição precisa possuir:

• um gatilho de entrada;
• uma política que controla novas entradas;
• nós que representam as etapas;
• conexões que definem o próximo caminho;
• pelo menos um fim alcançável.

Uma jornada sempre precisa terminar. Conexões circulares são bloqueadas pelo editor. Quando o negócio pede uma repetição, como executar algo dez vezes, essa necessidade deve ser modelada por uma capacidade controlada, com limite e saída explícitos, e não por um ciclo livre no fluxo.

Os tipos de gatilho, nós e políticas serão detalhados nos próximos guias de jornadas.

Rascunho local e versão salva

Enquanto você trabalha, o editor mantém uma recuperação local para proteger alterações ainda não enviadas. Se a página for fechada, ele pode oferecer a retomada desse conteúdo.

O botão Salvar envia a definição para o PrismaFlow e cria uma nova versão numerada em rascunho. Cada salvamento preserva um ponto do trabalho no servidor.

Essa separação oferece duas proteções:

• recuperar uma alteração recente feita no navegador;
• experimentar numa nova versão sem alterar a versão publicada nem as instâncias existentes.

Salvar não é o mesmo que publicar. Uma versão salva continua sem receber novas entradas até passar pela publicação.

Validação antes da publicação

O PrismaFlow valida a jornada em mais de uma etapa. Entre outras verificações, ele confirma:

• se existe exatamente um gatilho e ao menos um fim;
• se os nós estão conectados e podem ser alcançados;
• se cada tipo de decisão possui as saídas necessárias;
• se a configuração dos nós está completa;
• se templates e providers usados pelo fluxo estão disponíveis;
• se referências a outras jornadas são válidas;
• se agendamentos e audiências possuem configurações aceitas.

Durante a edição de uma jornada existente, uma nova versão pode ser salva com problemas para que o trabalho continue, mas não pode ser publicada enquanto houver erros de validação.

Corrija os problemas apresentados pelo editor e salve novamente antes de publicar.

Publicar coloca a versão em operação

Publicar é uma ação protegida por autenticação de dois fatores. Essa confirmação existe porque uma nova versão pode começar a enviar comunicações e executar ações reais para os usuários.

Ao publicar uma versão:

1. ela se torna a versão publicada atual;
2. a versão publicada anterior é preservada como substituída;
3. outros rascunhos daquela jornada são arquivados;
4. novas entradas passam a usar a versão recém-publicada;
5. instâncias existentes continuam na versão em que começaram.

Para jornadas agendadas, a publicação também prepara o próximo disparo e encerra agendamentos ou distribuições ainda vinculados a outra versão.

Estados da jornada

Rascunho

A jornada ainda não possui uma versão em operação. Ela pode ser construída, salva, validada e publicada.

Ativa

Existe uma versão publicada pronta para receber novas entradas. Editar e salvar cria um novo rascunho sem interromper a versão atual.

Pausada

A pausa bloqueia novas entradas e inicia uma operação em lotes para pausar instâncias não terminais, waits e goals em andamento.

Retomar a jornada restaura as instâncias que foram pausadas por essa operação e reconcilia o trabalho que ficou pendente. Como a mudança acontece em lotes, o estado de todas as instâncias pode levar algum tempo para refletir a operação.

Arquivada

O arquivamento é definitivo e bloqueia novas entradas. Ele não cancela as instâncias que já estavam em andamento: elas continuam na versão em que começaram.

Se essas execuções também precisam terminar, planeje o cancelamento como uma operação separada. Para cancelar todas as instâncias em lote, faça isso antes de arquivar a jornada.

Pausar não é cancelar

Pausa e cancelamento resolvem problemas diferentes.

Ao cancelar todas as instâncias, você informa um motivo e pode escolher pausar a jornada na mesma operação. Se ela continuar ativa, novas pessoas que entrarem depois do início do cancelamento não fazem parte daquele grupo cancelado.

Boas práticas antes de publicar

1. Dê à jornada um nome que explique o objetivo, não apenas o canal usado.
2. Confirme qual acontecimento ou audiência inicia o fluxo.
3. Revise a política de entrada para evitar comunicações repetidas.
4. Garanta que todos os caminhos chegam a um fim.
5. Confira waits, horários e fuso da operação.
6. Teste as ações e integrações disponíveis antes da publicação.
7. Revise templates, variáveis e dados que serão usados nas mensagens.
8. Entenda o que muda em relação à versão publicada atual.
9. Considere as instâncias que continuarão executando a versão anterior.
10. Use a autenticação de dois fatores somente quando estiver pronto para colocar a versão em operação.

Assuntos relacionados

• Jornadas — instâncias, histórico e operação [blocked]
• Jornadas — entradas, gatilhos, audiências e agendamento [blocked]
• Segmentos — fundamentos, criação e ciclo de vida
• Segmentos — avaliação, membership e operação
• Identidades e formação de perfis

Revisão editorial

• Estado: Em revisão
• Fatos confirmados em: serviço de jornadas, DSL e editor atuais
• Walkthrough: conhecimento operacional fornecido pelo Darlysson na PF-1371 em 15/08/2026
• Lacunas conhecidas: validação de ciclos precisa ser repetida no backend