Gatilhos de clientes, passo a passo

Copiar página

Tutoriais passo a passo no Shopify Flow para gatilhos de tags, notas, status da conta e consentimento de marketing de clientes.

Onze gatilhos para alterações em um registro de cliente. Sete deles atuam sobre dados que qualquer loja pode utilizar livremente (tags, notas, status da conta, consentimento de marketing). Quatro acessam dados pessoais - nome, e-mail, telefone, endereço - e exigem consentimento expresso além da permissão geral.

Nesta página: Atualização do cliente, Adicionadas tags do cliente, Tags do cliente removidas, Nota do cliente alterada, Status do cliente alterado, Consentimento do cliente para marketing por e-mail alterado, Consentimento do cliente para marketing por SMS alterado, Nome do cliente alterado, E-mail do cliente alterado, Número de telefone do cliente alterado, Endereço do cliente alterado

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

Atualização para o cliente

É disparado a cada salvamento de um registro de cliente. Ele contém um objeto changes: os campos rastreados que foram alterados (tags, nota, estado da conta), juntamente com os valores anteriores e posteriores.


Incêndios causados por	Shopify webhook e detecção de alterações
Permissão	Acesso aos dados dos clientes
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

Um fluxo de trabalho para diversos tipos de edições de clientes, com ramificações no changes.fields.
Sincronize todas as alterações relacionadas aos clientes com um CRM.

O que a “Atualização do Cliente” envia para o seu fluxo de trabalho

Variável em Shopify Flow	Tipo	O que contém
`customer`	Cliente (Shopify)	O cliente. Trata-se de um cliente Shopify completo, portanto, todos os seus campos e as ações próprias do Shopify Flow relacionadas ao cliente estão disponíveis.
`payload`	Texto	Objeto JSON contendo o GID do cliente que foi atualizado (por exemplo, {"id":"gid://shopify/Customer/123"})
`changes`	Objeto	Quais campos monitorados foram alterados (tags, nota, status da conta), com o valor antigo e o novo de cada um
`changes.fields`	Lista de textos	Nomes dos campos monitorados que sofreram alterações
`changes.items`	Lista de objetos	Valor antigo e novo por campo alterado
`changes.items (each).field`	Texto	O campo que foi alterado: tags, nota ou estado
`changes.items (each).oldValue`	Texto	O valor antes da atualização. Os valores longos são abreviados
`changes.items (each).newValue`	Texto	O valor após a atualização. Os valores longos são abreviados
`eventId`	Texto	O ID deste evento. Procure-o no Histórico de Eventos do aplicativo para verificar exatamente o que foi enviado.

Exemplo: Encaminhar as alterações registradas dos clientes para um CRM

Selecione “Atualização do cliente” como gatilho.
Adicionar uma condição: changes.fields não estiver vazio e existir.
Adicione a função “Enviar solicitação HTTP” ao seu CRM com {{customer.id}} e um loop sobre changes.items (field, oldValue, newValue).
Ative o fluxo de trabalho.

Tags de cliente adicionadas

É acionado quando pelo menos uma tag é adicionada a um cliente. A tabela addedTags contém apenas as novas tags.


Incêndios causados por	Shopify webhook e detecção de alterações
Permissão	Acesso aos dados dos clientes
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

Inicie o processo de integração quando um funcionário ou outro aplicativo marcar um cliente com a tag wholesale ou vip.
Reaja às tags criadas por aplicativos de fidelidade, assinatura ou avaliações.

O que a função “Tags adicionadas pelo cliente” envia para o seu fluxo de trabalho

Variável em Shopify Flow	Tipo	O que contém
`customer`	Cliente (Shopify)	O cliente cujas tags foram alteradas. Trata-se de um cliente do Shopify completo, portanto, todos os seus campos e as ações de cliente próprias do Shopify Flow estão disponíveis.
`addedTags`	Texto	Lista separada por vírgulas das tags que foram adicionadas ao cliente
`removedTags`	Texto	Lista separada por vírgulas das tags que foram removidas do cliente na mesma atualização (pode estar vazia)
`currentTags`	Texto	Lista separada por vírgulas de todas as tags atuais associadas aos clientes
`previousTags`	Texto	Lista separada por vírgulas de todas as tags anteriores atribuídas ao cliente antes desta atualização
`eventId`	Texto	O ID deste evento. Procure-o no Histórico de Eventos do aplicativo para verificar exatamente o que foi enviado.

Exemplo: Dar as boas-vindas a um novo cliente atacadista

Selecione “Tags do cliente adicionadas” como gatilho.
Adicionar uma condição: addedTags inclui wholesale.
Adicione a opção “Enviar e-mail interno ao gerente de contas com {{customer.displayName}}” ou “Enviar solicitação HTTP à sua ferramenta de e-mail” para iniciar a série de boas-vindas.
Ative o fluxo de trabalho.

