Gatilhos de finalização de checkout, passo a passo
Tutoriais passo a passo do Shopify Flow sobre erros na etapa de checkout, códigos de desconto rejeitados e pedidos de clientes novos.
Três gatilhos relacionados ao momento da compra. Dois deles provêm do navegador do comprador durante a finalização do checkout e alertam que o processo está falhando antes mesmo que seja aberto um ticket de suporte. O terceiro é um gatilho comum relacionado ao primeiro pedido de um cliente.
Nesta página: Erro exibido durante a checkout, Código de desconto rejeitado durante a checkout, Pedido de cliente novo

Erro exibido na checkout
É acionado quando o checkout exibe um erro ou um aviso ao cliente: um endereço inválido, um pagamento recusado, um campo que rejeita a entrada de dados. Ele contém a mensagem, seu tipo e o campo ao qual pertence.
| Incêndios causados por | O pixel da loja virtual do aplicativo, no navegador do comprador |
| Autorização | Acesso ao comportamento da loja virtual |
| 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
- Descubra que o processo de checkout está falhando sem esperar pelas reclamações.
- Identifique uma regra de envio ou pagamento que não esteja em conformidade após uma alteração.
O que o “Erro exibido no checkout” transmite ao seu fluxo de trabalho
| Variável em Shopify Flow | Tipo | O que contém |
|---|---|---|
checkoutAlert |
Objeto | A mensagem exibida e onde ela apareceu |
checkoutAlert.message |
Texto | O que foi dito ao cliente, em sua língua. |
checkoutAlert.type |
Texto | O tipo de alerta, por exemplo, INPUT_INVALID. |
checkoutAlert.target |
Texto | O campo que apresentou erro, por exemplo, cart.discountCode. |
eventId |
Texto | O ID deste evento. Procure-o no Histórico de Eventos do aplicativo para verificar exatamente o que foi enviado. |
Exemplo: Coletar erros de checkout em um canal
- Selecione “Erro na Checkout” como gatilho.
- Adicione uma condição para ignorar o ruído:
checkoutAlert.targetNão é igual acart.discountCode(os códigos rejeitados têm seu próprio gatilho). - Adicione a função “Enviar solicitação HTTP para o Slack”:
{{checkoutAlert.type}} on {{checkoutAlert.target}}: {{checkoutAlert.message}}. - Ative o fluxo de trabalho e fique atento a um aumento repentino, em vez de eventos isolados.
Código de desconto rejeitado no checkout
É acionado quando o checkout recusa um código de desconto. O método Shopify não informa aos aplicativos qual código foi digitado; portanto, o evento contém apenas o motivo e nada mais.
| Incêndios causados por | O pixel da loja virtual do aplicativo, no navegador do comprador |
| Permissão | Acesso ao comportamento da loja virtual |
| 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
- Identifique um código de campanha expirado ou digitado incorretamente poucos minutos após o envio de um e-mail.
O que a notificação “Código de desconto rejeitado no checkout” envia ao seu fluxo de trabalho
| Variável em Shopify Flow | Tipo | O que contém |
|---|---|---|
discountAttempt |
Objeto | Por que o código não foi aplicado, na linguagem do consumidor |
discountAttempt.reason |
Texto | |
eventId |
Texto | O ID deste evento. Procure-o no Histórico de Eventos do aplicativo para ver exatamente o que foi enviado. |
Exemplo: Alertar o departamento de marketing sobre um aumento no número de códigos rejeitados
- Selecione “Código de desconto na Checkout rejeitado” como gatilho.
- Adicione a função “Enviar solicitação HTTP” a um canal ou a um contador:
A discount code was rejected: {{discountAttempt.reason}}. - Ative o fluxo de trabalho. Logo após o envio de uma campanha, uma série de mensagens desse tipo indica que o código no e-mail não está funcionando.
Pedido de um cliente novo
É acionado quando um pedido é feito por um cliente que nunca fez um pedido antes. Trata-se de um gatilho de pedido, e não de um gatilho do navegador: ele é acionado de forma confiável e contém o pedido e o cliente como referências.
| Incêndios causados por | Shopify webhook |
| Permissão | Acesso aos dados de pedidos + Acesso aos dados de clientes |
| Ligado | Ativar um fluxo de trabalho do Shopify Flow que o utilize faz com que ele seja ativado. O botão de ativação específico desse fluxo de trabalho encontra-se na página “Gatilhos” do aplicativo |
Utilize-o para
- Série de boas-vindas, uma nota de agradecimento ou um pequeno presente para os primeiros pedidos.
- Tag os compradores de primeira viagem para uma segmentação posterior.
O que o pedido “De cliente novo” envia para o seu fluxo de trabalho
| Variável em Shopify Flow | Tipo | O que contém |
|---|---|---|
order |
Pedido (Shopify) | O primeiro pedido do cliente. Trata-se de um pedido completo do Shopify, portanto, todos os seus campos e as ações de pedido próprias do Shopify Flow estão disponíveis. |
customer |
Cliente (Shopify) | O cliente de primeira visita. 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. |
eventId |
Texto | O ID deste evento. Procure-o no Histórico de Eventos do aplicativo para verificar exatamente o que foi enviado. |
Exemplo: Identificar e dar as boas-vindas aos compradores de primeira viagem
- Selecione “Pedido de cliente novo” como gatilho.
- Adicione as tags de cliente
first-ordere as tags de pedidofirst-order. - Adicione “Enviar e-mail interno para a equipe de embalagem:
{{order.name}} is {{customer.displayName}}'s first order - add the welcome card”. - 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 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.
