Gatilhos de cobrança, passo a passo

Quatro gatilhos para coleções: um para qualquer atualização e três para os campos relevantes para SEO e navegação. As coleções não possuem tags no Shopify, e é por isso que não há gatilhos de tag aqui.

Nesta página: Atualização da coleção, Alteração do título da coleção, Alteração do identificador da coleção, Alteração da descrição da coleção

Onde encontrá-los: em Shopify Flow, selecione “Select a trigger”, abra Workflow Trigger Extensions e pesquise por “Collection”.

Atualização do acervo

É acionado a cada salvamento de uma coleção, incluindo uma alteração nas condições de uma coleção automatizada.


Incêndios causados por	Shopify webhook
Permissão	Acesso aos dados de produtos, variantes e coleções
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 dele fica na página “Gatilhos” do aplicativo

Use-o para

Invalidar um cache ou reconstruir um menu de navegação quando uma coleção for alterada.
Analise as alterações nas regras de cobranças automáticas.

O que a atualização da coleção envia para o seu fluxo de trabalho

Variável no fluxo	Tipo	O que contém
`collection`	Objeto	A coleção que foi atualizada
`collection.id`	ID
`collection.title`	Texto
`collection.handle`	Texto
`collection.description`	Texto
`collection.descriptionHtml`	Texto
`collection.updatedAt`	Texto
`collection.ruleSet`	Objeto
`collection.ruleSet.appliedDisjunctively`	Verdadeiro / falso
`collection.ruleSet.rules`	Lista de objetos
`payload`	Texto	Objeto JSON contendo o GID da coleção que foi atualizada (por exemplo, {"id":"gid://shopify/Collection/123"})
`eventId`	Texto	O ID deste evento. Procure-o no Histórico de Eventos do aplicativo para ver exatamente o que foi enviado.

Exemplo: Receber uma notificação quando as regras de uma coleção forem alteradas

Selecione “Atualização da coleção” como gatilho.
Adicione “Enviar e-mail interno com {{collection.title}}” e, para cobranças automatizadas, um loop sobre collection.ruleSet.rules que imprima column, relation e condition.
Ative o fluxo de trabalho.

Título da coleção alterado

É acionado quando o título de uma coleção é alterado.


Incêndios causados por	Shopify webhook e detecção de alterações
Permissão	Acesso aos dados de produtos, variantes e coleções
Ligado	Ativar um fluxo de trabalho do Flow que o utilize faz com que ele seja ativado. O botão de ativação dele fica na página “Gatilhos” do aplicativo

Use-o para

Mantenha os nomes dos menus, das páginas de destino ou dos grupos de anúncios alinhados com o nome da coleção.

O que a ação “Título da coleção alterado” envia para o seu fluxo de trabalho

Variável no fluxo	Tipo	O que contém
`collection`	Objeto	A coleção cujo título mudou
`collection.id`	ID
`collection.title`	Texto
`collection.handle`	Texto
`collection.description`	Texto
`collection.descriptionHtml`	Texto
`collection.updatedAt`	Texto
`collection.ruleSet`	Objeto
`collection.ruleSet.appliedDisjunctively`	Verdadeiro / falso
`collection.ruleSet.rules`	Lista de objetos
`oldTitle`	Texto	O título anterior da coleção
`newTitle`	Texto	O novo título da coleção
`eventId`	Texto	O ID deste evento. Procure-o no Histórico de Eventos do aplicativo para ver exatamente o que foi enviado.

Exemplo: Informar a equipe de marketing sobre uma coleção que teve o nome alterado

“Título da coleção selecionada alterado” foi definido como o gatilho.
Adicionar “Enviar e-mail interno”: "{{oldTitle}}" is now "{{newTitle}}".
Ative o fluxo de trabalho.

Alteração do identificador da coleção

É acionado quando o identificador de URL de uma coleção é alterado.


Incêndios causados por	Shopify webhook e detecção de alterações
Permissão	Acesso aos dados de produtos, variantes e coleções
Ligado	Ativar um fluxo de trabalho do Flow que o utilize faz com que ele seja ativado. O botão de ativação dele fica na página “Gatilhos” do aplicativo

Use-o para

Crie automaticamente o redirecionamento a partir da URL antiga da coleção.

O que o evento “Alteração no identificador da coleção” envia para o seu fluxo de trabalho

Variável no fluxo	Tipo	O que contém
`collection`	Objeto	A coleção cujo nome mudou
`collection.id`	ID
`collection.title`	Texto
`collection.handle`	Texto
`collection.description`	Texto
`collection.descriptionHtml`	Texto
`collection.updatedAt`	Texto
`collection.ruleSet`	Objeto
`collection.ruleSet.appliedDisjunctively`	Verdadeiro / falso
`collection.ruleSet.rules`	Lista de objetos
`oldHandle`	Texto	O identificador de URL anterior da coleção
`newHandle`	Texto	O novo identificador de URL da coleção
`eventId`	Texto	O ID deste evento. Procure-o no Histórico de Eventos do aplicativo para ver exatamente o que foi enviado.

Exemplo: Redirecionar a URL antiga da coleção

A alça de coleta “Pick” foi alterada para servir como gatilho.
Adicione um redirecionamento de URL com o caminho /collections/{{oldHandle}} e o destino /collections/{{newHandle}}.
Ative o fluxo de trabalho.

Descrição da coleção alterada

É acionado quando a descrição de uma coleção é alterada.


Incêndios causados por	Shopify webhook e detecção de alterações
Permissão	Acesso aos dados de produtos, variantes e coleções
Ligado	Ativar um fluxo de trabalho do Flow que o utilize faz com que ele seja ativado. O botão de ativação dele fica na página “Gatilhos” do aplicativo

Use-o para

Inicie uma tradução ou uma verificação de SEO para os textos das categorias.

O que a opção “Descrição da coleção alterada” envia para o seu fluxo de trabalho

Variável no fluxo	Tipo	O que contém
`collection`	Objeto	A coleção cuja descrição foi alterada
`collection.id`	ID
`collection.title`	Texto
`collection.handle`	Texto
`collection.description`	Texto
`collection.descriptionHtml`	Texto
`collection.updatedAt`	Texto
`collection.ruleSet`	Objeto
`collection.ruleSet.appliedDisjunctively`	Verdadeiro / falso
`collection.ruleSet.rules`	Lista de objetos
`oldDescription`	Texto	A descrição anterior (truncada para 4.000 caracteres; consulte a descrição completa por meio da referência da coleção, se necessário)
`newDescription`	Texto	A nova descrição (truncada para 4.000 caracteres; consulte a descrição completa por meio da referência da coleção, se necessário)
`eventId`	Texto	O ID deste evento. Procure-o no Histórico de Eventos do aplicativo para ver exatamente o que foi enviado.

Exemplo: Colocar na fila uma descrição alterada para tradução

A descrição da coleção “Pick” foi alterada como gatilho.
Adicione a função “Enviar solicitação HTTP” à sua ferramenta de tradução usando {{collection.id}} e {{newDescription}}.
Ative o fluxo de trabalho.

Próximos passos

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 embutido for adequado, crie o seu próprio.
Histórico de eventos e solução de problemas - ver o que disparou e o que carregava.
Acionar eventos na página de administração de um registro - os eventos mais recentes de um registro, em sua própria página no painel de administração do Shopify.