Jornadas — instâncias, histórico e operação

Uma jornada descreve o caminho. Uma instância registra o que aconteceu com uma pessoa dentro desse caminho.

É na instância que você descobre qual versão foi usada, por onde a pessoa entrou, quais etapas ela percorreu, onde está aguardando e por que sua execução terminou.

Jornada, versão e instância não são a mesma coisa

• Jornada: é a orquestração de negócio;
• Versão: é o desenho publicado em determinado momento;
• Instância: é uma execução desse desenho para uma pessoa.

Cada instância permanece ligada à versão em que começou. Publicar uma versão nova não muda o caminho de quem já estava dentro da jornada.

Uma mesma pessoa pode possuir mais de uma instância. Isso depende da política de entrada: uma nova participação pode ser bloqueada, permitida depois de um intervalo ou aceita enquanto outras ainda estão em andamento.

Acompanhar uma instância

Na área de instâncias da jornada, você pode filtrar as execuções por:

• pessoa, usando uma de suas identidades;
• estado da instância;
• versão da jornada;
• período de início;
• período de encerramento.

A lista também informa o nó atual, a origem da entrada e quando a instância foi iniciada ou atualizada. Campos adicionais permitem consultar o status do goal, a variante de teste A/B e o motivo de término quando essas informações existirem.

Ao abrir uma instância, o PrismaFlow apresenta sua linha do tempo. Ela pode mostrar, por exemplo:

• início da execução;
• entrada em cada etapa;
• decisões e rotas escolhidas;
• começo e retomada de esperas;
• ações colocadas na fila, despachadas, concluídas ou falhas;
• goals observados e seus resultados;
• pausa, retomada, cancelamento e encerramento.

Essa visão permite acompanhar uma pessoa sem tentar reconstruir sua história a partir de métricas gerais da jornada.

Estados de uma instância

Ativa

A instância está pronta para progredir pelo fluxo. Esse estado também pode aparecer durante o processamento entre duas etapas.

Aguardando

A instância chegou a uma etapa que precisa esperar. Pode ser um prazo, um evento ou condição observada por um wait, o resultado de uma ação ou a janela de um goal.

Aguardando não significa travada. Muitas jornadas passam a maior parte do tempo nesse estado porque estão respeitando o momento certo de continuar.

Pausada

A execução foi congelada por uma pausa da jornada. Ela só volta a progredir quando a jornada for retomada.

O tempo restante de waits e goals também fica preservado. Se uma espera de sete dias for pausada depois de dois, ela continuará com cinco dias restantes depois da retomada. O período em que ficou pausada não consome essa janela.

Completa

A instância alcançou um fim normal do caminho.

Convertida

A instância terminou associada a um goal atendido depois de uma atuação atribuída à jornada.

Um goal convertido também pode continuar por outras etapas. Nesse caso, o resultado do goal permanece em seu histórico, enquanto o estado final da instância representa como o restante do caminho terminou.

Não impactada

O objetivo foi atendido sem uma ação anterior atribuída àquela instância. É a conversão orgânica explicada no guia de goals, conversões e resultados [blocked].

Suprimida

O PrismaFlow interrompeu a execução para evitar uma colisão.

Um caso ocorre durante a resolução de identidades. Imagine que a mesma pessoa possua dois perfis e uma instância ativa da mesma jornada em cada um. Depois do merge, manter as duas execuções poderia duplicar ações e comunicações. O PrismaFlow preserva a execução aplicável ao perfil resultante e suprime a colisão.

Cancelada

Alguém encerrou a instância manualmente ou uma operação cancelou as instâncias em andamento da jornada. O motivo informado fica registrado para consulta.

Expirada

Uma espera ou um goal alcançou seu limite sem encontrar um caminho válido para continuar. Em fluxos bem configurados, saídas de tempo limite devem conduzir a uma decisão explícita.

Falhou

A execução foi interrompida por uma falha que, de acordo com a configuração da etapa, não permitia continuar.

Falhas são pouco frequentes. Quando acontecem, webhooks são um dos principais pontos de investigação porque dependem de outro sistema responder corretamente.

