Verificação programada de URLs

Normalmente, um webhook aguarda que alguém o acione. Com uma programação, o aplicativo é que realiza a chamada: ele acessa uma URL que você indicar em um intervalo fixo e envia a resposta para o mesmo webhook; assim, seu fluxo de trabalho do Shopify Flow é executado de forma programada a partir de qualquer API que retorne JSON, dados de formulário ou XML.

Usos típicos: obter os dados de estoque de um fornecedor a cada 15 minutos, verificar se há novos pedidos em um ERP a cada hora ou consultar um endpoint de status uma vez por dia e deixar que o Shopify Flow execute as ações necessárias.

Como configurar um

Para criar um novo webhook, selecione “Criar webhook” e responda à pergunta “O que acionará este webhook?” com a opção “Nada - executá-lo de acordo com uma programação”. O webhook é criado com um token secreto, para que ninguém mais possa acessar sua URL, e é aberto na guia “Agendamento”. Para um webhook que você já possui, abra-o e acesse a guia “Agendamento”. Em seguida, preencha:

Campo	O que ele faz
Ativado	Ativa a programação. A URL do webhook continua funcionando de qualquer maneira.
URL	O endereço a ser acessado. Apenas `http` e `https`, e ele deve estar acessível a partir da Internet pública.
Intervalo	A cada 5, 15 ou 30 minutos, a cada 1, 3, 6 ou 12 horas, ou uma vez por dia.
Modo	Cada chamada de `fetch` aciona o Shopify Flow a cada execução. O `Only when the response changes` é acionado apenas quando o corpo da resposta difere da execução anterior.
Cabeçalhos de solicitação	Opcional, para uma chave de API ou um token de portador. Armazenado de forma criptografada e nunca mais exibido.

A primeira execução ocorre em menos de um minuto após a ativação.

Na página “Criar webhook”, na qual é perguntado “O que acionará este webhook?”, com a opção “Nada - executar em horário programado” selecionada e uma observação de que a guia “Programação” será aberta em seguida — Um novo webhook programado: responda “Nada - executar de acordo com a programação” e a guia “Programação” será aberta após você salvar.

A guia “Agendamento” com uma URL a ser consultada, um intervalo de 6 horas e a opção “Somente quando a resposta for alterada” marcada — A guia “Agendamento”: a URL a ser consultada, a frequência e se o Shopify Flow será executado a cada consulta ou apenas quando a resposta for alterada.

Mapeamento da resposta

O corpo do dado recuperado passa pelo webhook exatamente como uma solicitação que alguém lhe enviou: ele é analisado por tipo de conteúdo, seu mapeamento de campos seleciona os valores que o Shopify Flow recebe e a divisão em matriz é aplicada, caso esteja configurada.

Como a API define o próprio formato da resposta, as execuções agendadas ignoram a verificação de “campos inesperados” que se aplica ao JSON enviado pelos seus próprios sistemas. Basta mapear os valores que lhe interessam.

Example responsejson

{
  "updated_at": "2026-09-17T08:00:00Z",
  "items": [
    { "sku": "ABC-1", "stock": 4 },
    { "sku": "ABC-2", "stock": 0 }
  ]
}

Mapeie updated_at a um campo do Shopify Flow para utilizá-lo em seu fluxo de trabalho. Para tratar cada item separadamente, defina o caminho de divisão como items em “Configurações avançadas” - cada elemento, então, acionará sua própria execução no Shopify Flow. Consulte Formatos de corpo e divisão de matrizes.

Execute agora

A opção “Executar agora” realiza uma execução imediata: ela acessa a URL, exibe o status HTTP, a pré-visualização da resposta e o que ocorreu (acionado, inalterado ou erro) e aciona Shopify Flow caso a resposta seja utilizável. Utilize-a após alterar a URL ou os cabeçalhos, em vez de aguardar o próximo intervalo.

Somente quando a resposta mudar

Nesse modo, o aplicativo compara o corpo da resposta obtida com o anterior e só aciona o Shopify Flow quando houver uma diferença. Utilize-o para endpoints que retornam o mesmo documento até que algo realmente mude, como um feed de cotações ou de status. A comparação é feita em todo o corpo da resposta; portanto, uma API que inclua um carimbo de data/hora ou um ID de solicitação em cada resposta apresentará uma aparência diferente a cada vez.

Quando uma programação não dá certo

O bloco “Status” na aba exibe a última execução, o último status HTTP, a próxima execução e o último erro.

Um erro de rede, um código de status diferente de 2xx ou um corpo da resposta que não possa ser analisado é considerado uma execução com falha e não aciona o Shopify Flow.
Após 20 falhas consecutivas, a programação é interrompida automaticamente e exibe uma mensagem informando isso, em vez de continuar tentando acessar uma URL inválida indefinidamente. Corrija a URL ou as credenciais e reative-a.
Atingir o limite do seu plano não é considerado uma falha. Essas execuções são bloqueadas e exibidas no painel.

O que o aplicativo não irá buscar

Apenas endereços públicos. Endereços internos e privados (localhost, intervalos privados, pontos finais de metadados na nuvem) são rejeitados, inclusive quando um redirecionamento aponta para um deles. As respostas estão limitadas a 1 MB e 10 segundos, e são seguidos, no máximo, 3 redirecionamentos. Seus cabeçalhos são descartados caso um redirecionamento leve a um site diferente.

Onde as corridas programadas aparecem

No histórico, com a fonte marcada como “Agendada”. Todo o restante funciona normalmente: a payload, o resultado do gatilho do Shopify Flow, as tentativas de repetição e a reprodução.