Ir para o conteúdo
memberarea memberarea.io

Enviar eventos de membros de volta para a Shopify

Deixe o seu MemberArea criar, etiquetar e atualizar clientes da Shopify quando algo acontece com um membro, e reaja a pedidos, reembolsos e cancelamentos da Shopify com as suas próprias automações.

Neste artigo

Os pedidos fluem da sua loja para o seu MemberArea. Este artigo trata da outra direção: quando um membro entra, conclui um curso ou cancela uma assinatura, o seu MemberArea pode criar o cliente correspondente na Shopify, adicionar ou remover uma etiqueta e gravar um campo de cliente. Assim a sua loja sabe quem está dentro, e você pode segmentar esses clientes e mandar e-mails para eles na Shopify. O artigo também trata dos gatilhos da Shopify que você pode usar nas suas próprias automações.

Quem pode configurar isto

A página da Shopify precisa de Atualizar configurações da plataforma e Gerenciar integrações. Criar automações precisa também de Gerenciar automações. Sem ela, os modelos não podem ser marcados e a página diz "Você não tem permissão para criar automações." com a dica "Peça ao proprietário deste espaço de trabalho a permissão para gerenciar automações."

Começar pelos modelos

  1. Abra Configurações, depois Integrações, depois Shopify. A página fica em /admin/settings/integrations/shopify.
  2. Abra a aba Automações. Ela diz "Enviar os seus eventos de volta para a Shopify" e "Estas automações ficam ativas imediatamente. Você pode editá-las ou excluí-las mais tarde."
  3. Marque os modelos que você quer. Nenhum vem marcado.
  4. Clique em Criar automações. O botão mostra quantos você marcou.

Os modelos marcados são criados, publicados e ativados de uma vez, e "Criadas e ativas" aparece ao lado do botão. Cada um agora está na sua lista de automações com o nome do modelo.

Os mesmos quatro modelos aparecem no assistente de configuração, na etapa Regras, em "Enviar os seus eventos de volta para a Shopify". Ali, os marcados são criados quando você clica em Concluir a configuração.

Para criar, a loja precisa estar conectada. Se a conexão caiu, reconecte-a primeiro, veja Conectar sua loja Shopify.

Os quatro modelos

Modelo O que ele faz na Shopify
Novo membro: criar o cliente Quando uma nova conta de membro é criada, o membro ganha um cliente na Shopify com o mesmo endereço de e-mail, e a etiqueta memberarea-member é adicionada.
Curso concluído: etiquetar o cliente Quando um membro conclui um curso, o cliente da Shopify recebe a etiqueta course-completed.
Adesão terminada: remover a etiqueta Quando uma assinatura terminou de fato, a etiqueta memberarea-member é removida e o campo de cliente member_status é definido como cancelled.
Assinatura renovada: manter o estado atualizado Cada vez que uma assinatura é renovada, o campo de cliente member_status é definido como active.

"Assinatura" nesses modelos significa uma assinatura vendida no seu MemberArea, não uma na Shopify.

Alguns detalhes decorrem dos gatilhos por trás dos modelos:

  • Curso concluído: etiquetar o cliente reage a todos os cursos. Para etiquetar só um curso, abra a automação e escolha o curso no gatilho dela, como descrito em Gatilhos e ações.
  • Adesão terminada: remover a etiqueta é executado quando a assinatura terminou de fato. Um membro que cancela no fim do período pago mantém a etiqueta até essa data, assim como o acesso dele no seu MemberArea.
  • As etiquetas e o valor do campo são fixos no modelo. Abra a automação na sua lista de automações para alterá-los.

Já configurada

Um modelo que já existe para esta loja mostra Já configurada e não pode ser marcado de novo. Quando os quatro existem, a aba diz "Todas as automações sugeridas já existem." Se você arquivar ou excluir uma dessas automações, o modelo dela pode ser criado de novo.

A aba Automatizações mostra os quatro modelos da Shopify, um deles marcado como Já configurada.
A aba Automatizações mostra os quatro modelos da Shopify, um deles marcado como Já configurada.

Um modelo conta como configurado quando uma automação tem o mesmo gatilho e todas as etapas da Shopify do modelo, e essas etapas usam esta loja. Uma automação que tem só algumas das etapas, ou que grava em outra loja, não bloqueia o modelo.

Qual cliente da Shopify é alterado

Toda alteração é feita no cliente da Shopify que pertence ao membro. O seu MemberArea encontra esse cliente nesta ordem:

  1. O cliente já vinculado ao membro, por exemplo por um pedido da Shopify ou pela importação de clientes.
  2. Senão, um cliente da sua loja com exatamente o mesmo endereço de e-mail.

