Acionar o Shopify Flow no envio do Registration Form

Depois de ativado, sempre que um cliente for criado ou atualizado por um Registration Form, o app envia um evento ao Shopify Flow, a ferramenta gratuita de automação sem código da Shopify. Você pode então criar um fluxo no Flow para reagir a esse evento como preferir: avisar sua equipe de vendas no Slack, aplicar tags ou segmentar o cliente, criar uma tarefa, sincronizar o cliente com outro sistema e assim por diante.

Nota

Antes de usar este recurso, confirme que seu formulário já está conectado aos dados de clientes da Shopify. Consulte Integrar o Registration Form aos dados de clientes da Shopify.

Etapas

1. Abra as configurações de integração do formulário

   No app, clique em Registration Form, abra o formulário desejado, clique na guia Integration e escolha Shopify.

   

2. Ative o gatilho do Flow

   Ative Enable Shopify Flow trigger.

   

3. Salve

   Clique em Save.

Cuidado

Esta opção só está disponível em alguns planos. Se você não vir Enable Shopify Flow trigger em Integration > Shopify, confira Settings > Pricing plan ou entre em contato com o suporte.

Crie um fluxo no Shopify Flow

1. Instale o Shopify Flow

   Acesse admin da Shopify > Apps > Flow. Ele é gratuito e está disponível em todos os planos da Shopify; instale-o se ainda não tiver feito isso.

2. Crie um fluxo

   Clique em Criar fluxo de trabalho.

3. Escolha o gatilho

   Na etapa do gatilho, pesquise por Sami Wholesale (listado como “All-in-1 Wholesale B2B: Volume discount, b2b registration, tax”) e abra-o. Dentro dele, selecione o gatilho chamado Sami B2B Wholesale Pricing, cuja descrição é “Triggers when a customer is created or updated via a Wholesale registration form.”

   

4. Adicione ações

   Adicione as ações de que precisar. O Flow traz centenas de ações prontas: enviar uma notificação, adicionar uma tag, chamar um webhook, ramificar conforme uma condição e muito mais.

5. Ative o fluxo

   Clique em Ativar.

Dica

Resultado: a partir de agora, sempre que um cliente se cadastrar ou for atualizado por um formulário com esta opção ativada, o fluxo é executado automaticamente, normalmente em cerca de 2 minutos após o envio.

Dados disponíveis no fluxo

Ao montar seu fluxo, você pode inserir as seguintes variáveis em qualquer etapa:

Variável	Descrição
Customer	O cliente da Shopify que foi criado ou atualizado. Use-o diretamente com qualquer ação relacionada a clientes (adicionar tag, adicionar a um segmento, enviar e-mail etc.).
Form > Name	O nome do Registration Form que foi enviado. É útil se você tem vários formulários e quer que o fluxo se comporte de forma diferente conforme o formulário usado.
Registration customer > Data	Tudo o que o cliente preencheu no formulário (rótulo e valor do campo), reunido em uma única string JSON. Veja abaixo como separá-la em campos individuais.

Ler campos individuais de “Registration customer > Data”

Os dados enviados do formulário chegam como uma única string JSON (por exemplo: {"Email": "[email protected]", "First Name": "John", "Company name": "ABC Co."}), com todos os campos reunidos em uma só variável. Para separá-la em campos individuais que você possa usar mais adiante no fluxo, adicione uma etapa Run code logo após o gatilho.

Etapa 1: adicione a ação “Run code”

No seu fluxo, clique em Adicionar ação e procure e selecione Run code.

Etapa 2: preencha o Input (consulta GraphQL)

Na caixa Input, cole:

{
  registrationCustomer {
    data
  }
}

Etapa 3: preencha a Function (JavaScript)

Na caixa Function, cole:

export default function main({ registrationCustomer }) {
  const formData = JSON.parse(registrationCustomer.data);

  return {
    email: formData['Email'] || '',
    firstName: formData['First Name'] || '',
    companyName: formData['Company name'] || '',
  };
}

Nota

Substitua 'Email', 'First Name', 'Company name'… pelo rótulo exato do campo exibido no seu formulário (e não pelo ID interno do elemento).

Etapa 4: preencha o Output (tipo de retorno)

Na caixa Output, cole uma declaração de tipo que corresponda ao que você retornou na Etapa 3:

type Output {
  email: String!
  firstName: String!
  companyName: String!
}

Etapa 5: use o resultado nas etapas seguintes

Depois de salvar, esta etapa Run code passa a ser uma nova fonte de variáveis para as ações seguintes. Insira email, firstName, companyName (ou os nomes que você escolheu) no corpo de um e-mail, em uma mensagem do Slack, em uma condição etc.

Cuidado

O Run code do Shopify Flow executa JavaScript em um ambiente isolado e restrito (sem chamadas a APIs externas, sem bibliotecas externas e com limite de 5 segundos de execução). Use-o apenas para reorganizar dados, e não para chamar um webhook diretamente. Para chamar um webhook, use a ação nativa HTTP request do Flow em uma etapa separada.

Limitação: o Output de uma etapa Run code só permite declarar campos individuais (String, Int, Float, Boolean, ID etc.); não existe um tipo de retorno “JSON” genérico. Você não pode repassar livremente o objeto registrationCustomer.data inteiro; é preciso declarar cada campo de que precisa (Etapas 3 e 4) usando o rótulo exato do seu formulário. Se você adicionar um campo novo ao formulário depois e quiser usá-lo no fluxo, volte e adicione-o também à etapa Run code.

Observações

• Exige o app Shopify Flow na sua loja (gratuito e disponível em todos os planos da Shopify).
• Depois que um cliente envia o formulário, o fluxo pode levar até alguns minutos para ser disparado. Isso é esperado e não é um erro.
• Este recurso está disponível conforme o plano do seu app; se você não vir Enable Shopify Flow trigger, confira seu plano atual ou entre em contato com o suporte.

Precisa de ajuda?

Se tiver qualquer dificuldade ao seguir estas etapas, não hesite em nos contatar pelo e-mail [email protected].