Como conectar o WooCommerce ao Shopify Flow

Q: A assinatura não corresponde

Nesta ordem: o segredo (a causa mais comum - um espaço a mais ou uma chave do ambiente errado), se o remetente está utilizando o segredo de um endpoint diferente e se algo entre o WooCommerce e o aplicativo reescreve o corpo da mensagem . As assinaturas abrangem os bytes brutos; portanto, um proxy que reformata o JSON as invalida. O verificador de assinaturas na página do webhook mostra o texto exato que foi assinado.

O WooCommerce pode enviar um Webhook para pedidos, produtos, clientes e cupons de uma loja do WordPress. O Workflow Webhooks transforma essa chamada em um gatilho do Shopify Flow, para que sua loja possa reagir a ela: marcar um cliente, adicionar uma nota ao pedido, enviar um e-mail interno, atualizar um metacampo - tudo o que o Shopify Flow pode fazer.

Este guia define todo o fluxo - o WooCommerce envia, o Workflow Webhooks recebe e verifica, e o Shopify Flow executa - com a assinatura HMAC do WooCommerce verificada em cada solicitação, de modo que somente o WooCommerce possa iniciar seu fluxo de trabalho.

O que o(a) senhor(a) pode construir

Importe um pedido de uma loja do WooCommerce para o Shopify Flow: marque o cliente correspondente ou adicione uma observação.
Mantenha a lista de clientes em dia durante a migração do WooCommerce para o Shopify.
Reaja no Shopify quando um produto ficar sem estoque no WooCommerce.

Eventos típicos a serem enviados: order.created, order.updated, product.updated, customer.created.

Antes de começar

Workflow Webhooks instalado na sua loja do Shopify.
Shopify Flow instalado, que pode ser baixado gratuitamente na App Store do Shopify.
Uma conta no WooCommerce com permissão para criar webhooks.

Etapa 1 - Crie o webhook em Workflow Webhooks

Acesse Workflow Webhooks -> Webhooks -> Criar webhook e atribua a ele um nome que você reconheça no Shopify Flow, como WooCommerce events.
Na seção “Autenticação”, selecione HMAC.
Em “Provedor de assinatura”, selecione WooCommerce. O aplicativo preenche automaticamente o cabeçalho, o algoritmo, o payload assinado e a janela de repetição para você - não há mais nada a configurar.
Deixe o campo “segredo” em branco por enquanto e clique em “Salvar”. Copie a URL da webhook exibida na página.

Consulte Autenticação para conhecer os outros modos de autenticação e Mapeamento de payload e variáveis de fluxo para escolher quais campos serão enviados para Shopify Flow.

Etapa 2 - Adicione o endpoint no WooCommerce

No WordPress, abra WooCommerce → Configurações → Avançado → Webhooks, adicione um webhook com a URL como “URL de entrega” e defina o “Segredo”.

Como localizar seu segredo de assinatura do WooCommerce

O parâmetro “Secret” definido no webhook (WooCommerce -> Configurações -> Avançado -> Webhooks).

A própria documentação do WooCommerce sobre assinaturas de webhooks contém o texto exato e as capturas de tela referentes à sua conta.

Cole esse segredo no campo “Secret” do webhook em Workflow Webhooks e salve. A partir desse momento, todas as entregas do WooCommerce serão verificadas antes de chegarem ao Shopify Flow.

O que essa verificação verifica

O que	Valor
Cabeçalho de assinatura	`X-WC-Webhook-Signature`
Onde fica a assinatura	O valor completo do cabeçalho
O que foi assinado	`{body}`
Assinatura	HMAC-SHA256, codificado em base64
Data e hora	Não é utilizado por este remetente
Proteção contra reprodução	Nenhuma - esse remetente não assina o carimbo de data e hora; portanto, todas as assinaturas válidas permanecem válidas
O segredo	Utilizado como texto simples. Cole-o exatamente como o remetente o apresenta

Na payload assinada, {body} é o corpo da solicitação em formato bruto, byte por byte.

