Registro de alterações

A aplicação fala a sua língua

A aplicação passa agora a apresentar-se no idioma que utilizar no painel de administração do Shopify. Está disponível em inglês, alemão, francês, espanhol, italiano, neerlandês, dinamarquês, português (do Brasil e de Portugal), japonês e chinês (simplificado e tradicional). Altere o idioma do painel de administração e a aplicação adaptará-se na próxima vez que a página for carregada.

• Todas as páginas, caixas de diálogo e mensagens estão traduzidas, incluindo o editor de webhooks, o verificador de assinaturas e os seus diagnósticos passo a passo, o Histórico e a página de Ajuda.
• Os modelos de fluxo de trabalho apresentam o título, a descrição e as notas de configuração no seu idioma no Shopify Flow.
• As datas e os números são apresentados da forma como se escrevem no seu idioma.
• Esta central de ajuda também está traduzida. Todos os guias estão disponíveis nos mesmos idiomas; selecione o seu no menu de idiomas.
• Os nomes dos gatilhos e das ações mantêm-se em inglês. O Shopify Flow apresenta os nomes das etapas em inglês, pelo que a aplicação também o faz - o nome que vê na aplicação é sempre o mesmo que encontra no Shopify Flow. Os nomes dos campos de payload, tais como fieldOne, também não se alteram.

Sete fluxos de trabalho pré-definidos no Shopify Flow

Abra o Flow, selecione «Procurar modelos» e pesquise por «webhook». Cada modelo constitui um fluxo de trabalho completo no «Webhook Trigger»; basta criar o webhook e configurar o seu sistema para que este o utilize.

• Pedido de pedido aquando da receção do webhook - uma ferramenta 3PL, ERP ou «no-code» marca os pedidos como enviados, faturados ou revisados.
• Adicionar nota ao pedido quando for recebido um webhook - anexar uma mensagem proveniente de uma ferramenta de suporte ao cliente ou de um ERP à nota do pedido.
• Marque o pedido como pago quando for recebido o webhook - o seu banco, sistema de faturação ou sistema de pagamentos confirmar um pagamento.
• Assignar uma etiqueta ao produto quando for recebido um webhook - um fornecedor, PIM ou ERP mantém as coleções e os emblemas sincronizados.
• Criar um cliente quando for recebido um webhook - recolher leads a partir de páginas de destino e formulários.
• Atualizar o metacampo do cliente quando for recebido um webhook - um sistema de fidelização, CRM ou de pontos armazena um número associado ao cliente.
• Indicar o estado do pedido quando for recebido um webhook - forneça informações a um chatbot, serviço de apoio ao cliente ou portal do cliente sobre o estado do pagamento e do processamento do pedido, utilizando a resposta síncrona.

As notas de configuração de cada modelo indicam-lhe quais os campos que deve mapear. Consulte Modelos de fluxo de trabalho.

O novo design da área de administração do Shopify

Shopify está a implementar um novo visual para o painel de administração. Numa loja que já disponha desta funcionalidade, o Workflow Webhooks utiliza agora as mesmas cores, tipografia e ícones, pelo que a aplicação apresenta um aspeto semelhante ao resto do seu painel de administração. Numa loja que ainda não disponha desta funcionalidade, nada muda.

Os seus webhooks podem agora ser executados de forma programada, verificar a assinatura de praticamente qualquer remetente e aceitar mais do que apenas JSON.

Executar um fluxo de trabalho com temporizador a partir de qualquer API

Um novo separador «Agendamento» em cada webhook e uma forma direta de aceder: selecione «Criar webhook» e responda à pergunta «O que irá acionar este webhook?» com «Nada - executar de acordo com um agendamento». A aplicação recupera um URL a cada 5 minutos, até uma vez por dia, e envia a resposta para o webhook, pelo que um fluxo de trabalho Shopify Flow pode ser executado de forma programada a partir de qualquer API.

• Executar o comando «fire» em cada chamada, ou apenas quando a resposta se alterar.
• Adicione cabeçalhos de pedido, caso a API os necessite. Estes são armazenados de forma encriptada.
• A função «Run now» efetua uma única consulta e apresenta-lhe a resposta.
• Este separador mostra como a programação se compara ao seu plano. As execuções aparecem no Histórico como «Programadas».
• Uma tarefa que falhe 20 vezes seguidas suspende-se automaticamente.

Consulte Verificação programada de URLs.

Verificação da assinatura para praticamente qualquer remetente

