Gatilhos de cobrança, passo a passo

Copiar página

Aprenda a usar gatilhos do Shopify Flow para coleções: atualização, título, identificador e descrição, com valores antigos e novos.

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; por isso, 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”, acesse Workflow Trigger Extensions e pesquise por “Coleção”.

Atualização da coleção

É acionado a cada vez que uma coleção é salva, 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 significa ativá-lo. Seu próprio botão de ativação encontra-se na página “Gatilhos” do aplicativo

Utilize-o para

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

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

Variável em Shopify Flow	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/Coleção/123"})
`eventId`	Texto	O ID deste evento. Procure-o no Histórico de Eventos do aplicativo para verificar exatamente o que foi enviado.

Exemplo: Receba 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 a dados de produtos, variantes e coleções
Ligado	Ativar um fluxo de trabalho do Shopify 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

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 em Shopify Flow	Tipo	O que contém
`collection`	Objeto	A coleção cujo título foi alterado
`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 verificar exatamente o que foi enviado.

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

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

Alteração do identificador da coleção

É disparado 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 Shopify Flow que o utilize aciona esse recurso. O botão de ativação específico está na página “Gatilhos” do aplicativo

Utilize-o para

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

O que a função “Collection Handle Changed” envia ao seu fluxo de trabalho

Variável em Shopify Flow	Tipo	O que contém
`collection`	Objeto	A coleção cujo nome foi alterado
`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 verificar 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 específico desse fluxo de trabalho está na página “Gatilhos” do aplicativo

Utilize-o para

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

O que a notificação “Alteração na descrição da coleção” envia para o seu fluxo de trabalho

Variável em Shopify Flow	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; obtenha 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 verificar 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 opção “Enviar solicitação HTTP” à sua ferramenta de tradução por meio dos links {{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 delas 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.
Acionar gatilhos 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.