Gatilhos de clientes, passo a passo

Onze gatilhos para alterações num registo de cliente. Sete deles incidem sobre dados que qualquer loja pode utilizar livremente (tags, notas, estado da conta, consentimento de marketing). Quatro deles envolvem a leitura de dados pessoais - nome, e-mail, telefone, morada - e requerem uma aceitação expressa, para além da autorização.

Nesta página: Atualização do cliente, Adicionadas etiquetas ao cliente, Etiquetas removidas do cliente, Nota do cliente alterada, Estado 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, Morada do cliente alterada

Atualização para os clientes

É acionado sempre que um registo de cliente é guardado. Contém um objeto changes: os campos monitorizados que sofreram alterações (tags, nota, estado da conta), juntamente com os valores anteriores e posteriores.

Incêndios provocados por	Shopify webhook e deteçã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 este seja ativado. O respetivo botão de ativação encontra-se na página «Gatilhos» da aplicação

Utilize-o para

• Um fluxo de trabalho para vários tipos de alterações relativas aos clientes, com ramificações no changes.fields.
• Sincronize todas as alterações relativas 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, pelo que todos os seus campos e as ações próprias do cliente no Shopify Flow estão disponíveis.
payload	Texto	Objeto JSON que contém o GID do cliente que foi atualizado (por exemplo, {"id":"gid://shopify/Cliente/123"})
changes	Objeto	Quais campos monitorizados sofreram alterações (tags, nota, estado da conta), com o valor antigo e o novo de cada um
changes.fields	Lista de textos	Nomes dos campos monitorizados 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 encurtados
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 da aplicação para ver exatamente o que foi enviado.

Exemplo: Enviar as alterações registadas relativas aos clientes para um CRM

1. Selecione «Atualização do Cliente» como gatilho.
2. Adicionar uma condição: changes.fields não está vazio e existe.
3. Adicione a função «Enviar pedido HTTP» ao seu CRM com {{customer.id}} e um ciclo sobre changes.items (field, oldValue, newValue).
4. Ative o fluxo de trabalho.

Foram adicionadas tags de cliente

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

Incêndios provenientes de	Shopify webhook e deteçã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 este seja ativado. O respetivo botão de ativação encontra-se na página «Gatilhos» da aplicação

Utilize-o para

• Inicie o processo de integração quando um colaborador ou outra aplicação identificar um cliente com a tag wholesale ou vip.
• Reaja às tags criadas por aplicações de fidelização, subscrição ou avaliação.

O que a função «Etiquetas de cliente adicionadas» 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 Shopify completo, pelo que todos os seus campos e as ações próprias do Shopify Flow relativas a clientes estão disponíveis.
addedTags	Texto	Lista de tags, separadas por vírgulas, que foram adicionadas ao cliente
removedTags	Texto	Lista de tags, separadas por vírgulas, 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 associadas ao cliente antes desta atualização
eventId	Texto	O ID deste evento. Procure-o no Histórico de Eventos da aplicação para ver exatamente o que foi enviado.

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

1. Selecione «Tags do cliente adicionadas» como gatilho.
2. Adicionar uma condição: addedTags inclui wholesale.
3. Adicione a opção «Enviar e-mail interno ao gestor de conta com {{customer.displayName}}» ou «Enviar pedido HTTP à sua ferramenta de e-mail» para iniciar a série de boas-vindas.
4. 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 provocados por	Shopify Webhook e deteçã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 este seja ativado. O respetivo botão de ativação encontra-se na página «Gatilhos» da aplicação

Utilize-o para

• Revogar um benefício quando uma tag de sócio desaparecer.
• Notifique a equipa quando uma aplicação por subscrição remover a sua etiqueta active-subscriber.

O que a funcionalidade «Etiquetas de 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 Shopify completo, pelo que todos os seus campos e as ações próprias do Shopify Flow relativas ao cliente estão disponíveis.
addedTags	Texto	Lista separada por vírgulas de 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 da aplicação para ver exatamente o que foi enviado.

Exemplo: Acompanhamento quando uma tag de subscritor é removida

1. Selecione «Tags do cliente removidas» como gatilho.
2. Adicionar uma condição: removedTags inclui active-subscriber.
3. Adicione tags de cliente com winback e envie um e-mail interno para a equipa de retenção.
4. Ative o fluxo de trabalho.

Nota do cliente alterada

É acionado quando uma nota relativa a um cliente é adicionada, alterada ou eliminada.

Incêndios provocados por	Shopify Webhook e deteçã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 este seja ativado. O respetivo botão de ativação encontra-se na página «Gatilhos» da aplicação

Utilize-o para

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

