Registro de alterações

O aplicativo fala o seu idioma

Agora, todo o aplicativo se adapta ao idioma que o senhor utiliza no painel de administração do Shopify. Disponível em inglês, alemão, francês, espanhol, italiano, holandês, dinamarquês, português (Brasil e Portugal), japonês e chinês (simplificado e tradicional). Altere o idioma do painel de administração e o aplicativo se adaptará assim que a próxima página for carregada.

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

Sete fluxos de trabalho prontos para uso no Shopify Flow

Abra Shopify Flow, selecione “Procurar modelos” e pesquise por “webhook”. Cada modelo representa um fluxo de trabalho completo no Gatilho de Webhook; basta criar o webhook e configurar seu sistema para utilizá-lo.

• Pedido das tags ao recebimento do webhook - uma ferramenta 3PL, ERP ou sem código marca os pedidos como enviados, faturados ou revisados.
• Adicionar nota ao pedido ao receber o webhook - anexar uma mensagem proveniente de uma ferramenta de suporte ou de um ERP à nota do pedido.
• Marque o pedido como pago ao receber o webhook - quando seu banco, sistema de faturamento ou sistema de pagamento confirmar um pagamento.
• Marcar o produto ao receber o webhook - um fornecedor, PIM ou ERP mantém as coleções e os selos sincronizados.
• Criar cliente ao receber um webhook - coletar leads de páginas de destino e formulários.
• Atualizar o metacampo do cliente ao receber um webhook - um sistema de fidelidade, CRM ou de pontos armazena um número associado ao cliente.
• Retorne o status do pedido ao receber o webhook - forneça informações a um chatbot, central de atendimento ou portal do cliente sobre o status de pagamento e processamento de um pedido, utilizando a resposta síncrona.

A nota de configuração de cada modelo indica quais campos devem ser mapeados. Consulte Modelos de fluxo de trabalho.

O novo design do painel de administração do Shopify

Shopify está lançando um novo visual para o painel de administração. Nas lojas que já contam com essa funcionalidade, o Workflow Webhooks agora utiliza as mesmas cores, tipografia e ícones, de modo que o aplicativo tenha a mesma aparência do restante do seu painel de administração. Nas lojas que ainda não contam com essa funcionalidade, nada muda.

Seus webhooks agora podem ser executados por meio de um temporizador, verificar a assinatura de praticamente qualquer remetente e aceitar outros formatos além do JSON.

Execute um fluxo de trabalho programado por temporizador a partir de qualquer API

Uma nova guia “Agendamento” em cada webhook e uma maneira direta de acessá-la: selecione “Criar webhook” e responda à pergunta “O que acionará este webhook?” com “Nada - executá-lo em um agendamento”. O aplicativo busca uma URL a cada 5 minutos, até uma vez por dia, e envia a resposta para o webhook, de modo que um fluxo de trabalho do Shopify Flow possa ser executado de forma programada a partir de qualquer API.

• Executar o comando “fire” a cada solicitação ou apenas quando a resposta for alterada.
• Adicione cabeçalhos de solicitação, caso a API os exija. Eles são armazenados de forma criptografada.
• A opção “Executar agora” faz uma única consulta e exibe a resposta para o senhor.
• Esta aba mostra como a programação se alinha ao seu plano. As execuções aparecem no Histórico como “Programadas”.
• Uma tarefa que falhe 20 vezes seguidas é automaticamente suspensa.

Consulte Verificação programada de URLs.

Verificação de assinatura para praticamente qualquer remetente

22 predefinições integradas, um aumento em relação às 6 anteriores, cada uma verificada com base na 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 configuração pré-definida é coberto por uma assinatura personalizada: escolha o cabeçalho, o algoritmo, a codificação, um carimbo de data e hora com proteção contra repetição e o texto exato a ser assinado.
• Um verificador de assinatura no editor mostra qual etapa de verificação falha e pode gerar uma solicitação de exemplo válida.
• A criação de um webhook agora começa com a pergunta sobre o que será enviado a ele.

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

Outras formas de autenticação

• Um token estático agora pode ser enviado como um token Bearer, como autenticação básica (nome de usuário e senha) ou como um parâmetro de URL, para remetentes que não possam definir um cabeçalho personalizado. Um token na URL é mascarado no Histórico e nunca é repassado a Shopify Flow.
• Faça a rotação de um segredo sem tempo de inatividade. Um segundo segredo é aceito juntamente com o primeiro, para tokens estáticos e todos os esquemas de assinatura.
• Lista de endereços IP permitidos. Limite o acesso à URL apenas aos endereços ou intervalos de endereços que você listar, além de qualquer autenticação. Consulte Listas de endereços IP permitidos.

Consulte Autenticação.

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