Uma solicitação que não atenda a qualquer um desses critérios é rejeitada com o código de erro 401, é registrada em Histórico e solução de problemas e nunca inicia um fluxo de trabalho.

Etapa 3 - Criar o fluxo de trabalho Shopify Flow

No “Shopify Flow”, crie um fluxo de trabalho e selecione o gatilho “Workflow Webhooks”.
Clique em “Gravar eventos” e, em seguida, envie um evento de teste a partir do WooCommerce (ou utilize a opção “Enviar teste” em Workflow Webhooks) para que o Shopify Flow aprenda o formato dos seus dados.
Cada webhook de que o senhor dispõe aciona o mesmo gatilho do Shopify Flow; portanto, adicione uma primeira condição com base no ID do webhook para restringir esse fluxo de trabalho exclusivamente ao WooCommerce. O ID é exibido na página do webhook.
Adicione suas ações - tag um cliente, adicione uma nota, envie um e-mail interno, atualize um metacampo.

Condição do Shopify Flow: o ID do webhook é igual ao ID de um webhook — O primeiro passo de todo fluxo de trabalho: uma condição baseada no ID do webhook, para que o fluxo de trabalho seja executado apenas para esse webhook.

O fluxo de trabalho finalizado: Gatilho de webhook, uma condição com base no ID do webhook e, em seguida, o envio de um e-mail interno no ramo “Verdadeiro” — O fluxo de trabalho finalizado: gatilho, condição com base no ID do Webhook e, em seguida, sua ação no ramo “True”.

Etapa 4 - Teste de ponta a ponta

Acionem um evento real no WooCommerce. Em “Workflow Webhooks” → “Histórico”, vocês deverão ver a invocação com o status “Sucesso”. Caso a assinatura esteja incorreta, será exibida uma entrada com status de falha e o motivo correspondente; além disso, a página Verificação de webhooks assinados explica como funciona o verificador de assinaturas, que indica exatamente em qual etapa ocorreu a falha.

Uma invocação foi aberta no History com seus cabeçalhos de solicitação, payload, status, duração e identificadores — Um evento registrado no History com o status “Sucesso” significa que Shopify Flow o aceitou.

A assinatura não corresponde▾

Nesta ordem: o segredo (a causa mais comum - um espaço a mais ou uma chave do ambiente errado), se o remetente está utilizando o segredo de um endpoint diferente e se algo entre o WooCommerce e o aplicativo reescreve o corpo da mensagem. As assinaturas abrangem os bytes brutos; portanto, um proxy que reformata o JSON as invalida. O verificador de assinaturas na página do webhook mostra o texto exato que foi assinado.

Recebo um erro 401 em todas as solicitações▾

Verifique se a autenticação do webhook está configurada como HMAC com o provedor WooCommerce selecionado, se o segredo está preenchido e se o WooCommerce está enviando dados para a URL exatamente como o aplicativo a exibe, incluindo o código no final.

Não há nada no Histórico▾

A solicitação nunca foi recebida. Verifique novamente a URL no WooCommerce e consulte o próprio registro de entrega do WooCommerce para ver a resposta recebida. Um erro do tipo 404 indica um webhook incorreto ou excluído; um erro do tipo 429 significa que você ultrapassou o limite de invocações do seu plano - consulte Planos e uso.

O fluxo de trabalho é executado para os eventos incorretos▾

Cada webhook da sua loja aciona o mesmo gatilho do Shopify Flow. Adicione uma condição com base no ID do webhook como primeira etapa do fluxo de trabalho ou restrinja os eventos enviados pelo WooCommerce.

Relacionado

Verificação de webhooks assinados - todos os prestadores de serviços que verificamos e como descrever aqueles que não verificamos.
Mapeamento de payload e variáveis de fluxo - extrair os campos corretos da payload e inseri-los em Shopify Flow.
Proteção contra entregas duplicadas - o que ocorre quando o WooCommerce tenta novamente uma entrega.
Histórico e solução de problemas - o registro de todas as solicitações, com reprodução.