Gatilhos para a aplicação de descontos, passo a passo

Seis gatilhos que ocorrem ao longo de todo o ciclo de vida de um desconto: criação, atualização, eliminação, adição de um código, remoção de um código e expiração - gatilhos que o Shopify nunca apresenta.

Nesta página: Desconto criado, Desconto atualizado, Desconto eliminado, Desconto expirado, Código de desconto adicionado, Código de desconto removido

Desconto criado

É acionado quando é criado um desconto, automático ou com base num código, por parte do pessoal ou por uma aplicação.

Incêndios provocados por	Shopify webhook
Autorização	Acesso a dados com desconto
Ligado	Ativar um fluxo de trabalho do Shopify Flow que o utilize faz com que este seja ativado. O seu próprio botão de ativação encontra-se na página «Gatilhos» da aplicação

Utilize-o para

• Anuncie as novas promoções com antecedência para oferecer suporte, para que ninguém seja apanhado de surpresa por um código.
• Auditar os descontos criados por aplicações ou por funcionários sem aprovação.

O que o «Desconto Created» envia para o seu fluxo de trabalho

Variável em Shopify Flow	Tipo	O que contém
discount	Objeto	O desconto criado
discount.id	ID	O GID do desconto Shopify
discount.title	Texto	O título do desconto
discount.status	Texto	O estado do desconto (ATIVO, CADUCADO, PROGRAMADO)
discount.createdAt	Texto	Quando o desconto foi criado
discount.updatedAt	Texto	Quando foi a última vez que o desconto foi atualizado
discount.startsAt	Texto	Quando o desconto entrar em vigor
discount.endsAt	Texto	Quando o desconto expirar
eventId	Texto	O ID deste evento. Procure-o no Histórico de Eventos da aplicação para ver exatamente o que foi enviado.

Exemplo: Anunciar todos os novos descontos no Slack

1. Selecione «Desconto» como gatilho.
2. Adicione a opção «Enviar pedido HTTP» a um webhook do Slack: New discount "{{discount.title}}" ({{discount.status}}), runs {{discount.startsAt}} to {{discount.endsAt}}.
3. Ative o fluxo de trabalho.

Desconto atualizado

Acusa quando um desconto é editado: título, valor, datas, elegibilidade, estado.

Incêndios provocados por	Shopify webhook
Autorização	Acesso a dados com desconto
Ligado	Ativar um fluxo de trabalho do Flow que o utilize faz com que este seja ativado. O seu próprio botão de ativação encontra-se na página «Gatilhos» da aplicação

Utilize-o para

• Analise as alterações às promoções em curso.
• Volte a sincronizar os dados da promoção com um banner na página inicial da loja virtual ou com uma ferramenta de e-mail.

O que o «Discount Updated» envia para o seu fluxo de trabalho

Variável em Shopify Flow	Tipo	O que contém
discount	Objeto	O desconto atualizado
discount.id	ID	O GID do desconto Shopify
discount.title	Texto	O título do desconto
discount.status	Texto	O estado do desconto (ATIVO, CADUCADO, PROGRAMADO)
discount.createdAt	Texto	Quando o desconto foi criado
discount.updatedAt	Texto	Quando foi a última vez que o desconto foi atualizado
discount.startsAt	Texto	Quando o desconto entrar em vigor
discount.endsAt	Texto	Quando o desconto expirar
eventId	Texto	O ID deste evento. Procure-o no Histórico de Eventos da aplicação para ver exatamente o que foi enviado.

Exemplo: Rever as alterações aos descontos ativos

1. Selecione «Desconto atualizado» como gatilho.
2. Adicione uma condição: discount.status é igual a ACTIVE.
3. Adicione a opção «Enviar e-mail interno com {{discount.title}}» e o link de administração dos descontos.
4. Ative o fluxo de trabalho.

Desconto eliminado

É acionado quando um desconto é eliminado. Apenas o ID e a hora são registados para efeitos de relatório.

Incêndios provocados por	Shopify webhook
Autorização	Acesso a dados com desconto
Ligado	Ativar um fluxo de trabalho do Flow que o utilize faz com que este seja ativado. O respetivo botão de ativação encontra-se na página «Gatilhos» da aplicação

Utilize-o para

• Remova uma promoção eliminada dos banners, feeds ou de uma ferramenta de e-mail.

O que a função «Desconto eliminado» envia para o seu fluxo de trabalho

Variável em Shopify Flow	Tipo	O que contém
discountId	Texto	O GID do desconto Shopify
deletedAt	Texto	A data e hora em que o desconto foi eliminado
eventId	Texto	O ID deste evento. Procure-o no Histórico de Eventos da aplicação para ver exatamente o que foi enviado.

Exemplo: Limpeza após a eliminação de um desconto

1. Selecione «Desconto eliminado» como gatilho.
2. Adicione a opção «Enviar pedido HTTP» ao sistema que espelha as suas promoções, utilizando {{discountId}} e {{deletedAt}}.
3. Ative o fluxo de trabalho.

O desconto expirou

É acionado quando um desconto ultrapassa a data de validade. O Shopify não envia nada nesse momento, pelo que a aplicação verifica periodicamente e é acionada uma vez por cada desconto expirado.

Incêndios provocados por	Verificado periodicamente, uma vez que o Shopify não envia nenhum webhook para esse efeito
Autorização	Acesso a dados com desconto
Ligado	Ativar um fluxo de trabalho do Flow que o utilize faz com que este seja ativado. O seu próprio botão de ativação encontra-se na página «Gatilhos» da aplicação

