Verificação programada de URLs

Normalmente, um webhook aguarda que alguém o acione. Com uma programação, é a própria aplicação que o aciona: acede a um URL que indicar num intervalo fixo e envia a resposta para o mesmo webhook, pelo que o seu fluxo de trabalho Shopify Flow é executado de forma programada a partir de qualquer API que devolva JSON, dados de formulário ou XML.

Utilizações típicas: obter os dados de stock de um fornecedor a cada 15 minutos, verificar se há novos pedidos num ERP de hora a hora ou consultar um ponto final de estado uma vez por dia e deixar que o Shopify Flow tome as medidas necessárias.

Como configurar um

Para criar um novo webhook, selecione «Criar webhook» e responda à pergunta «O que irá acionar este webhook?» com «Nada - executá-lo de acordo com uma programação». O webhook é criado com um token secreto, para que mais ninguém possa aceder à sua URL, e abre-se no separador «Agendamento». Para um webhook que já possua, abra-o e aceda ao separador «Agendamento». Em seguida, preencha:

Campo	O que faz
Ativado	Ativa a programação. O URL do webhook continua a funcionar em qualquer dos casos.
URL	O endereço a recuperar. Apenas http e https, e este 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 solicitação aciona o Shopify Flow em cada execução. A resposta «Only when the response changes» só é acionada quando o corpo da resposta difere da execução anterior.
Cabeçalhos de pedido	Opcional, para uma chave API ou um token de portador. Armazenado de forma encriptada e nunca mais apresentado.

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

Mapeamento da resposta

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

Uma vez que a API determina 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-lhe mapear os valores que lhe interessam.

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

Associe o updated_at a um campo «Flow» para o utilizar no seu fluxo de trabalho. Para tratar cada item individualmente, defina o caminho de divisão para items em «Configurações avançadas» - cada elemento irá então executar a sua própria execução do Shopify Flow. Consulte Formatos de corpo e divisão de matrizes.

Execute agora

A opção** «Executar agora»** efetua uma execução imediata: acede ao URL, apresenta-lhe o estado HTTP, a pré-visualização da resposta e o que ocorreu (executado, inalterado ou erro) e aciona o Shopify Flow caso a resposta seja utilizável. Utilize-a após alterar o URL ou os cabeçalhos, em vez de aguardar pelo próximo intervalo.

Apenas quando a resposta mudar

Neste modo, a aplicação compara o corpo da resposta obtida com o anterior e só aciona o Shopify Flow quando houver diferenças. Utilize-o para pontos de extremidade que devolvem o mesmo documento até que algo mude efetivamente, como um feed de cotações ou de estado. A comparação é feita sobre o corpo completo da resposta, pelo que uma API que inclua um carimbo temporal ou um ID de pedido em cada resposta apresentará resultados diferentes em cada ocasião.

Quando um horário não se cumpre

O bloco «Status» neste separador apresenta a última execução, o último estado HTTP, a próxima execução e o último erro.

• Um erro de rede, um código de estado que não seja 2xx ou um corpo da resposta que não possa ser analisado é considerado uma execução falhada e não aciona o Shopify Flow.
• Após 20 falhas consecutivas, a tareta suspende-se automaticamente e indica essa situação, em vez de continuar a aceder indefinidamente a um URL inválido. Corrija o URL ou as credenciais e reative-a.
• Atingir o limite do seu plano não é considerado um falha. Essas execuções são bloqueadas e apresentadas no painel de controlo.

O que a aplicação não irá obter

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

Onde aparecem as execuções agendadas

Na secção «Histórico», com a fonte «Agendado». Tudo o resto funciona como habitualmente: a payload, o resultado do gatilho do Shopify Flow, as tentativas de repetição e a reprodução.