# Como funciona o agendamento

> Agendamentos, horários, alterações, períodos e execuções: as ideias por trás do Metascheduler e o que acontece em cada momento.

Documentação · 3 min de leitura · Atualizado em 4 de novembro de 2026

## Os blocos de construção

Um **agendamento** é uma entrada no seu calendário. Ele tem um nome, um **horário** e uma lista de **alterações**.

Uma **alteração** é um tipo de edição em um conjunto de itens: "reduzir 20% destas 140 variantes" ou "trocar o menu principal pelo menu da Black Friday". Cada alteração tem:

- um **tipo de alteração**, como Preços de variantes ou Menu de navegação ([todos os tipos](https://metascheduler.app/pt-BR/help/change-types.md));
- os **itens** que ela altera, como produtos, entradas ou um menu;
- o que ela faz no **início**;
- o que acontece **no término**: **Reverter**, **Definir outro valor** ou **Manter**.

As alterações são executadas na ordem em que estão listadas.

## Horário

> **Experimente:** [Como um agendamento é executado](https://metascheduler.app/pt-BR/help/how-scheduling-works)

| Horário | É executado | No término |
| --- | --- | --- |
| **Uma vez** | Uma vez, em uma data e hora. | Nada: as alterações permanecem, como um Lançamento das Implementações. |
| **Período** | Em um início, até um fim. | Cada alteração segue a opção de término dela, como um Evento das Implementações. |
| **Repetir** | Um período que acontece diariamente, semanalmente ou mensalmente. | Cada período é revertido no próprio fim. |
| **Seguir uma implementação** | Quando uma implementação da Shopify fica ativa. | Quando a implementação termina, como você escolheu. |

Cada agendamento tem o próprio **fuso horário**. Os horários são guardados com exatidão e exibidos no fuso do agendamento.

## Status

Um agendamento passa por estes status:

1. **Rascunho**: em preparação. Nunca é executado.
2. **Agendado**: aguardando o início.
3. **Em vigor**: suas alterações estão feitas agora.
4. **Encerrado**: foi executado, e nada mais está previsto.

Você também pode **Pausar** um agendamento (nada novo começa; o que estiver em vigor ainda é revertido no fim) ou **Arquivar** (ele não será executado de novo; o que estiver em vigor ainda é revertido). Um agendamento encerrado ou arquivado não pode ser editado: selecione **Duplicar** para executá-lo de novo.

## O que acontece no início

Para cada item, o Metascheduler:

1. lê o valor atual e o guarda (o instantâneo);
2. grava o novo valor;
3. guarda o que gravou.

Se um item já tem o valor, nada é gravado. Uma porcentagem é sempre calculada a partir do valor guardado, então uma nova tentativa nunca reduz 20% duas vezes.

## O que acontece no término

Para cada item, conforme a opção de término da alteração:

- **Reverter**: se o valor atual ainda é o que o Metascheduler gravou, ele coloca de volta o valor guardado. Se alguém o alterou, ele deixa como está e pergunta a você. Veja [Como funciona a reversão](https://metascheduler.app/pt-BR/help/undo-and-drift.md).
- **Definir outro valor**: grava o valor final que você escolheu.
- **Manter**: não faz nada.

## Execuções atrasadas

O Metascheduler executa cada início e cada fim uma vez, na hora certa. Se ele não conseguir executar na hora (por exemplo, a Shopify estava fora do ar), segue estas regras:

| Situação | O que acontece |
| --- | --- |
| Um início com até 5 minutos de atraso | É executado normalmente. |
| Um início com mais atraso do que isso, dentro do período | É executado e marcado como **Atrasado**. |
| Um início cujo período já terminou | É ignorado e aparece em **Requer sua ação**. O fim dele é cancelado. |
| Um fim, por mais atrasado que esteja | Sempre é executado. Colocar as coisas de volta é o lado seguro. |
| Uma alteração única com mais de um dia de atraso | Aguarda você em **Requer sua ação**: **Executar agora** ou **Ignorar**. |

**Executar agora**, **Tentar novamente** e os inícios de implementações não são retidos por essas regras.

## Novas tentativas

Quando a Shopify está ocupada ou inacessível, o Metascheduler espera e tenta de novo, até 5 vezes, com esperas cada vez maiores. Uma alteração que a Shopify recusa (um valor não permitido, um item que não existe mais) não é repetida: esse item falha e os demais continuam, e a execução mostra **Parcialmente concluído**.

## Conflitos

Quando dois agendamentos alteram o mesmo item em horários que se sobrepõem, o editor o lista em **Conflitos**, e o calendário sinaliza os dois. É um aviso, não um bloqueio: as regras seguras de reversão impedem que a sobreposição atropele qualquer um dos dois.

## Artigos relacionados

- [Como funciona a reversão](https://metascheduler.app/pt-BR/help/undo-and-drift.md): O Metascheduler guarda o que substitui e confere antes de colocar de volta, então nunca sobrescreve uma edição feita nesse meio-tempo.
- [Agende sua primeira alteração](https://metascheduler.app/pt-BR/help/first-schedule.md): Crie um agendamento com início e fim, adicione uma alteração, confira a visualização e agende.
- [Glossário](https://metascheduler.app/pt-BR/help/glossary.md): As palavras que o Metascheduler usa e os status que você verá em agendamentos, execuções e itens.