22 predefinições integradas, em comparação com as 6 anteriores, cada uma verificada em relação à documentação do próprio remetente: Stripe, GitHub, Shopify, Slack, Typeform, Calendly, Webhooks padrão (OpenAI, Supabase), Svix (Clerk, Resend), Paddle, Linear, WooCommerce, Square, Sentry, Vercel, Zendesk, Lemon Squeezy, Razorpay, Paystack, Customer.io, Sendcloud, Mollie e Sanity.

• Um remetente sem uma predefinição é abrangido por uma assinatura personalizada: escolha o cabeçalho, o algoritmo, a codificação, um carimbo temporal com proteção contra repetição e o texto exato que é assinado.
• Um verificador de assinaturas no editor indica qual a etapa de verificação que falha e pode gerar um exemplo de pedido válido.
• A criação de um webhook começa agora por perguntar o que lhe será enviado.

Consulte Verificação de webhooks assinados, onde encontrará um guia passo a passo para cada remetente.

Mais formas de autenticação

• Um token estático pode agora ser recebido como um token «Bearer», como autenticação «Basic» (nome de utilizador e palavra-passe) ou como um parâmetro de URL, no caso de remetentes que não possam definir um cabeçalho personalizado. Um token presente na URL é ocultado no Histórico e nunca é transmitido a Shopify Flow.
• Alterne um segredo sem tempo de inatividade. É aceite um segundo segredo a par do primeiro, para tokens estáticos e para todos os esquemas de assinatura.
• Lista de endereços IP autorizados. Limite o acesso à URL aos endereços ou intervalos que indicar, para além de qualquer autenticação. Consulte Listas de endereços IP autorizados.

Consulte Autenticação.

Corpos de formulários e XML, e divisão de matrizes

• Os formulários de envio, os formulários de carregamento de ficheiros e o XML são agora lidos em campos mapeáveis, tal como o JSON. Um corpo que seja JSON válido continua a ser lido como JSON, pelo que nenhum remetente existente altera o seu comportamento.
• Divida os arrays em execuções. Defina a nova configuração para uma lista na payload e cada item iniciará a sua própria execução do Shopify Flow, até um máximo de 100 por pedido. Cada item conta como uma invocação.

Consulte Formatos de corpo e divisão de matrizes.

Uma aplicação mais rápida, reconstruída com base nos componentes web dShopify

A aplicação completa funciona agora com base nos componentes web do próprio painel de administração do Shopify, em vez de uma biblioteca de interfaces separada. Há menos conteúdo para carregar, pelo que as páginas abrem mais rapidamente e todos os campos, menus e caixas de diálogo têm o mesmo aspeto e comportamento que o resto do seu painel de administração.

• O editor de webhooks é um construtor. As definições encontram-se à esquerda; à direita, o cartão «Endpoint» com o URL e o ID do webhook, acima das opções «Pré-visualização em tempo real», «Teste» e «Utilização» - assim, pode alterar uma definição e observar a chegada de um pedido em paralelo.
• A lista de webhooks apresenta cada webhook com o respetivo número de invocações, a forma como os utilizadores se autenticam e a data da última alteração, com um menu em cada linha que permite editar, ativar, desativar ou eliminar.
• Ligar um remetente assinado. Um webhook para o Stripe, o GitHub ou outro fornecedor apresenta os passos para o ligar e um botão que remete para o seu guia de configuração, em vez de um pedido de amostra que nunca poderia ser verificado.

Também nesta versão

• Pedidos bloqueados no painel de controlo. Os pedidos rejeitados devido ao limite do seu plano não deixavam, anteriormente, qualquer registo. O painel de controlo apresenta agora o número de pedidos bloqueados nos últimos 30 dias, e o cartão do plano funciona como um medidor de utilização.
• A paginação na lista de webhooks funciona e a opção «Limpar tudo» no Histórico também limpa o filtro «Reproduzidos».
• Cada página contém uma ligação para o respetivo guia na central de ajuda, e a página de Ajuda apresenta uma lista das nossas outras aplicações para o Shopify Flow.
• Manutenção de segurança de rotina. Não é necessária qualquer ação.

Até agora, um webhook só podia confirmar a receção de um pedido - o seu fluxo de trabalho Shopify Flow era executado posteriormente e quem efetuou o pedido nunca ficava a saber o resultado. A resposta síncrona altera essa situação: a aplicação mantém o pedido aberto até que o seu fluxo de trabalho envie os dados de volta e, em seguida, devolve-os a quem efetuou o pedido.

Útil sempre que o utilizador necessita de uma resposta em vez de um recibo - um formulário que apresente um resultado, um sistema que aguarde um valor calculado, uma pesquisa.

