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, exclusão, adição de um código, remoção de um código e vencimento - o que o Shopify nunca relata de forma alguma.

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

Desconto criado

É acionado quando um desconto é criado, seja automático ou baseado em código, pela equipe ou por um aplicativo.

Incêndios causados por	Shopify webhook
Permissão	Acesso a dados com desconto
Ligado	Ativar um fluxo de trabalho do Flow que o utilize faz com que ele seja ativado. Seu próprio botão de ativação está na página “Gatilhos” do aplicativo

Utilize-o para

• Anunciem as novas promoções com antecedência para fornecer suporte, para que ninguém seja pego de surpresa por um código.
• Auditar descontos criados por aplicativos 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 Shopify do desconto
discount.title	Texto	O título do desconto
discount.status	Texto	O status do desconto (ATIVO, VENCIDO, PROGRAMADO)
discount.createdAt	Texto	Quando o desconto foi criado
discount.updatedAt	Texto	Quando o desconto foi atualizado pela última vez
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 do aplicativo para verificar exatamente o que foi enviado.

Exemplo: Anunciar cada novo desconto no Slack

1. Selecione “Desconto” como gatilho.
2. Adicione a opção “Enviar solicitação 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

Alerta gerado quando um desconto é editado: título, valor, datas, elegibilidade, status.

Incêndios causados por	Shopify webhook
Permissão	Acesso a dados com desconto
Ligado	Ativar um fluxo de trabalho do Flow que o utilize significa ativá-lo. Seu próprio botão de ativação está na página “Gatilhos” do aplicativo

Utilize-o para

• Analise as alterações nas promoções em andamento.
• Sincronize novamente os dados da promoção com um banner na 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 status do desconto (ATIVO, VENCIDO, PROGRAMADO)
discount.createdAt	Texto	Quando o desconto foi criado
discount.updatedAt	Texto	Quando o desconto foi atualizado pela última vez
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 do aplicativo para verificar exatamente o que foi enviado.

Exemplo: Revisar as alterações feitas nos descontos ativos

1. “Desconto na seleção” atualizado como gatilho.
2. Adicione uma condição: discount.status seja 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 cancelado

É acionado quando um desconto é excluído. Restam apenas o ID e a hora para serem registrados.

Incêndios causados por	Shopify webhook
Permissão	Acesso a dados com desconto
Ligado	Ativar um fluxo de trabalho do Flow que o utilize faz com que ele seja ativado. O botão de ativação específico desse fluxo de trabalho está na página “Gatilhos” do aplicativo

Utilize-o para

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

O que o “Desconto Excluído” 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 excluído
eventId	Texto	O ID deste evento. Procure-o no Histórico de Eventos do aplicativo para verificar exatamente o que foi enviado.

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

1. Selecione “Descontos excluídos” como gatilho.
2. Adicione a opção “Enviar solicitação HTTP” ao sistema que espelha suas promoções, utilizando {{discountId}} e {{deletedAt}}.
3. Ative o fluxo de trabalho.

O desconto expirou

É acionado quando um desconto ultrapassa sua data de validade. O Shopify não envia nada nesse momento; portanto, o aplicativo verifica em intervalos programados e é acionado uma vez por cada desconto vencido.

Incêndios causados por	Verificado periodicamente, pois o Shopify não envia nenhum webhook para isso
Permissão	Acesso aos dados de descontos
Ligado	Ativar um fluxo de trabalho do Flow que o utilize faz com que ele seja ativado. Seu próprio botão de ativação está na página “Gatilhos” do aplicativo

Utilize-o para

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

O que o “Desconto expirado” envia para o seu fluxo de trabalho

Variável em Shopify Flow	Tipo	O que contém
discount	Objeto	O desconto vencido
discount.id	ID	O GID do desconto no site Shopify
discount.title	Texto	O título do desconto
discount.status	Texto	O status 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 do aplicativo para verificar exatamente o que foi enviado.

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

1. Selecione “Desconto expirado” como gatilho.
2. Adicione uma atualização no metacampo da loja (ou envie uma solicitação pela API de administração) que limpe o metacampo do qual seu tema obtém 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

É acionado quando um código de resgate é adicionado a um código de desconto, incluindo códigos gerados em massa.

Incêndios causados por	Shopify webhook
Permissão	Acesso a dados com desconto
Ligado	Ativar um fluxo de trabalho do Flow que o utilize faz com que ele seja ativado. Seu próprio botão de ativação está na página “Gatilhos” do aplicativo

Utilize-o para

• Registre novos códigos por meio de uma ferramenta para afiliados ou influenciadores.
• Verifique quem adiciona códigos a uma campanha em andamento.

O que o “Código de Desconto Adicionado” 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 do desconto no site Shopify
discount.updatedAt	Texto	Quando o desconto foi atualizado pela última vez
redeemCode	Objeto	O código de resgate que foi adicionado
redeemCode.id	ID	O GID do código de resgate no 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 do aplicativo para verificar exatamente o que foi enviado.

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

1. Selecione “Código de desconto adicionado” como gatilho.
2. Adicione a opção “Enviar solicitação 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. Ele contém o código, a frequência com que foi utilizado e se fez parte de uma remoção em massa.

Incêndios causados por	Shopify webhook
Permissão	Acesso a dados com desconto
Ligado	Ativar um fluxo de trabalho do Flow que o utilize faz com que ele seja ativado. Seu próprio botão de ativação está na página “Gatilhos” do aplicativo

Utilize-o para

• Fique atento à remoção de um código que ainda esteja em circulação.
• Evite que os sistemas parceiros divulguem códigos inválidos.

O que o “Discount Code Removed” envia para o seu fluxo de trabalho

Variável em Shopify Flow	Tipo	O que contém
discount	Objeto	O desconto do qual o código foi removido
discount.id	ID	O GID do desconto em Shopify
discount.updatedAt	Texto	Quando o desconto foi atualizado pela última vez
discount.totalUsageCount	Número	Número total de vezes em que o desconto 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 no Shopify
redeemCode.code	Texto	A sequência do código de resgate
redeemCode.usageCount	Número	Quantas vezes esse código foi utilizado antes de ser removido. O valor é nulo quando ele fez parte de uma remoção em massa (o uso por código não pode ser dividido) ou quando não foi possível determinar.
redeemCode.bulkRemoval	Verdadeiro / falso	Válido quando o código foi removido como parte de uma exclusão em massa, caso em que não há dados disponíveis sobre o uso por código.
eventId	Texto	O ID deste evento. Procure-o no Histórico de Eventos do aplicativo para verificar exatamente o que foi enviado.

Exemplo: Avisar quando um código em uso 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 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 gatilhos - todos os gatilhos em uma única página.
• Escolhendo o gatilho certo - qual deles se aplica ao seu caso.
• Gatilhos personalizados - quando nenhum gatilho integrado for adequado, crie o seu próprio.
• Histórico de eventos e solução de problemas - verificar o que foi disparado e o que estava carregado.