Utilize-o para

• Retire um banner promocional quando o seu código deixar de funcionar.
• Informe o suporte ao cliente de que uma campanha terminou.
• Dê início à campanha de acompanhamento.

O que o «Discount Expired» envia para o seu fluxo de trabalho

Variável em Shopify Flow	Tipo	O que contém
discount	Objeto	O desconto caducado
discount.id	ID	O GID do desconto no site Shopify
discount.title	Texto	O título do desconto
discount.status	Texto	O estado do desconto
discount.endsAt	Texto	Quando o desconto expirou
discount.startsAt	Texto	Quando o desconto entrou em vigor
eventId	Texto	O ID deste evento. Procure-o no Histórico de Eventos da aplicação para ver exatamente o que foi enviado.

Exemplo: Retire o banner promocional quando o código expirar

1. Selecione «Desconto expirado» como gatilho.
2. Adicione uma atualização ao metacampo da loja (ou envie um pedido via API de administrador) que limpe o metacampo a partir do qual o seu tema lê o banner.
3. Adicione «Enviar e-mail interno: {{discount.title}} expired at {{discount.endsAt}}».
4. Ative o fluxo de trabalho. Para testar, crie um desconto cujo prazo de validade termine daqui a alguns minutos.

Código de desconto adicionado

Aciona-se quando um código de resgate é adicionado a um código de desconto, incluindo códigos gerados em massa.

Incêndios provocados por	Shopify webhook
Autorização	Acesso aos dados de descontos
Ligado	Ativar um fluxo de trabalho do Flow que o utilize ativa-o. O respetivo botão de ativação encontra-se na página «Gatilhos» da aplicação

Utilize-o para

• Registe novos códigos através de uma ferramenta para afiliados ou influenciadores.
• Verifique quem adiciona códigos a uma campanha em curso.

O que a função «Adicionar código de desconto» envia para o seu fluxo de trabalho

Variável em Shopify Flow	Tipo	O que contém
discount	Objeto	O desconto ao qual o código foi associado
discount.id	ID	O GID da Shopify relativo ao desconto
discount.updatedAt	Texto	Quando foi a última vez que o desconto foi atualizado
redeemCode	Objeto	O código de resgate que foi adicionado
redeemCode.id	ID	O GID do código de resgate em Shopify
redeemCode.code	Texto	A sequência do código de resgate
eventId	Texto	O ID deste evento. Procure-o no Histórico de Eventos da aplicação para ver exatamente o que foi enviado.

Exemplo: Registe um novo código na sua ferramenta de afiliados

1. Selecione «Código de desconto adicionado» como gatilho.
2. Adicione a opção «Enviar pedido HTTP» com {{redeemCode.code}} e {{discount.id}}.
3. Ative o fluxo de trabalho.

Código de desconto removido

É acionado quando um código de resgate é removido de um desconto. Contém o código, a frequência com que foi utilizado e se fez parte de uma remoção em massa.

Incêndios provocados por	Shopify webhook
Autorização	Acesso a dados com desconto
Ligado	Ativar um fluxo de trabalho do Flow que o utilize significa ativá-lo. O seu próprio botão de ativação encontra-se na página «Gatilhos» da aplicação

Utilize-o para

• Tome nota quando um código que ainda se encontra em circulação for retirado.
• Evite que os sistemas dos parceiros divulguem códigos inválidos.

O que a funcionalidade «Código de Desconto Removido» envia para o seu fluxo de trabalho

Variável em Shopify Flow	Tipo	O que contém
discount	Objeto	O desconto para o qual o código foi removido
discount.id	ID	O GID do desconto Shopify
discount.updatedAt	Texto	Quando foi a última vez que o desconto foi atualizado
discount.totalUsageCount	Número	Número total de vezes em que o desconto na sua totalidade foi utilizado em todos os seus códigos.
redeemCode	Objeto	O código de resgate que foi removido
redeemCode.id	ID	O GID do código de resgate em Shopify
redeemCode.code	Texto	A sequência do código de resgate
redeemCode.usageCount	Número	Quantas vezes este código foi utilizado antes de ter sido removido. Valor nulo caso tenha sido parte de uma remoção em massa (a utilização por código não pode ser discriminada) ou caso não tenha sido possível determinar esse valor.
redeemCode.bulkRemoval	Verdadeiro / falso	Válido quando o código foi removido no âmbito de uma eliminação em massa, caso em que os dados de utilização por código não estão disponíveis.
eventId	Texto	O ID deste evento. Procure-o no Histórico de Eventos da aplicação para ver exatamente o que foi enviado.

Exemplo: Avisar quando um código utilizado for removido

1. Selecione «Código de desconto removido» como gatilho.
2. Adicione uma condição: redeemCode.usageCount maior que 0 e redeemCode.bulkRemoval igual a false.
3. Adicione «Enviar e-mail interno: Code {{redeemCode.code}} was removed after {{redeemCode.usageCount}} uses».
4. Ative o fluxo de trabalho.

Próximos passos

Guias mais detalhados com a configuração do Slack: Enviar novos descontos para o Slack, Acionar um Shopify Flow quando um desconto expirar e Alertas de código de desconto removido.

• Referência completa sobre os gatilhos - todos os gatilhos numa única página.
• Escolher o gatilho certo - qual é a opção mais adequada ao seu caso.
• Gatilhos personalizados - quando nenhum gatilho integrado for adequado, crie o seu próprio.
• Histórico de eventos e resolução de problemas - ver o que disparou e o que transportava.