Só a ação Criar ou atualizar cliente cria um cliente quando nenhum é encontrado. Um cliente que já existe é vinculado, e o nome e o sobrenome dele são atualizados com o nome do membro. O endereço de e-mail e as etiquetas dele ficam como estão, e um membro sem nome não mexe no nome na Shopify. As ações que adicionam uma etiqueta, removem uma etiqueta ou definem um campo pulam um membro que ainda não tem cliente na Shopify. É por isso que Novo membro: criar o cliente é o modelo a configurar primeiro.

As alterações chegam à Shopify alguns segundos depois do evento. Várias alterações para o mesmo membro dentro desses segundos são enviadas juntas. Se uma etiqueta é adicionada e removida de novo nesse tempo, só a última alteração conta.

Aviso

Enquanto a loja estiver desconectada, as alterações dos seus membros não são enviadas para a Shopify, e elas não são recuperadas depois que você reconecta. Membros que entraram ou concluíram um curso nesse período ficam sem a etiqueta até o próximo evento deles.

O que o seu MemberArea envia para a Shopify não aparece no Registro de webhooks. Essa aba só lista o que a Shopify envia a você. Para conferir se uma etiqueta ou um campo chegou, abra o cliente no seu painel da Shopify.

Quando uma etapa da Shopify não tem nada que possa enviar, a execução no histórico da automação mostra a etapa como Concluído com uma Nota amarela que indica o motivo, por exemplo "O membro ainda não tem um cliente na Shopify, então a alteração foi ignorada. Adicione antes a etapa “Criar ou atualizar cliente”." O mesmo acontece quando a etapa não tem loja, etiqueta ou chave de campo, quando a execução não tem membro, ou quando a conexão com a loja não está ativa. Como abrir uma execução está explicado em Testes e histórico de execuções.

Nota

Uma etapa sem nota só significa que a alteração foi entregue para envio. Se a Shopify recusar a alteração alguns segundos depois, a execução continua mostrando a etapa como concluída e o motivo fica só no log do servidor. O cliente no seu painel da Shopify mostra se ela chegou.

Criar as suas próprias automações

Você pode usar a Shopify em qualquer automação, não só nos modelos. No editor de automações, os gatilhos e as ações da Shopify ficam na biblioteca, em Shopify, e funcionam assim que a sua loja está conectada.

Estes gatilhos iniciam uma automação quando algo acontece na sua loja:

Gatilho Quando é executado
Pedido pago na Shopify Um pedido da Shopify é pago.
Reembolso na Shopify Um pedido da Shopify é reembolsado, também para um reembolso sem itens, como um valor de cortesia, e para um reembolso em outra moeda.
Pedido cancelado na Shopify Um pedido da Shopify é cancelado.

Os dois são executados esteja Revogar acesso em caso de reembolso ou Revogar acesso em caso de cancelamento ligado ou não, e cada um é executado uma vez por reembolso ou cancelamento, mesmo quando a Shopify envia a mesma mensagem duas vezes.

Estas ações alteram o cliente da Shopify do membro para o qual a automação é executada. Cada uma pergunta qual loja usar:

Ação O que ela faz
Criar ou atualizar cliente Garante que o membro exista como cliente na sua loja e atualiza o nome de um cliente que já existe.
Adicionar etiqueta de cliente Adiciona ao cliente a etiqueta que você digitar.
Remover etiqueta de cliente Remove do cliente a etiqueta que você digitar.
Definir campo de cliente Grava um valor em um campo do cliente.

Definir campo de cliente pede um nome de campo e um valor. A Shopify guarda o campo como um metafield de cliente no namespace memberarea, então um campo chamado member_status aparece como memberarea.member_status. O nome do campo é armazenado em minúsculas, com todo caractere que não seja letra, número ou sublinhado transformado em sublinhado. O valor é texto simples, cortado depois de 255 caracteres.

Um gatilho da Shopify é executado com o comprador como membro quando o pedido trazia um endereço de e-mail. Sem membro, as ações de cliente dessa automação não fazem nada.

Como gatilhos, ações, campos e filtros funcionam em geral está em Gatilhos e ações.

Nota

Uma execução de teste no editor de automações realmente executa as ações. Uma execução de teste de uma automação com uma ação da Shopify altera o cliente na sua loja.

Artigos relacionados

Last updated on October 31, 2026

Este artigo foi útil?

Artigos relacionados