Investigar uma falha de webhook

Para encontrar o problema:

1. abra as instâncias da jornada;
2. filtre pelo estado Falhou;
3. encontre a pessoa ou o período afetado;
4. abra a instância;
5. localize a ação que falhou na linha do tempo;
6. confira a mensagem de erro e a resposta devolvida pelo destino.

A resposta costuma indicar se houve rejeição de autenticação, payload inválido, indisponibilidade ou outra regra do sistema chamado.

Depois de identificar a causa, corrija a integração antes de produzir novas entradas. Uma instância que já terminou como Falhou não volta automaticamente ao fluxo.

Pausar, retomar e cancelar

Pausar a jornada

A pausa bloqueia novas entradas e pausa em lotes as instâncias em andamento. A mudança pode levar algum tempo para alcançar toda a audiência porque é processada de forma segura em segundo plano.

Depois que uma instância é pausada, ela permanece congelada até a jornada receber play novamente. Na retomada, o PrismaFlow restaura o estado anterior, preserva o tempo restante e reconcilia trabalhos que terminaram enquanto a operação de pausa estava sendo aplicada.

Cancelar uma instância

Uma instância ativa, aguardando ou pausada pode ser cancelada. O cancelamento:

• impede novas etapas daquela execução;
• cancela waits e goals ainda abertos;
• remove da fila ações que ainda não foram executadas;
• registra o motivo no histórico;
• não pode ser desfeito.

O cancelamento não volta no tempo. Um push já enviado não pode ser recolhido, um webhook já aceito não pode ser desexecutado e um benefício já concedido precisa ser tratado no sistema responsável. Essa limitação não é exclusiva do PrismaFlow: nenhum orquestrador consegue desfazer automaticamente um efeito que outro sistema já concluiu.

Cancelar as instâncias da jornada

Também é possível cancelar em lotes as instâncias não terminais que já existem. Nessa operação, você pode pausar a jornada para bloquear novas entradas enquanto o cancelamento acontece.

Se a jornada continuar ativa, novas instâncias criadas depois do início da operação não pertencem ao grupo que está sendo cancelado.

Estado da jornada, da versão e da instância

Ao investigar um caso, observe os três níveis:

1. Estado da jornada: indica se ela aceita novas entradas, está pausada ou foi arquivada;
2. Estado da versão: indica se aquele desenho é rascunho, publicado, substituído ou arquivado;
3. Estado da instância: indica o que está acontecendo com uma execução individual.

Uma jornada arquivada não aceita novas pessoas, mas suas instâncias antigas podem continuar. Uma versão substituída não recebe novas entradas, mas continua sendo usada por quem começou nela. Uma instância pausada não significa que sua versão ou a jornada foram apagadas.

Boas práticas

1. Comece a investigação pela pessoa e pela versão da instância.
2. Leia a linha do tempo na ordem dos acontecimentos.
3. Considere Aguardando como um estado normal antes de procurar uma falha.
4. Confira o nó atual e o tempo configurado antes de concluir que a execução parou.
5. Em webhook falho, leia a resposta do destino e corrija a causa na integração.
6. Registre um motivo claro ao cancelar uma instância.
7. Pause quando pretende continuar depois; cancele quando aquela execução não deve mais avançar.
8. Não espere que o cancelamento desfaça ações externas já concluídas.
9. Consulte a definição da versão usada pela instância, não apenas o desenho publicado hoje.

Assuntos relacionados

• Jornadas — fundamentos, autoria, versões e publicação [blocked]
• Jornadas — condições, decisões, esperas e progressão [blocked]
• Jornadas — ações, variáveis e personalização [blocked]
• Jornadas — goals, conversões e resultados [blocked]
• Identidades e formação de perfis

Revisão editorial

• Estado: Em revisão
• Fatos confirmados em: engine de jornadas, lifecycle, auditoria e dashboard atuais
• Walkthrough: conhecimento operacional fornecido pelo Darlysson na PF-1376 em 15/08/2026
• Lacunas conhecidas: retomada individual e profundidade da auditoria no dashboard precisam de conciliação interna