O que a função «Alterações na nota do cliente» 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 Shopify completo, pelo que todos os seus campos e as ações de cliente próprias do Shopify Flow estão disponíveis.
oldNote	Texto	A nota anterior relativa ao cliente (vazia caso a nota não tenha sido definida anteriormente)
newNote	Texto	A nova nota relativa ao cliente (vazia se a nota tiver sido apagada)
eventId	Texto	O ID deste evento. Procure-o no Histórico de Eventos da aplicação para ver exatamente o que foi enviado.

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

1. Selecione «Nota do cliente alterada» como gatilho.
2. Adicionar uma condição: newNote inclui #callback.
3. Adicione a opção «Enviar e-mail interno» ou «Enviar um pedido» à sua ferramenta de tarefas através de {{customer.displayName}} e {{newNote}}.
4. Ative o fluxo de trabalho.

Alteração do estado do cliente

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

Incêndios provocados por	Shopify Webhook e deteção de alterações
Autorização	Acesso aos dados dos clientes
Ligado	Ativar um fluxo de trabalho do Flow que o utilize ativa-o. O seu próprio botão de ativação encontra-se na página «Gatilhos» da aplicação

Utilize-o para

• Cumprimente os clientes quando estes ativarem a sua conta.
• 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 estado da conta sofreu alteração. Trata-se de um cliente Shopify completo, pelo que todos os seus campos e as ações próprias do Shopify Flow relativas ao cliente estão disponíveis.
oldState	Texto	O estado anterior da conta (desativada, ativada, convidada ou recusada)
newState	Texto	O novo estado da conta (desativada, ativada, convidada ou recusada)
eventId	Texto	O ID deste evento. Procure-o no Histórico de Eventos da aplicação para ver exatamente o que foi enviado.

Exemplo: Marcar os clientes que ativaram a sua conta

1. Selecione «Alteração do estado do cliente» como gatilho.
2. Adicione uma condição: newState é igual a enabled.
3. Adicione tags de cliente com o account-active.
4. Ative o fluxo de trabalho.

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

É acionado quando o consentimento de um cliente para o marketing por e-mail sofre alterações. consentState é o novo estado: subscribed, not_subscribed, pending, unsubscribed ou redacted.

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

• Mantenha uma ferramenta de e-mail externa sincronizada com o Shopify, em ambos os sentidos.
• Registe os cancelamentos de subscrição para efeitos de conformidade.

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

Variável em Shopify Flow	Tipo	O que contém
customer	Cliente (Shopify)	O cliente cujo consentimento para o marketing por e-mail sofreu alterações. Trata-se de um cliente com acesso completo ao Shopify, pelo que todos os seus campos e as ações do cliente próprias do Shopify Flow estão disponíveis.
consentState	Texto	O novo estado de consentimento para o marketing por e-mail: inscrito, não inscrito, pendente, cancelado ou ocultado
optInLevel	Texto	O nível de subscrição: single_opt_in, confirmed_opt_in ou desconhecido (pode estar em branco)
consentUpdatedAt	Texto	Carimbo de data/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 da aplicação para ver exatamente o que foi enviado.

Exemplo: Remover clientes que cancelaram a subscrição de uma lista externa

1. Selecione «Alteração do consentimento do cliente para o marketing por e-mail» como gatilho.
2. Adicione uma condição: consentState é igual a unsubscribed.
3. Adicione a opção «Enviar pedido HTTP» para o ponto final de cancelamento de subscrição da sua ferramenta de e-mail com {{customer.id}}.
4. Ative o fluxo de trabalho.

Alteração do 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 provocados por	Shopify webhook
Autorização	Acesso aos dados dos clientes
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

• Transmitir o consentimento por SMS a um prestador de serviços de SMS.
• Interrompa o envio de SMS imediatamente após uma recusa.

O que a alteração relativa ao consentimento do cliente para o marketing por SMS transmite ao 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 sofreu alterações. Trata-se de um cliente Shopify completo, pelo que todos os seus campos e as ações do cliente próprias do Shopify Flow estão disponíveis.
consentState	Texto	O novo estado de consentimento para o marketing por SMS: inscrito, não inscrito, pendente, cancelado ou ocultado
optInLevel	Texto	O nível de subscrição: single_opt_in, confirmed_opt_in ou desconhecido (pode estar em branco)
consentUpdatedAt	Texto	Carimbo de data/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 da aplicação para ver exatamente o que foi enviado.

Exemplo: Identificar assinantes de SMS

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

Alteração do nome do cliente

É acionado quando o nome próprio ou o apelido de um cliente é alterado. Indica o nome atual.

