Iniciar um fluxo de trabalho posteriormente
Use o campo Run at da ação Gatilho Webhook para iniciar um fluxo de trabalho do Shopify Flow em data e hora definidas ou após um intervalo.
A ação Gatilho Webhook no Shopify Flow aciona um de seus webhooks, e o fluxo de trabalho iniciado a partir desse webhook é executado imediatamente. A ação possui um campo opcional chamado Run at (Executar em). Se houver um valor nesse campo, a chamada fica em espera: até uma data e hora específicas ou por um intervalo de tempo definido por você. É assim que se inicia um fluxo de trabalho em um momento posterior.
O valor pode ser proveniente de uma variável do Shopify Flow; portanto, o tempo de espera pode variar a cada execução. Exemplos: às 9h da data indicada em um metacampo do pedido, três dias após a data de entrega ou na data de renovação de um cliente. Uma etapa de espera com duração fixa não permite isso.
Como funciona
- Um fluxo de trabalho chega à ação Gatilho Webhook com uma data futura no campo
Run at. - O aplicativo armazena a execução juntamente com os valores dos campos daquele momento. A execução agora aparece na lista da página Execuções programadas do aplicativo.
- Quando chegar a hora, o aplicativo aciona o webhook exatamente como se fosse uma chamada imediata. O mapeamento do webhook e a verificação do plano são aplicados nesse momento. Em seguida, é executado o fluxo de trabalho que se inicia com o gatilho Webhook Trigger.
Configure-o
- No Shopify Flow, adicione a ação Gatilho de Webhook a um fluxo de trabalho ou abra um fluxo de trabalho que já a contenha. Consulte Chamada de um webhook a partir do Shopify Flow.
- Selecione o webhook e preencha os campos como de costume.
- Preencha o campo
Run at.
Deixe o campo em branco e a ação acionará o webhook imediatamente. Os fluxos de trabalho que você já possui não serão afetados: sem um valor, a ação funcionará como sempre funcionou.
O que o(a) senhor(a) pode inserir
| Tipo de valor | Exemplo | Quando a corrida começar |
|---|---|---|
| Um atraso de alguns dias | 3 days |
Três dias após a execução da etapa do Shopify Flow |
| Um atraso de algumas horas | 12 hours |
Doze horas após a execução da etapa “Shopify Flow” |
| Um atraso de alguns minutos | 90 minutes |
Noventa minutos após a execução da etapa do Shopify Flow |
| Uma data e hora com um deslocamento em relação ao UTC | 2026-12-24T09:00:00+01:00 |
Exatamente naquele momento |
| Uma data e hora sem deslocamento em relação ao UTC | 2026-12-24 09:00 |
Naquele horário, no fuso horário da sua loja |
| Uma data sem hora | 2026-12-24 |
Às 00h00 daquele dia, no fuso horário da sua loja |
| Um campo vazio | Imediatamente |
Atrasos
Um atraso é um número inteiro seguido de uma unidade: minutos, horas, dias ou semanas. Escreva sempre a unidade em inglês, mesmo que seu painel de administração do Shopify esteja configurado em outro idioma. O aplicativo não reconhece unidades traduzidas.
As formas abreviadas também funcionam: 90 min, 12 h, 3 d, 2 w.
Frações não são aceitas. Para uma hora e meia, digite 90 minutes.
Datas e horários
Escreva o ano, o mês e o dia com hífens. A hora é opcional e vem após um espaço ou após a letra T.
Um deslocamento em relação ao UTC, indicado no final, define o momento exato. Exemplos de deslocamento em relação ao UTC: +01:00, -05:00, Z. A letra Z significa UTC. Sem um deslocamento em relação ao UTC, o aplicativo lê o valor no fuso horário da sua loja.
Variáveis
Uma variável de data do Shopify Flow já está no formato de data e hora com um deslocamento em relação ao UTC. Você pode inseri-la no campo tal como está. Um metacampo de data fornece uma data sem hora, portanto, a execução começa às 00:00 no fuso horário da sua loja.
Limites
- Uma data no passado aciona o webhook imediatamente, como se o campo estivesse vazio. Uma variável que, às vezes, contém uma data já passada, portanto, não interrompe o fluxo de trabalho.
- Uma execução pode ser agendada com, no máximo, 365 dias de antecedência.
Essa etapa também falha com uma mensagem em outros três casos: o webhook está desativado, os campos são grandes demais para o Shopify Flow ou sua loja já possui o número máximo de execuções em espera permitido pelo seu plano.
A página “Execuções programadas”
Abra a página Execuções agendadas no aplicativo. Cada execução é listada com seu webhook, seu status, o horário em que está agendada e a data e hora em que foi criada. Um filtro na parte superior restringe a lista a um único status.
| Status | Significado |
|---|---|
| Programado | A corrida está aguardando o momento certo |
| Enviado | O webhook foi acionado. O link Abrir a invocação leva à entrada no Histórico |
| Falha | A execução estava programada, mas não pôde ser enviada. A coluna Detalhes mostra o motivo |
| Cancelado | A corrida foi cancelada antes mesmo de começar |
Uma execução é iniciada logo após o horário previsto, geralmente em até um minuto. As execuções enviadas, com falha ou canceladas permanecem na página por 30 dias.
Cancelar uma corrida
Clique no botão Cancelar execução em uma execução que ainda esteja em espera e confirme. O webhook dessa execução não será acionado. Essa ação não pode ser revertida. Para executá-la mesmo assim, reinicie o fluxo de trabalho. Uma execução que já tenha sido iniciada não pode mais ser cancelada.
Por que uma execução falhou
| Motivo indicado | O que fazer |
|---|---|
| O limite do plano foi atingido quando a execução estava prevista | Atualize seu plano ou aguarde até que os dados de uso mais antigos saiam do período de 30 dias. Em seguida, reinicie o fluxo de trabalho. A execução não é repetida automaticamente |
| O webhook foi desativado quando a execução estava prevista para ocorrer | Ative o webhook e reinicie o fluxo de trabalho |
| Os campos eram grandes demais para o Shopify Flow | Envie menos dados nos quatro campos |
| A execução não pôde ser encaminhada para o webhook | Um problema da nossa parte não foi resolvido após várias tentativas. Reinicie o fluxo de trabalho e entre em contato conosco caso isso volte a ocorrer |
Um caso específico: um webhook com uma função de transformação pode exibir uma execução como enviada, mesmo sem que tenha ocorrido uma invocação. A função não retornou nada; portanto, nada foi enviado ao Shopify Flow.
O que conta para o seu plano
Uma execução agendada é contabilizada quando é acionada, e não quando é agendada. O agendamento não consome cotas, e uma execução que o(a) senhor(a) cancelar nunca será contabilizada. Quando a execução é acionada, ela conta como uma chamada de webhook, assim como qualquer outra chamada da ação Trigger Webhook.
Isso também significa que o limite do plano é verificado no dia em que a execução está programada. Se o seu plano estiver esgotado nesse momento, a execução falhará e não será enviada posteriormente.
O número de execuções que podem ficar em espera ao mesmo tempo depende do seu plano. Quando esse número for atingido, a etapa Gatilho Webhook apresentará uma falha com uma mensagem até que as execuções em espera tenham sido enviadas ou canceladas. Consulte Planos e uso.
A entrega é feita pelo menos uma vez
Todas as execuções programadas são enviadas. Em casos raros, uma execução pode ser enviada duas vezes, por exemplo, quando nossos servidores reiniciam exatamente no momento em que uma execução é enviada. Crie o fluxo de trabalho de forma que uma repetição não cause danos. Adicionar uma tag duas vezes é inofensivo. Enviar o mesmo e-mail duas vezes, não. Para etapas que não devem se repetir, adicione uma condição que verifique se a tarefa já foi concluída, por exemplo, uma tag que o fluxo de trabalho defina ao final.
Webhooks desativados ou excluídos e desinstalação
- O webhook é desativado quando a etapa do Shopify Flow é executada: a etapa falha e nada é agendado.
- O webhook é desativado posteriormente: as execuções que já estão em espera permanecem na lista. Cada uma delas falhará quando chegar a sua vez, a menos que o webhook seja reativado até lá.
- The webhook is deleted: its scheduled runs are deleted along with it.
- O aplicativo foi desinstalado: as execuções que ainda estão em espera são canceladas e não são enviadas. A reinstalação do aplicativo não as recupera.
Posso alterar o horário de uma execução que está em espera?
Não. Cancele a execução na página Execuções programadas e reinicie o fluxo de trabalho com o novo horário.
Qual fuso horário se aplica?
Um valor com deslocamento em relação ao UTC corresponde a um momento exato e não requer fuso horário. Um valor sem deslocamento em relação ao UTC é interpretado no fuso horário da sua loja. Isso também se aplica a uma data sem hora.
Posso agendar uma chamada para a URL do webhook de fora do Shopify, da mesma forma?
Não. O campo pertence à ação Acionar Webhook no Shopify Flow. Para adiar algo que chega de fora, deixe que o webhook inicie um fluxo de trabalho. Esse fluxo de trabalho, então, utiliza a ação Acionar Webhook com um valor no campo Run at.
Uma execução agendada precisa do token secreto do webhook?
Não. Assim como toda chamada da ação Trigger Webhook, uma execução agendada é originada de dentro do Shopify e ignora a autenticação.
Posso tentar novamente uma execução que falhou?
Não na página Execuções programadas. Corrija a causa indicada na coluna Detalhes e reinicie o fluxo de trabalho.
Relacionado
- Chamada de um webhook a partir do Shopify Flow - a ação “Gatilho Webhook” e seus quatro campos.
- Planos e uso - o que é considerado uma chamada e o que está incluído no seu plano.
- Histórico e solução de problemas - a invocação por trás de uma execução que foi enviada.
- Verificação programada de URLs - um recurso diferente: acessa uma URL de acordo com uma programação e envia a resposta ao Shopify Flow.