Tags do cliente removidas

É acionado quando pelo menos uma tag é removida de um cliente. A variável removedTags armazena as tags que foram removidas.


Incêndios causados por	Shopify webhook e detecção de alterações
Permissão	Acesso aos dados dos clientes
Ligado	Ativar um fluxo de trabalho do Shopify 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

Revogar um benefício quando uma tag de associado desaparecer.
Notifique a equipe quando um aplicativo por assinatura remover sua tag active-subscriber.

O que a função “Tags do cliente removidas” envia para o seu fluxo de trabalho

Variável em Shopify Flow	Tipo	O que contém
`customer`	Cliente (Shopify)	O cliente cujas tags foram alteradas. Trata-se de um cliente com o plano Shopify completo, portanto, todos os seus campos e as ações específicas do cliente no Shopify Flow estão disponíveis.
`addedTags`	Texto	Lista separada por vírgulas das tags que foram adicionadas ao cliente na mesma atualização (pode estar vazia)
`removedTags`	Texto	Lista separada por vírgulas das tags que foram removidas do cliente
`currentTags`	Texto	Lista separada por vírgulas de todas as tags atuais associadas ao cliente
`previousTags`	Texto	Lista separada por vírgulas de todas as tags anteriores atribuídas ao cliente antes desta atualização
`eventId`	Texto	O ID deste evento. Procure-o no Histórico de Eventos do aplicativo para verificar exatamente o que foi enviado.

Exemplo: Acompanhamento quando uma tag de assinante é removida

Selecione “Tags do cliente removidas” como gatilho.
Adicionar uma condição: removedTags inclui active-subscriber.
Adicione tags de cliente com winback e envie um e-mail interno para a equipe de retenção.
Ative o fluxo de trabalho.

Nota do cliente alterada

É acionado quando uma observação sobre um cliente é adicionada, alterada ou excluída.


Incêndios causados por	Shopify Webhook e detecção de alterações
Permissão	Acesso aos dados dos clientes
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