Como funciona

Ative a opção «Resposta síncrona» nas «Definições avançadas» do webhook. Em seguida, crie o fluxo de trabalho com base no novo «Gatilho de webhook de sincronização» e conclua-o com a nova ação «Resposta de webhook de retorno».

Escreva o corpo da resposta diretamente na ação, utilizando as variáveis do gatilho:

{"ok": true, "orderId": "{{fieldOne}}", "email": "{{fieldTwo}}"}

ou crie algo mais complexo numa ação «Executar Código» e atribua o resultado.

Um ciclo típico de ida e volta demora entre dois a quatro segundos. Se o seu fluxo de trabalho não responder no prazo de 15 segundos, quem liga recebe simplesmente a resposta normal - nunca uma mensagem de erro, nem fica a linha em espera.

Guia completo: Resposta síncrona

Nada muda a menos que o ligue

Desativado por predefinição em todos os webhooks. Os webhooks existentes continuam a responder imediatamente e a utilizar o «Webhook Trigger» padrão, exatamente como antes.

A API REST e o servidor MCP têm agora um espaço próprio e permanente:

https://shopify.workflow-webhooks.app

Assim, a API encontra-se em https://shopify.workflow-webhooks.app/api/v1 e o servidor MCP em https://shopify.workflow-webhooks.app/api/mcp. Ambos são apresentados com um botão «Copiar» na página «Desenvolvedor».

Anteriormente, estes encontravam-se no URL incorporado da aplicação. A sua separação significa que o endereço que colar num script, numa tarefa de CI ou num assistente de IA é estável e não está relacionado com a forma como a aplicação está incorporada no seu painel de administração. O novo nome de host serve apenas a API - a própria aplicação permanece onde estava e nada do que já tenha configurado precisa de ser alterado.

Muito mais documentação

Estão disponíveis nove novas páginas em docs.workflow-webhooks.app:

• Crie o seu primeiro webhook - de início a fim, incluindo a integração com o lado do Shopify Flow
• Autenticação - token estático, HMAC e predefinições para o Stripe, GitHub, Shopify, Slack, Typeform e Calendly
• Mapeamento da payload e variáveis de fluxo - percursos «dot», valores aninhados e o que fazer quando quatro campos não são suficientes
• Proteção contra entregas duplicadas
• Histórico e resolução de problemas - todos os códigos de rejeição e o que fazer em cada caso
• Chamar um webhook a partir do Shopify Flow
• Planos e utilização - o que conta para o seu limite e o que não conta
• Aplicativos auxiliares e assistentes de IA
• Perguntas frequentes

A API para programadores e o guia do MCP também foram publicados.

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

A proteção contra entregas duplicadas resolve esse problema. Se o seu sistema de envio incluir um identificador único por evento, indique-nos qual o cabeçalho que o contém e ignoraremos as repetições.

Configure esta opção em «Definições avançadas» → «Duplicar entrega em qualquer webhook». Introduza o nome do cabeçalho que o seu remetente utiliza - normalmente Event-Id, Idempotency-Key ou X-Request-Id.

• O primeiro pedido com um determinado ID é executado normalmente.
• Qualquer repetição no prazo de 24 horas recebe uma resposta normal do tipo 200 OK, pelo que o remetente deixa de o fazer A tentar novamente - mas não é enviado novamente para Shopify Flow.
• As duplicatas suprimidas não contam para o limite do seu plano.
• Ainda é possível vê-las: o Live Request Inspector apresenta o pedido e identifica-o como um suprimiu a duplicata, pelo que nunca parece que a chamada tenha desaparecido.

Deixe o campo em branco e nada muda - todos os pedidos são processados, exatamente como antes. Esta opção está desativada por predefinição em todos os webhooks existentes.

Faça a gestão dos seus webhooks a partir do seu próprio código ou de um assistente de IA, como o Claude ou o Cursor.

• Nova página para programadores: crie chaves de API com âmbito específico e obtenha comandos «connect» prontos a copiar para o Claude Code, Claude Desktop, Cursor, VS Code, Gemini CLI e OpenAI Codex.
• API REST em /api/v1 - listar e gerir webhooks, consultar o histórico de invocações e as estatísticas, listar modelos.
• Servidor MCP em /api/mcp, para que um assistente de IA possa fazer o mesmo numa conversa.
• Três níveis de acesso. As chaves de leitura permitem apenas consultar. As chaves de escrita permitem também criar, atualizar e eliminar webhooks. As chaves de execução permitem, além disso, disparar uma invocação de teste ou reproduzir uma invocação anterior - o que permite, de facto, executar os seus fluxos de trabalho do Shopify Flow.
• Os seus dados permanecem protegidos. O token de autenticação de um webhook nunca pode ser lido através da API, e os dados pessoais contidos nas payloads das solicitações (endereços de e-mail, números de telefone, nomes, números de cartão) são mascarados antes de saírem do servidor.