• Formulários de envio, formulários de envio de arquivos e XML agora são lidos em campos mapeáveis, da mesma forma que o JSON. Um corpo de mensagem que seja JSON válido continua sendo lido como JSON; portanto, nenhum remetente existente altera seu comportamento.
• Divida os arrays em execuções. Defina a nova configuração para uma lista na payload e cada item iniciará sua própria execução do Shopify Flow, até 100 por solicitação. Cada item conta como uma invocação.

Consulte Formatos de corpo e divisão de matrizes.

Um aplicativo mais rápido, reconstruído com base nos componentes web dShopify

Agora, todo o aplicativo é executado nos componentes web do próprio painel de administração do Shopify, em vez de em uma biblioteca de interface separada. Há menos conteúdo para carregar, portanto as páginas abrem mais rapidamente, e todos os campos, menus e caixas de diálogo têm a mesma aparência e se comportam da mesma forma que o restante do seu painel de administração.

• O editor de webhooks é um construtor. As configurações ficam à esquerda; à direita, o cartão “Endpoint” com a URL e o ID do webhook, acima das opções “Visualização ao vivo”, “Teste” e “Utilização” - assim, o senhor pode alterar uma configuração e observar a chegada de uma solicitação lado a lado.
• A lista de webhooks exibe cada webhook com sua contagem de invocações, a forma de autenticação dos chamadores e a data da última alteração, com um menu em cada linha para editar, ativar, desativar ou excluir.
• Conectando um remetente assinado. Um webhook para o Stripe, GitHub ou outro provedor exibe as etapas para conectá-lo e um botão que leva ao guia de configuração, em vez de uma solicitação de exemplo que nunca poderia ser verificada.

Também nesta versão

• Solicitações bloqueadas no painel. As solicitações rejeitadas devido ao limite do seu plano costumavam não deixar rastros. Agora, o painel mostra quantas foram bloqueadas nos últimos 30 dias, e o cartão do plano funciona como um medidor de uso.
• 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 um link para o respectivo guia na central de ajuda, e a página de Ajuda apresenta nossos outros aplicativos para o Shopify Flow.
• Manutenção de segurança de rotina. Não é necessária nenhuma ação.

Até agora, um webhook só podia confirmar o recebimento de uma solicitação - seu fluxo de trabalho Shopify Flow era executado em seguida, e o solicitante nunca era informado do resultado. A resposta síncrona muda isso: o aplicativo mantém a solicitação aberta até que seu fluxo de trabalho envie os dados de volta e os retorne ao solicitante.

Útil sempre que o usuário precisar de uma resposta, em vez de um comprovante - um formulário que mostre um resultado, um sistema aguardando um valor calculado, uma consulta.

Como funciona

Ative a opção “Resposta síncrona” nas “Configuraçõ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 em uma ação “Executar Código” e vincule o resultado.

O tempo típico de ida e volta é de dois a quatro segundos. Caso seu fluxo de trabalho não responda em até 15 segundos, o chamador receberá simplesmente a resposta normal - nunca uma mensagem de erro e nunca uma falha no sistema.

Guia completo: Resposta síncrona

Nada muda, a menos que o senhor ligue o aparelho

Desativado por padrão em todos os webhooks. Os webhooks existentes continuam respondendo imediatamente e continuam utilizando o gatilho padrão de webhook, exatamente como antes.

A API REST e o servidor MCP contam agora com um endereço fixo próprio:

https://shopify.workflow-webhooks.app

Portanto, a API está disponível em https://shopify.workflow-webhooks.app/api/v1 e o servidor MCP em https://shopify.workflow-webhooks.app/api/mcp. Ambos são exibidos com um botão “Copiar” na página “Desenvolvedor”.

Anteriormente, esses endereços residiam na URL incorporada ao aplicativo. Separá-los significa que o endereço que o(a) senhor(a) colar em um script, em uma tarefa de CI ou em um assistente de IA é estável e independente da forma como o aplicativo está incorporado no seu painel de administração. O novo nome de host serve exclusivamente à API - o aplicativo em si permanece onde estava, e nada do que o(a) senhor(a) já tenha configurado precisa ser alterado.

Muito mais documentação

Nove novas páginas já estão no ar em Documentação.Fluxo de trabalho.app:

• Crie seu primeiro webhook - do início ao fim, incluindo a integração com o lado do Shopify Flow
• Autenticação - token estático, HMAC e configurações predefinidas para Stripe, GitHub, Shopify, Slack, Typeform e Calendly
• Mapeamento de payload e variáveis de fluxo - caminhos de pontos, valores aninhados e o que fazer quando quatro campos não são suficientes
• Proteção contra entregas duplicadas
• Histórico e solução de problemas - todos os códigos de rejeição e o que fazer a respeito
• Chamada a um webhook a partir do Shopify Flow
• Planos e uso - o que conta para o seu limite e o que não conta
• Aplicativos auxiliares e assistentes de IA
• Perguntas frequentes

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