Incêndios provocados por	Shopify webhook e deteçã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 este seja ativado. O respetivo botão de ativação encontra-se na página «Gatilhos» da aplicação

Utilize-o para

• Mantenha os nomes atualizados num CRM, num ERP ou numa ferramenta de fidelização.

O que a função «Alteração do nome 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 nome foi alterado. Trata-se de um cliente Shopify completo, pelo que todos os seus campos e as ações de cliente próprias do Shopify Flow estão disponíveis.
firstName	Texto	O nome próprio atual do cliente
lastName	Texto	O apelido atual do cliente
eventId	Texto	O ID deste evento. Procure-o no Histórico de Eventos da aplicação para ver exatamente o que foi enviado.

Exemplo: Enviar uma alteração de nome para o ERP

1. Selecione «Nome do cliente alterado» como gatilho no Shopify Flow.
2. Adicione «Enviar pedido HTTP» com {{customer.id}}, {{firstName}} e {{lastName}}.
3. Ative o fluxo de trabalho.

O endereço de e-mail do cliente foi alterado

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

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

• 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 «E-mail 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 endereço de e-mail foi alterado. Trata-se de um cliente com a versão completa do Shopify, pelo que todos os seus campos e as ações de cliente próprias do Shopify Flow estão disponíveis.
email	Texto	O endereço de e-mail predefinido atual do cliente
eventId	Texto	O ID deste evento. Procure-o no Histórico de Eventos da aplicação para ver exatamente o que foi enviado.

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

1. Selecione «O e-mail do cliente foi alterado no Shopify Flow».
2. Adicione a opção «Enviar e-mail interno para o suporte» com o endereço {{customer.displayName}} e o link de administrador. Pense duas vezes antes de colocar {{email}} num canal que muitas pessoas leem.
3. Ative o fluxo de trabalho.

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

É acionado quando o número de telefone de um cliente muda. Transmite o número atual.

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

• Mantenha atualizada uma ferramenta de SMS ou de telefonia.

O que a função «Alteração do Número de Telemóvel 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 Shopify completo, pelo que 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 predefinido atual do cliente
eventId	Texto	O ID deste evento. Procure-o no Histórico de Eventos da aplicação para ver exatamente o que foi enviado.

Exemplo: Sincronizar um novo número de telefone com o prestador de serviços de SMS

1. Selecionar o número de telefone do cliente alterado no Shopify Flow.
2. Adicione «Enviar pedido HTTP» ao fornecedor com {{customer.id}} e {{phone}}.
3. Ative o fluxo de trabalho.

Alteração da morada do cliente

É acionado quando a morada predefinida de um cliente é alterada. address corresponde a uma linha formatada, enquanto addressDetails apresenta a mesma morada em campos separados.

Incêndios provocados por	Shopify Webhook e deteçã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 este seja ativado. O seu próprio botão de ativação encontra-se na página «Gatilhos» da aplicação

Utilize-o para

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

O que a função «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 predefinido foi alterado. Trata-se de um cliente Shopify completo, pelo que todos os seus campos e as ações próprias do Shopify Flow relativas ao cliente estão disponíveis.
address	Texto	A morada predefinida atual do cliente, apresentada numa única linha formatada (pode estar em branco)
addressDetails	Objeto	O endereço predefinido atual do cliente sob a forma de campos estruturados (pode estar vazio)
addressDetails.firstName	Texto	Nome próprio que consta na morada
addressDetails.lastName	Texto	Apelido que consta na morada
addressDetails.name	Texto	Nome completo, derivado de «firstName» e «lastName»
addressDetails.company	Texto	Nome da empresa ou organização
addressDetails.address1	Texto	Primeira linha - morada ou número da caixa postal
addressDetails.address2	Texto	Segunda linha - apartamento, suite ou unidade
addressDetails.city	Texto	Cidade, distrito, aldeia ou vila
addressDetails.province	Texto	Região - província, estado ou distrito
addressDetails.provinceCode	Texto	Código da região (por exemplo, ON)
addressDetails.zip	Texto	Código postal
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 indicado no endereço
eventId	Texto	O ID deste evento. Procure-o no Histórico de Eventos da aplicação para ver exatamente o que foi enviado.

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

1. Selecione «Endereço do cliente alterado» em Shopify Flow.
2. Adicionar uma condição: addressDetails.countryCode não é igual a DE (o seu mercado nacional).
3. Adicione tags de cliente com o international.
4. Ative o fluxo de trabalho.

Próximos passos

• 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.
• Acionar gatilhos na página de administração de um registo - os eventos mais recentes de um registo, na sua própria página no painel de administração do Shopify.