Flow Webhooks passa a ser Workflow Webhooks. A mesma aplicação, a mesma instalação, os mesmos webhooks - um novo nome, em consonância com o resto da nossa gama de Fluxos de trabalho.

• Novo site de documentação em , docs.workflow-webhooks.app e, com tutoriais completos sobre o n8n, o Make e o Zapier, incluindo guias em vídeo.
• Nova Central de ajuda - comunique um erro, solicite uma funcionalidade ou contacte-nos através de um formulário específico que nos chega diretamente, com capturas de ecrã em anexo.
• Chat na aplicação - o balão de chat está agora presente em todas as páginas da aplicação e, quando uma janela de diálogo está aberta, sai educadamente do caminho.
• Guia de configuração no painel de controlo, que o acompanha desde o seu primeiro webhook até a um fluxo de trabalho Shopify Flow em funcionamento. Este guia guarda a sua preferência de se o tiver recolhido ou não.

Manutenção de segurança de rotina: atualizações de dependências e reforço da segurança em toda a aplicação. Não é necessária qualquer ação.

• Notificações por e-mail - receba avisos à medida que se aproxima do limite do seu plano, quando o atingir e quando os seus webhooks começarem a falhar com mais frequência do que o habitual. Adicione destinatários adicionais para além do proprietário da loja, cada um com o seu próprio link para cancelar a subscrição.
• Predefinições de assinatura HMAC - adaptam-se ao esquema de assinatura de remetentes comuns sem necessidade de definir manualmente o formato.
• Ative a opção para obter mais dados da solicitação - escolha, para cada webhook, se pretende transmitir os cabeçalhos da solicitação, os parâmetros da cadeia de consulta e o corpo da solicitação em formato bruto ao Shopify Flow.
• Pesquisar o histórico de chamadas com base no conteúdo da payload.

O Sidekick já pode responder diretamente a perguntas sobre esta aplicação. Pode perguntar coisas como «tenho um webhook para o meu formulário de contacto?», «o meu webhook do n8n está ativado?», «quantas vezes foi acionado esta semana?» ou «por que razão a minha última invocação falhou?».

Apenas para leitura - O Sidekick pode consultar os seus webhooks, a respetiva configuração e o histórico de chamadas, mas não pode alterar nada.

Workflow Webhooks funciona agora numa nova plataforma na nuvem europeia. Não há alterações na forma como o utiliza, mas, nos bastidores:

• O processamento de webhooks foi transferido para uma fila gerida com tratamento de mensagens não entregues, pelo que uma chamada nunca é descartada silenciosamente.
• As bases de dados e as memórias cache são locais a nível regional na UE, com encriptação em repouso.
• Os segredos comerciais - os seus tokens estáticos e chaves HMAC - são agora encriptados através de um serviço dedicado de gestão de chaves, não ficando apenas armazenados de forma encriptada ao nível do disco.
• Instâncias redundantes em diferentes zonas de disponibilidade.

O resultado é uma menor latência na receção de webhooks e um desempenho significativamente melhor sob carga.

• Cabeçalho de token estático personalizado - o cabeçalho do token já não tem de ser X-Api-Key. Defina o seu próprio nome por webhook nas «Definições Avançadas», de modo a corresponder ao que o sistema remetente já envia. Os nomes de cabeçalhos reservados e controlados por proxy são rejeitados por motivos de segurança.
• Atualização automática da sessão - os tokens de acesso são agora atualizados em segundo plano, pelo que as lojas com operações de longa duração já não registam falhas nas entregas após a expiração de um token.
• Novas tentativas mais inteligentes - as entregas mal sucedidas são repetidas com um período de espera, e as falhas permanentes cessam imediatamente as novas tentativas, em vez de esgotarem todas as tentativas disponíveis.

• Foram adicionados índices à base de dados que aceleram as consultas de histórico e estatísticas em lojas com elevado volume de tráfego.
• Foi adicionado o monitorização do desempenho dos utilizadores reais, para que possamos detetar páginas lentas na área de administração.
• Avaliação de segurança em toda a aplicação: atualizações de dependências e eliminação da renderização de HTML não segura.