A maioria dos sistemas tenta novamente enviar um webhook caso não receba uma resposta imediata. Se a primeira tentativa tiver sido efetivamente recebida, seu fluxo de trabalho do 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 isso. Se o seu sistema de envio incluir um identificador exclusivo para cada evento, informe-nos qual cabeçalho o contém e ignoraremos as repetições.

Configure isso em Configurações avançadas -> Entrega duplicada em qualquer webhook. Digite o nome do cabeçalho que seu remetente utiliza - geralmente Event-Id, Idempotency-Key ou X-Request-Id.

• A primeira solicitação com um determinado ID é executada normalmente.
• Qualquer repetição em um intervalo de 24 horas recebe uma resposta normal do tipo 200 OK, de modo que o remetente interrompe tentando novamente - mas não é enviado a Shopify Flow novamente.
• As duplicatas suprimidas não são contabilizadas no limite do seu plano.
• Ainda é possível visualizá-las: o Live Request Inspector exibe a solicitação e a identifica como uma suprimiu a duplicata, de modo que nunca parece que a chamada tenha desaparecido.

Deixe o campo em branco e nada mudará - todas as solicitações serão processadas, exatamente como antes. Essa opção está desativada por padrão em todos os webhooks existentes.

Gerencie seus webhooks a partir de seu próprio código ou de um assistente de IA, como o Claude ou o Cursor.

• Nova página para desenvolvedores: crie chaves de API com escopo e obtenha comandos de conexão prontos para copiar para o Claude Code, Claude Desktop, Cursor, VS Code, Gemini CLI e OpenAI Codex.
• API REST em /api/v1 - listar e gerenciar webhooks, consultar o histórico de chamadas e as estatísticas, listar modelos.
• Servidor MCP em /api/mcp, para que um assistente de IA possa fazer o mesmo durante uma conversa.
• Três níveis de acesso. As chaves de leitura permitem apenas visualizar. As chaves de gravação permitem, além disso, criar, atualizar e excluir webhooks. As chaves de execução permitem, ainda, acionar uma invocação de teste ou reproduzir uma invocação anterior - o que realmente executa seus fluxos de trabalho do Shopify Flow.
• Seus dados permanecem protegidos. O token de autenticação de um webhook nunca pode ser lido por meio da API, e os dados pessoais contidos nos 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 agora é Workflow Webhooks. O mesmo aplicativo, a mesma instalação, os mesmos webhooks - um novo nome, em consonância com o restante da nossa linha de Fluxos de trabalho.

• Novo site de documentação em docs.workflow-webhooks.app, com tutoriais completos sobre o n8n, o Make e o Zapier, incluindo guias em vídeo.
• Nova Central de ajuda - relate um bug, solicite um recurso ou entre em contato conosco por meio de um formulário específico que nos chega diretamente, com capturas de tela anexadas.
• Bate-papo no aplicativo - o balão de bate-papo agora aparece em todas as páginas do aplicativo e, educadamente, fica em segundo plano quando uma janela de diálogo está aberta.
• Guia de configuração no painel, que o orienta desde o seu primeiro webhook até um fluxo de trabalho funcional do Shopify Flow. Ele lembra se você o minimizou.

Manutenção de segurança de rotina: atualizações de dependências e reforço de segurança em todo o aplicativo. Não é necessária nenhuma ação.

• Notificações por e-mail - receba alertas ao se aproximar do limite do seu plano, quando atingi-lo e quando seus webhooks começarem a apresentar falhas com mais frequência do que o normal. Adicione destinatários adicionais além do proprietário da loja, cada um com seu próprio link para cancelar a inscrição.
• Predefinições de assinatura HMAC - adaptam-se ao esquema de assinatura de remetentes comuns sem a necessidade de definir manualmente o formato.
• Ative a opção de enviar mais dados da solicitação - escolha, para cada webhook, se deseja encaminhar os cabeçalhos da solicitação, os parâmetros da string de consulta e o corpo bruto da solicitação para o Shopify Flow.
• Pesquise o histórico de chamadas por conteúdo da payload.

O Sidekick agora pode responder diretamente a perguntas sobre este aplicativo. Faça perguntas como “eu tenho um webhook para o meu formulário de contato?”, “o meu webhook do n8n está ativado?”, “quantas vezes ele foi acionado esta semana?” ou “por que minha última invocação falhou?”.

Somente leitura - O Sidekick pode visualizar seus webhooks, suas configurações e seu histórico de chamadas, mas não pode alterar nada.

Workflow Webhooks agora está em operação em uma nova plataforma de nuvem europeia. Nada muda na forma como o senhor o utiliza, mas, nos bastidores:

• O processamento de webhooks foi transferido para uma fila gerenciada com tratamento de mensagens perdidas, de modo que uma chamada nunca é descartada silenciosamente.
• Os bancos de dados e os caches são locais, restritos à região, na UE, com criptografia em repouso.
• Os segredos comerciais - seus tokens estáticos e chaves HMAC - agora são criptografados por meio de um serviço dedicado de gerenciamento de chaves, e não apenas armazenados de forma criptografada no disco.
• Instâncias redundantes em todas as zonas de disponibilidade.

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

• Cabeçalho de token estático personalizado - o cabeçalho do token não precisa mais ser X-Api-Key. Defina seu próprio nome para cada webhook nas Configurações Avançadas, de modo a corresponder ao que o sistema remetente já envia. 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 agora são atualizados em segundo plano, de modo que as lojas com operações de longa duração não enfrentam mais falhas na entrega após o vencimento de um token.
• Novas tentativas mais inteligentes - as entregas com falha são repetidas com intervalo de espera, e as falhas permanentes interrompem imediatamente as novas tentativas, em vez de esgotar todas as tentativas disponíveis.

• Foram adicionados índices ao banco de dados que agilizam as consultas de histórico e estatísticas em lojas com grande volume de tráfego.
• Adicionamos o monitoramento de desempenho do usuário real para que possamos identificar páginas lentas no painel de administração.
• Avaliação de segurança em toda a aplicação: atualizações de dependências e remoção da renderização de HTML não segura.

• Reestruturei o painel de controle com base em cartões de métricas, um seletor de intervalo de datas e um gráfico de chamadas.
• As alterações não salvas agora estão protegidas. Ao editar um webhook, é exibida a barra de salvamento Shopify, e ao alternar entre abas ou clicar no botão “Voltar” com edições pendentes, o sistema solicita sua confirmação antes de descartá-las, em vez de descartá-las automaticamente.

Histórico de webhooks reindexado. As lojas com grande volume de chamadas notarão que a página de histórico e o painel de controle carregam consideravelmente mais rápido.

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

• Corrigimos um caso extremo de autenticação que poderia rejeitar solicitações válidas.
• Corrigimos a resolução do caminho do proxy para que as URLs do proxy do aplicativo sejam encaminhadas corretamente.
• Corrigimos um erro de exibição na lista de webhooks.

• Ação do Shopify Flow - na direção contrária. Um fluxo de trabalho do Shopify Flow agora pode chamar um webhook como etapa de ação; assim, o Shopify Flow pode enviar dados, além de ser acionado por eles.
• Estatísticas do painel - totais de chamadas, taxa de sucesso e um gráfico referente ao intervalo de datas selecionado.
• Rastreamento da origem das chamadas - agora, o histórico registra se uma chamada foi originada do Shopify Flow, de um teste, do curl ou de um sistema externo, e é possível filtrar com base nisso.

Shopify Flow As variáveis são cadeias de caracteres simples; portanto, objetos e matrizes aninhados costumavam ficar inutilizáveis.

Os valores que são objetos ou matrizes agora são detectados automaticamente e transmitidos ao Shopify Flow como strings JSON; assim, nada se perde silenciosamente durante a importação.

Introduzimos planos de assinatura com uma cota mensal de chamadas e um acompanhamento do uso no painel, para que o senhor possa verificar sua situação em relação ao seu 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 do aplicativo - agora, cada webhook também pode ser acessado por meio de uma URL do proxy do aplicativo Shopify, o que evita problemas de origem cruzada para usuários que acessam pelo navegador.
• Filtro de intervalo de datas na página de histórico, para que o senhor possa identificar o dia em que ocorreu o problema, em vez de precisar rolar a tela.

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

É útil quando a estrutura do payload do sistema remetente não está sob seu controle.

• A configuração do Webhook agora é armazenada em cache; assim, o recebimento de uma chamada exige menos recursos e a resposta é mais rápida.
• Os webhooks desativados são claramente identificados na lista, de modo que fica óbvio, à primeira vista, por que um deles não está sendo acionado.
• Reestruturamos a página de detalhes do webhook, além de termos realizado uma série de pequenas correções.

A primeira versão. O Shopify Flow reage apenas a eventos dentro de Shopify - isso elimina essa restrição.

• Endpoints de webhook - cada webhook recebe sua própria URL segura, para a qual qualquer sistema externo pode enviar uma solicitação POST.
• Três modos de autenticação - Nenhum, para fins de teste; 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 é registrada com seus cabeçalhos, payload, status e tempo de execução.
• Suporte a CORS - ative-o para aceitar chamadas diretamente de um navegador ou de uma loja virtual.
• Painel de webhooks - crie, ative, desative e gerencie em massa todos os endpoints em um único local, com um gerador de tokens com um clique.