Jornadas — horários de funcionamento e janela operacional global

Os Horários de funcionamento definem em quais dias e horários as ações de uma jornada podem ser executadas. Essa configuração é a janela operacional global da jornada.

A regra vale para qualquer ação da jornada, independentemente do tipo ou canal. Novos tipos de ação também seguem essa regra. Você configura a janela uma vez para a jornada e todas as suas ações a respeitam, em qualquer ponto do fluxo.

“Global” significa que a regra abrange as ações daquela jornada. Cada jornada possui sua própria configuração. Sem uma janela configurada, suas ações podem ser executadas em qualquer dia e horário, respeitando as demais regras do fluxo.

Configurar os horários

No editor da jornada:

1. Localize o cartão Horários de funcionamento e clique em Configurar. Se já houver uma configuração, use Alterar.
2. Ative Definir janela operacional.
3. Preencha Das e Até com o horário de abertura e fechamento.
4. Selecione os Dias da semana em que a janela pode abrir.
5. Clique em Aplicar para incorporar a configuração à edição.
6. Salve a definição e publique a versão quando estiver pronta para uso.

Os horários são interpretados no fuso registrado na configuração da jornada. Por exemplo, 9h no fuso America/Sao_Paulo significa 9h em São Paulo, mesmo quando a pessoa está em outra região. O editor usa inicialmente o fuso do navegador ao criar uma jornada.

Defina pelo menos um dia e use horários de abertura e fechamento diferentes. Para permitir funcionamento sem restrição de dias e horários, desative Definir janela operacional.

A janela faz parte da versão usada pela instância. Publicar uma versão com outros horários aplica a nova configuração às novas entradas; instâncias existentes continuam respeitando a configuração da versão em que começaram. Veja o guia de autoria, versões e publicação [blocked].

O que acontece fora do horário

Antes de executar uma ação, o PrismaFlow verifica a janela operacional da versão daquela instância.

Se a janela estiver aberta, a ação pode executar, desde que as demais condições também permitam. Se estiver fechada, a ação permanece na fila e é reagendada para a próxima abertura. A instância fica nesse ponto do fluxo até que a ação seja resolvida.

Esperar a abertura é um adiamento normal: não representa falha nem supressão e, por si só, não consome uma tentativa de execução. Quando a janela abre, o PrismaFlow retoma a mesma ação pendente automaticamente. O processamento da fila e outras regras ainda podem adiar sua execução; a abertura é o primeiro momento permitido, não uma promessa de execução naquele segundo.

A verificação considera o momento em que a ação vai executar. Uma ação colocada na fila dentro do horário precisa aguardar a próxima abertura se chegar a sua vez depois do fechamento.

Isso também vale para novas tentativas após uma falha. Se o horário fechar durante o intervalo entre tentativas, a próxima aguarda a reabertura. O histórico das tentativas já realizadas é preservado. Uma solicitação que começou dentro da janela pode terminar depois do fechamento.

Exemplo: funcionamento em dias úteis

Considere uma janela de segunda a sexta-feira, das 9h às 18h, no fuso America/Sao_Paulo.

O horário de abertura está incluído na janela. O horário de fechamento já está fora dela.

O comportamento é o mesmo para qualquer ação. Por exemplo, uma comunicação, uma chamada de webhook e uma ação de entrada em outra jornada precisam respeitar o horário. No último caso, a ação aguarda a janela da jornada de origem antes de criar a participação na jornada de destino; depois, as ações do destino seguem a configuração dele.

Janelas que atravessam a meia-noite

Uma janela pode começar em um dia e terminar no seguinte. Nesse caso, o dia selecionado representa o dia da abertura.

Por exemplo, selecionar segunda-feira, das 22h às 6h, permite executar ações da segunda às 22h até antes das 6h de terça-feira. A madrugada de terça pertence à janela iniciada na segunda, mesmo que terça não esteja selecionada.

Como a janela se combina com outras regras

Entradas e agendamentos

A janela global mantém os gatilhos e agendamentos [blocked] nos horários definidos para eles. Uma pessoa pode entrar fora da janela operacional, respeitando as políticas de entrada. Quando o fluxo chegar a uma ação, ela aguardará um horário permitido para executar.

Esperas e goals

Um wait por janela operacional [blocked] libera a passagem por um ponto específico do fluxo. A janela global continua sendo verificada nas ações seguintes, inclusive quando há uma espera explícita antes delas.

Se uma espera terminar depois do fechamento, ela pode ser concluída normalmente, mas a ação seguinte aguarda a próxima abertura global. Passar por um wait dentro do horário também não libera ações futuras para executar fora dele.

O fechamento da janela não congela os prazos de waits e goals já iniciados. A observação de um objetivo segue sua própria janela de conversão, descrita no guia de goals e resultados [blocked].

Pausa da jornada

Fora do horário, a jornada continua ativa e as ações pendentes aguardam automaticamente a próxima abertura. A pausa da jornada [blocked] exige uma retomada e preserva o tempo restante das esperas e goals. Abrir a janela operacional não retoma uma jornada pausada.

Intervalo entre comunicações

Quando uma ação também está sujeita à proteção contra excesso de comunicações [blocked], as duas regras precisam permitir a execução. Se o intervalo entre comunicações terminar fora do horário de funcionamento, a ação continua aguardando a próxima abertura.

Uma ação que não participa dessa proteção entre comunicações continua sujeita à janela global. Por exemplo, a exceção de webhook ao intervalo entre comunicações não o libera dos horários de funcionamento da jornada.

Conferir uma ação que ainda não executou

Abra a instância e confira a ação pendente na linha do tempo. Compare o momento da execução com os dias, horários e fuso da janela na versão usada por aquela instância.

Confira também se a jornada está pausada, se existe uma espera anterior e se outra regra está adiando a ação. Veja como acompanhar a execução no guia de instâncias, histórico e operação [blocked].

Revisão editorial

• Estado: Em revisão
• Fatos confirmados em: configuração do editor e implementação e testes da PF-1712, revisados em 14/09/2026
• Regra de produto confirmada pelo Darlysson em 14/09/2026: a janela global vale para qualquer ação, incluindo novos tipos de ação