Notas de rota redigidas pela equipe de suporte e destinadas ao titular da conta.
Analise uma palavra-chave da nota (#callback) e inicie uma tarefa.

O que a ação “Nota do cliente alterada” envia para o seu fluxo de trabalho

Variável em Shopify Flow	Tipo	O que contém
`customer`	Cliente (Shopify)	O cliente cuja nota foi alterada. Trata-se de um cliente com acesso completo ao Shopify, portanto, todos os seus campos e as ações próprias do Shopify Flow para clientes estão disponíveis.
`oldNote`	Texto	A nota anterior sobre o cliente (vazia caso a nota não tenha sido definida anteriormente)
`newNote`	Texto	A nova anotação sobre o cliente (vazia caso a anotação tenha sido apagada)
`eventId`	Texto	O ID deste evento. Procure-o no Histórico de Eventos do aplicativo para ver exatamente o que foi enviado.

Exemplo: Criar uma tarefa de retorno de chamada a partir de uma nota

Selecione “Nota do cliente alterada” como gatilho.
Adicionar uma condição: newNote inclui #callback.
Adicione a opção “Enviar e-mail interno” ou uma solicitação à sua ferramenta de tarefas com {{customer.displayName}} e {{newNote}}.
Ative o fluxo de trabalho.

Alteração no status do cliente

É acionado quando o status da conta de um cliente muda entre disabled, enabled, invited e declined.


Incêndios causados por	Shopify webhook e detecção de alterações
Permissão	Acesso aos dados dos clientes
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

Cumprimente os clientes quando eles ativarem suas contas.
Veja quem recusou um convite para criar uma conta.

O que o evento “Alteração do estado do cliente” envia para o seu fluxo de trabalho

Variável em Shopify Flow	Tipo	O que contém
`customer`	Cliente (Shopify)	O cliente cujo status da conta foi alterado. Trata-se de um cliente Shopify completo, portanto, todos os seus campos e as ações próprias do Shopify Flow relacionadas ao cliente estão disponíveis.
`oldState`	Texto	O status anterior da conta (desativada, ativada, convidada ou recusada)
`newState`	Texto	O novo status da conta (desativada, ativada, convidada ou recusada)
`eventId`	Texto	O ID deste evento. Procure-o no Histórico de Eventos do aplicativo para verificar exatamente o que foi enviado.

Exemplo: Marcar os clientes que ativaram suas contas

Selecione “Alteração do status do cliente” como gatilho.
Adicionar uma condição: newState seja igual a enabled.
Adicione tags de cliente com o account-active.
Ative o fluxo de trabalho.

Alteração no consentimento do cliente para o marketing por e-mail

Quando o consentimento de um cliente para receber e-mails de marketing é alterado, é acionado. consentState é o novo estado: subscribed, not_subscribed, pending, unsubscribed ou redacted.


Incêndios causados por	Shopify webhook
Permissão	Acesso aos dados dos clientes
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

Mantenha uma ferramenta externa de e-mail sincronizada com o Shopify, em ambas as direções.
Registre os cancelamentos de assinatura para fins de conformidade.

O que a alteração no consentimento para o marketing por e-mail do cliente traz para o seu fluxo de trabalho

Variável em Shopify Flow	Tipo	O que contém
`customer`	Cliente (Shopify)	O cliente cujo consentimento para marketing por e-mail foi alterado. Trata-se de um cliente Shopify completo, portanto, todos os seus campos e as ações do cliente no próprio Shopify Flow estão disponíveis.
`consentState`	Texto	O novo status de consentimento para marketing por e-mail: inscrito, não inscrito, pendente, cancelado ou oculto
`optInLevel`	Texto	O nível de consentimento: single_opt_in, confirmed_opt_in ou desconhecido (pode estar vazio)
`consentUpdatedAt`	Texto	Carimbo de data e hora ISO-8601 correspondente à última atualização deste consentimento pelo cliente (pode estar em branco)
`eventId`	Texto	O ID deste evento. Procure-o no Histórico de Eventos do aplicativo para verificar exatamente o que foi enviado.

Exemplo: Remover clientes que cancelaram a assinatura de uma lista externa

Selecione “Consentimento do cliente para marketing por e-mail alterado” como gatilho.
Adicione uma condição: consentState seja igual a unsubscribed.
Adicione a opção “Enviar solicitação HTTP” ao endpoint de cancelamento de inscrição da sua ferramenta de e-mail usando {{customer.id}}.
Ative o fluxo de trabalho.

Alteração no consentimento do cliente para o marketing por SMS

É acionado quando o consentimento de um cliente para receber mensagens de marketing por SMS é alterado.


Incêndios causados por	Shopify webhook
Permissão	Acesso aos dados dos clientes
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

Reproduzir o consentimento por SMS em um provedor de SMS.
Interrompa o envio de SMS imediatamente após uma solicitação de cancelamento.

O que a alteração no consentimento do cliente para marketing por SMS envia para o seu fluxo de trabalho

Variável em Shopify Flow	Tipo	O que contém
`customer`	Cliente (Shopify)	O cliente cujo consentimento para marketing por SMS foi alterado. Trata-se de um cliente completo do Shopify; portanto, todos os seus campos e as ações do cliente no próprio Shopify Flow estão disponíveis.
`consentState`	Texto	O novo status de consentimento para marketing por SMS: inscrito, não inscrito, pendente, cancelado ou ocultado
`optInLevel`	Texto	O nível de consentimento: single_opt_in, confirmed_opt_in ou desconhecido (pode estar em branco)
`consentUpdatedAt`	Texto	Carimbo de data e hora ISO-8601 correspondente à última atualização deste consentimento pelo cliente (pode estar em branco)
`eventId`	Texto	O ID deste evento. Procure-o no Histórico de Eventos do aplicativo para verificar exatamente o que foi enviado.

Exemplo: Identificar assinantes de SMS

Selecione “Alteração do consentimento do cliente para marketing por SMS” como gatilho.
Adicione uma condição: consentState é igual a subscribed. Em seguida, adicione “Adicionar tags de cliente” sms-subscriber.
Na seção “Outros”, adicione as tags de cliente sms-subscriber.
Ative o fluxo de trabalho.

Nome do cliente alterado

É acionado quando o nome ou o sobrenome de um cliente é alterado. Ele contém o nome atual.


Incêndios causados por	Shopify webhook e detecção de alterações
Permissão	Acesso aos dados dos clientes
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 atualizados em um CRM, um ERP ou uma ferramenta de fidelização.

O que o evento “Nome do cliente alterado” envia para o seu fluxo de trabalho

Variável em Shopify Flow	Tipo	O que contém
`customer`	Cliente (Shopify)	O cliente cujo nome foi alterado. Trata-se de um cliente Shopify completo, portanto, todos os seus campos e as ações de cliente próprias do Shopify Flow estão disponíveis.
`firstName`	Texto	O nome de batismo atual do cliente
`lastName`	Texto	O sobrenome atual do cliente
`eventId`	Texto	O ID deste evento. Procure-o no Histórico de Eventos do aplicativo para ver exatamente o que foi enviado.

Exemplo: Enviar um nome alterado para o ERP

Selecione “Nome do cliente alterado” como gatilho no Shopify Flow.
Adicione a opção “Enviar solicitação HTTP” com {{customer.id}}, {{firstName}} e {{lastName}}.
Ative o fluxo de trabalho.

E-mail do cliente alterado

É acionado quando o endereço de e-mail de um cliente é alterado. Ele contém o endereço atual.


Incêndios causados por	Shopify webhook e detecção de alterações
Permissão	Acesso aos dados dos clientes
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

Atualize o endereço nas ferramentas que utilizam o e-mail como critério de pesquisa.
Envie um aviso de segurança sobre a alteração.

O que a função “Alteração no e-mail do cliente” envia para o seu fluxo de trabalho

Variável em Shopify Flow	Tipo	O que contém
`customer`	Cliente (Shopify)	O cliente cujo e-mail foi alterado. Trata-se de um cliente do Shopify com acesso completo, portanto, todos os seus campos e as ações do cliente próprias do Shopify Flow estão disponíveis.
`email`	Texto	O endereço de e-mail padrão atual do cliente
`eventId`	Texto	O ID deste evento. Procure-o no Histórico de Eventos do aplicativo para verificar exatamente o que foi enviado.

Exemplo: Notificar o suporte sobre uma alteração no endereço de e-mail

Selecione “E-mail do cliente alterado” em Shopify Flow.
Adicione a opção “Enviar e-mail interno para o suporte” com {{customer.displayName}} e o link de administrador. Pense duas vezes antes de inserir {{email}} em um canal lido por muitas pessoas.
Ative o fluxo de trabalho.

Alteração do número de telefone do cliente

É acionado quando o número de telefone de um cliente é alterado. Ele mantém o número atual.


Incêndios causados por	Shopify webhook e detecção de alterações
Autorização	Acesso aos dados dos clientes
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 uma ferramenta de SMS ou telefonia atualizada.

O que o recurso “Alteração no número de telefone do cliente” envia para o seu fluxo de trabalho

Variável em Shopify Flow	Tipo	O que contém
`customer`	Cliente (Shopify)	O cliente cujo número de telefone mudou. Trata-se de um cliente do Shopify completo, portanto, todos os seus campos e as ações de cliente próprias do Shopify Flow estão disponíveis.
`phone`	Texto	O número de telefone padrão atual do cliente
`eventId`	Texto	O ID deste evento. Procure-o no Histórico de Eventos do aplicativo para verificar exatamente o que foi enviado.

Exemplo: Sincronizar um novo número de telefone com o provedor de SMS

Selecionar o número de telefone do cliente alterado no Shopify Flow.
Adicione a opção “Enviar solicitação HTTP” ao provedor com {{customer.id}} e {{phone}}.
Ative o fluxo de trabalho.

Alteração do endereço do cliente

É acionado quando o endereço padrão de um cliente é alterado. address é uma linha formatada, enquanto addressDetails apresenta o mesmo endereço em campos separados.


Incêndios causados por	Shopify Webhook e detecção de alterações
Permissão	Acesso aos dados dos clientes
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

Verifique novamente as atribuições de zonas fiscais ou de remessa quando um cliente mudar de país.
Atualizar um registro de devedor no ERP.

O que o evento “Alteração do endereço do cliente” envia para o seu fluxo de trabalho

Variável em Shopify Flow	Tipo	O que contém
`customer`	Cliente (Shopify)	O cliente cujo endereço padrão foi alterado. Trata-se de um cliente Shopify completo, portanto, todos os seus campos e as ações próprias do Shopify Flow relacionadas ao cliente estão disponíveis.
`address`	Texto	O endereço padrão atual do cliente, formatado em uma única linha (pode estar vazio)
`addressDetails`	Objeto	O endereço padrão atual do cliente na forma de campos estruturados (pode estar vazio)
`addressDetails.firstName`	Texto	Nome próprio que consta no endereço
`addressDetails.lastName`	Texto	Sobrenome que consta no endereço
`addressDetails.name`	Texto	Nome completo, derivado de “firstName” e “lastName”
`addressDetails.company`	Texto	Nome da empresa ou organização
`addressDetails.address1`	Texto	Primeira linha - endereço ou número de caixa postal
`addressDetails.address2`	Texto	Segunda linha - apartamento, suíte ou unidade
`addressDetails.city`	Texto	Cidade, distrito, vila ou município
`addressDetails.province`	Texto	Região - província, estado ou distrito
`addressDetails.provinceCode`	Texto	Código de região (por exemplo, ON)
`addressDetails.zip`	Texto	Código postal ou CEP
`addressDetails.country`	Texto	Nome do país
`addressDetails.countryCode`	Texto	Código de país de duas letras (por exemplo, US)
`addressDetails.phone`	Texto	Número de telefone no endereço
`eventId`	Texto	O ID deste evento. Procure-o no Histórico de Eventos do aplicativo para ver exatamente o que foi enviado.

Exemplo: Identificar clientes que se mudaram para outro país

Selecione “Endereço do cliente alterado em Shopify Flow”.
Adicionar uma condição: addressDetails.countryCode não é igual a DE (seu mercado local).
Adicione tags de cliente com o international.
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 - 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.