Introdução ao Workflow Webhooks

Shopify Flow é poderoso, mas reage apenas a eventos no interior de Shopify. Workflow Webhooks elimina essa limitação. Proporciona-lhe um ponto final de URL seguro para o qual os sistemas externos podem enviar pedidos POST - e, quando o fazem, o seu fluxo de trabalho Shopify Flow é acionado instantaneamente, com os dados da carga útil transmitidos como variáveis utilizáveis.

Como funciona

• A sua ferramenta externa envia um pedido HTTP POST para o URL do seu webhook com uma carga JSON (por exemplo, nome, e-mail, pergunta). Funciona com o n8n, o Make, o Zapier ou qualquer ferramenta compatível com HTTP.
• Workflow Webhooks recebe-a, autentica o pedido e regista-o com os cabeçalhos completos e, em seguida, aciona o gatilho Shopify Flow associado.
• Shopify Flow executa a sua automação - atribuir uma etiqueta a um cliente, enviar um e-mail, atualizar um metacampo - utilização dos dados da carga útil como variáveis nomeadas ({{fieldOne}}, {{fieldTwo}}, {{fieldThree}}, {{fieldFour}}). Também pode enviar dados adicionais se assinalar Segurança -> Permitir corpo de pedido personalizado no webhook.
• Um ponto de extremidade de webhook pode alimentar qualquer automação do Shopify Flow.

Características

Característica	Descrição
Gatilhos de webhook para o Shopify Flow	Pontos de acesso HTTP seguros que iniciam qualquer automação do Shopify Flow a pedido
Mapeamento de variáveis	Mapeie os campos da carga útil para variáveis do Shopify Flow, referenciando-os como {{fieldOne}}, {{fieldTwo}}, etc.
Autenticação	Token estático (simples) ou HMAC SHA256 (à prova de adulteração)
Histórico de invocações	Registo completo de todos os pedidos - data e hora, payload, cabeçalhos e estado
Suporte a CORS	Ativar para integrações baseadas no navegador ou no front-end
Corpo da solicitação personalizada	Aceitar estruturas de payload flexíveis provenientes de plataformas de terceiros
Painel de controlo do Webhook	Gerir, monitorizar e testar todos os terminais num único local
Proteção contra duplicações	Ignore as entregas repetidas que incluam um ID de evento que já tenha visto

---

Autenticação

Método	Como funciona	Ideal para
Nenhum	Sem autenticação	Apenas para testes, não para produção
Token estático ✓	Corrigido o token no cabeçalho X-Api-Key	A maioria das integrações (n8n, Make, Zapier)
HMAC SHA256	Assinatura a partir da payload + chave secreta	Alta segurança ou conformidade

Mapeamento de variáveis

Workflow Webhooks permite-lhe associar campos da sua carga JSON recebida a variáveis com nome que o Shopify Flow pode utilizar. Defina até 4 nomes de campos no separador «Definições avançadas». Também pode enviar dados adicionais se selecionar «Segurança» → «Permitir corpo de pedido personalizado».

Campo na aplicação	A sua chave de payload	Referência em Shopify Flow
Campo 1	name	{{fieldOne}}
Campo 2	email	{{fieldTwo}}
Campo 3	question	{{fieldThree}}
Campo 4	other	{{fieldFour}}

Proteção contra entregas duplicadas

A maioria dos sistemas volta a tentar um webhook quando não obtém uma resposta rápida. Se a primeira tentativa tiver sido efetivamente recebida, o seu fluxo de trabalho no Shopify Flow é executado duas vezes para o mesmo evento - um segundo e-mail, uma segunda tag, uma nota duplicada.

Se o seu sistema de envio incluir um identificador único por evento, atribua esse nome ao cabeçalho em «Definições avançadas» → «Detecção de entregas duplicadas» no webhook**,** e as repetições serão ignoradas.

	Comportamento
Primeira solicitação com um determinado ID	Quando processado normalmente, o Shopify Flow funciona corretamente
Repita no prazo de 24 horas	200 OK com duplicate: true - não enviado para o Shopify Flow
ID diferente	Processado normalmente
Não existe esse cabeçalho no pedido	Processado normalmente

Nomes comuns de cabeçalhos: Event-Id, Idempotency-Key, X-Request-Id. A correspondência não distingue maiúsculas de minúsculas.

# Second call with the same Event-Id is accepted but not re-sent to Flow
curl -X POST https://.../webhook/<short> \
  -H "Content-Type: application/json" \
  -H "Event-Id: evt_12345" \
  -d '{"orderId":"1001"}'

Casos de utilização comuns

• Assigne uma etiqueta ou atualize um cliente do Shopify quando um formulário for enviado externamente
• Acionar ações de pedido ou de processamento a partir de um fluxo de trabalho do n8n ou do Make
• Sincronizar os dados de contacto de um CRM ou serviço de assistência com Shopify sempre que um registo for alterado
• Iniciar uma Shopify Flow quando uma automação do Zapier for concluída
• Executar automações a partir de um formulário do front-end (com CORS ativado)
• Substitua várias integrações com uma única finalidade por um gestor de webhooks unificado

Guias de integração passo a passo

1. Como ligar o n8n ao Workflow Webhooks
2. Como ligar o Make ao Workflow Webhooks
3. Como ligar o Zapier ao Workflow Webhooks

O que dizem os lojistas

«Esta aplicação torna o site Shopify Flow cinco vezes mais útil. É muito fácil entrar em contacto com o programador.» «e extremamente útil.» - SuperFast Startup, Portugal

«A peça que faltava para o Shopify Flow - basta um único Shopify Flow para funcionar com todos «de seus webhooks.» - Senkels, Áustria

«Era exatamente isso que eu estava a tentar resolver com uma série de aplicações de terceiros. Muito «recomendo.» - Aloha Tinyboards, Estados Unidos

Instalar

Instale o Workflow Webhooks a partir da App Store do Shopify

Suporte

Precisa de ajuda? Consulte Suporte ou utilize o balão de chat em qualquer página da aplicação no seu painel de administração Shopify.