• Reestruturámos o painel de controlo em torno de cartões de métricas, de um seletor de intervalo de datas e de um gráfico de invocações.
• As alterações não guardadas estão agora protegidas. Ao editar um webhook, é apresentada a barra de gravação dShopify e, ao alternar entre separadores ou clicar no botão «Voltar» com alterações pendentes, o sistema solicita-lhe primeiro a sua confirmação, em vez de as descartar silenciosamente.

Histórico de webhooks reindexado. As lojas com grandes volumes de chamadas irão notar que a página do histórico e o painel de controlo carregam consideravelmente mais depressa.

• Repetir - abra qualquer invocação anterior e reenvie-a com um clique. Esta é a forma mais rápida de configurar um fluxo de trabalho no Flow: registe os eventos no Flow e, em seguida, repita uma chamada real em vez de reativar o sistema de origem.
• Modelos de webhooks - pontos de partida pré-configurados para o n8n, Make, Zapier, formulários de contacto e integrações personalizadas.

• Corrigiu-se um caso extremo de autenticação que podia rejeitar pedidos válidos.
• Corrigimos a resolução do caminho do proxy para que os URLs do proxy da aplicação sejam encaminhados corretamente.
• Corrigiu-se um erro de visualização na lista de webhooks.

• Ação do Shopify Flow - na direção inversa. Um fluxo de trabalho do Shopify Flow pode agora chamar um webhook como etapa de ação, pelo que o Shopify Flow pode enviar dados, bem como ser acionado por eles.
• Estatísticas do painel de controlo - totais de chamadas, taxa de sucesso e um gráfico relativo ao intervalo de datas por si selecionado.
• Rastreio da origem das chamadas - o histórico regista agora se uma chamada provém do Shopify Flow, de um teste, do curl ou de um sistema externo, e pode filtrar os resultados com base nessa informação.

Shopify Flow As variáveis são cadeias de caracteres simples, pelo que os objetos e matrizes aninhados costumavam tornar-se inutilizáveis.

Os valores que são objetos ou matrizes são agora detetados automaticamente e transmitidos a Shopify Flow como cadeias de caracteres JSON, pelo que nada se perde silenciosamente durante a importação.

Foram introduzidos planos de subscrição com um limite mensal de invocações e um acompanhamento da utilização no painel de controlo, para que possa verificar a sua situação em relação ao limite.

Todos os planos incluem todos os métodos de autenticação, mapeamento de campos, CORS, histórico e reprodução - os planos diferem apenas no volume mensal.

• Ponto de extremidade do proxy da aplicação - cada Webhook pode agora também ser acedido através de um URL de proxy da aplicação do tipo Shopify, o que evita problemas de origem cruzada para os utilizadores que efetuam chamadas a partir do navegador.
• Filtro de intervalo de datas na página do histórico, para que possa identificar o dia em que ocorreu um problema, em vez de ter de percorrer a página.

Quatro campos mapeados nem sempre são suficientes. Ative a opção «Permitir corpo de pedido personalizado» nas definições de segurança de um webhook e toda a carga útil recebida será encaminhada para Shopify Flow, para além dos quatro campos nomeados.

Útil quando não lhe cabe a si controlar a forma do payload do sistema remetente.

• A configuração do webhook é agora armazenada em cache, pelo que a receção de uma chamada implica menos trabalho e uma resposta mais rápida.
• Os webhooks desativados são claramente identificados na lista, pelo que é possível perceber à primeira vista por que razão um deles não está a ser acionado.
• Reestruturámos a página de detalhes do webhook e implementámos ainda uma série de pequenas correções.

A primeira versão. O Shopify Flow apenas reage a eventos no interior de Shopify - isto elimina essa limitação.

• Pontos de extremidade de webhooks - cada webhook dispõe de um URL seguro próprio, para o qual qualquer sistema externo pode enviar um pedido POST.
• Três modos de autenticação: «Nenhum» para testes, um token estático no cabeçalho X-Api-Key ou HMAC SHA256 para assinatura à prova de adulteração.
• Payload mapping - mapeie até quatro campos do JSON recebido e utilize-os no Shopify Flow como {{fieldOne}} para {{fieldFour}}.
• Histórico de chamadas - cada chamada é registada com os seus cabeçalhos, payload, estado e tempo de execução.
• Suporte a CORS - ative-o para aceitar chamadas diretamente a partir de um navegador ou de um formulário da loja virtual.
• Painel de controlo do Webhook - crie, ative, desative e faça a gestão em massa de todos os pontos de extremidade num único local, com um gerador de tokens com um único clique.