Introdução ao livro Workflow Webhooks

Shopify Flow é poderoso, mas reage apenas a eventos dentro do Shopify. Workflow Webhooks elimina essa limitação. Ele oferece um endpoint de URL seguro para o qual sistemas externos podem enviar solicitações POST - e, quando o fazem, seu fluxo de trabalho do Shopify Flow é acionado instantaneamente, com os dados da carga útil transmitidos como variáveis utilizáveis.

Como funciona

• Sua ferramenta externa envia uma solicitação HTTP POST para a URL do seu webhook com um payload JSON (por exemplo, nome, e-mail, pergunta). É compatível com o n8n, o Make, o Zapier ou qualquer ferramenta compatível com HTTP.
• Workflow Webhooks recebe a solicitação, autentica-a e a registra com todos os cabeçalhos e, em seguida, aciona o gatilho Shopify Flow vinculado.
• Shopify Flow executa sua automação - tag um cliente, envia um e-mail, atualiza um metacampo - uso dos dados da payload como variáveis nomeadas ({{fieldOne}}, {{fieldTwo}}, {{fieldThree}}, {{fieldFour}}). Você também pode enviar dados adicionais caso marque a opção Segurança -> Permitir corpo de solicitação personalizado no webhook.
• Um único endpoint de webhook pode alimentar qualquer automação do Shopify Flow.

Recursos

Recurso	Descrição
Gatilhos de webhook para o Shopify Flow	Pontos de conexão HTTP seguros que iniciam qualquer automação do Shopify Flow sob demanda
Mapeamento de variáveis	Mapeie os campos da carga útil para variáveis do Shopify Flow e faça referência a elas como {{fieldOne}}, {{fieldTwo}} etc.
Autenticação	Token estático (simples) ou HMAC SHA256 (à prova de adulteração)
Histórico de invocações	Registro completo de todas as solicitações - data e hora, payload, cabeçalhos e status
Suporte a CORS	Habilitar para integrações baseadas em navegador ou no front-end
Corpo da solicitação personalizada	Aceitar estruturas flexíveis de payload provenientes de plataformas de terceiros
Painel do Webhook	Gerencie, monitore e teste todos os terminais em um único local
Proteção contra duplicatas	Ignore as entregas repetidas que contenham um ID de evento que você 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 que você mapeie campos da sua carga JSON recebida para variáveis nomeadas que o Shopify Flow pode utilizar. Defina até 4 nomes de campo na guia “Configurações avançadas”. Você também pode enviar dados adicionais caso marque a opção “Segurança” → “Permitir corpo de solicitação personalizado”.

Campo no aplicativo	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 tenta novamente enviar um webhook quando não obtém uma resposta rápida. Se a primeira tentativa tiver sido efetivamente recebida, seu fluxo de trabalho no Shopify Flow será executado duas vezes para o mesmo evento - um segundo e-mail, uma segunda tag, uma nota duplicada.

Caso seu sistema de envio inclua um identificador exclusivo para cada evento, nomeie esse cabeçalho em Configurações avançadas → Detecção de entrega duplicada no webhook**,** e as repetições serão ignoradas.

	Comportamento
Primeira solicitação com um determinado ID	Quando processados normalmente, os incêndios se propagam
Repita dentro de 24 horas	200 OK com duplicate: true - não enviado para o Shopify Flow
ID diferente	Processado normalmente
Não há tal cabeçalho na solicitação	Processado normalmente

Nomes comuns de cabeçalhos: Event-Id, Idempotency-Key, X-Request-Id. A correspondência não diferencia 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 uso comuns

• Marcar ou atualizar 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
• Sincronize os dados de contato de um CRM ou sistema de suporte técnico com Shopify sempre que um registro for alterado
• Inicie um 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 habilitado)
• Substitua várias integrações de finalidade única por um gerenciador unificado de webhooks

Guias de integração passo a passo

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

O que dizem os lojistas

"Este aplicativo torna o site Shopify Flow cinco vezes mais útil. É muito fácil entrar em contato com o desenvolvedor" “e extremamente útil.” - SuperFast Startup, Portugal

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

"Exatamente o que eu estava tentando resolver por meio de vários aplicativos de terceiros. Altamente "recomendo." - Aloha Tinyboards, Estados Unidos

Instalar

Instale o aplicativo Workflow Webhooks na loja Shopify

Suporte

Precisa de ajuda? Acesse Suporte ou utilize o balão de bate-papo em qualquer página do aplicativo no seu painel de administração em Shopify.