Ir para o conteúdo
memberarea memberarea.io

Usar as ações do MemberArea em um workflow do HubSpot

Dez etapas para os seus workflows de contatos no HubSpot: conceder ou retirar acesso, gerenciar grupos e tags, preencher campos de membro, iniciar uma automação ou criar um link de pagamento.

Neste artigo

Depois que o HubSpot está conectado, um workflow do HubSpot pode executar dez ações do MemberArea: conceder acesso a um curso, conceder acesso a um produto ou pacote, revogar o acesso, adicionar alguém a um grupo ou tirá-lo dele, adicionar ou remover uma tag, definir um campo de membro, iniciar uma automação ou criar um link de pagamento. Um envio de formulário no HubSpot pode liberar um curso, e uma mudança de fase do ciclo de vida pode tirá-lo de novo. Este artigo explica o que cada ação precisa e o que ela devolve.

Antes de começar

As ações precisam da permissão Automação da conexão do HubSpot. Se as etapas do MemberArea não aparecerem no seu editor de workflows, verifique isso primeiro: abra Configurações, depois Integrações, e clique na linha do HubSpot. A caixa de diálogo mostra o quadro Status da conexão. Se ele disser As ações de workflow estão desativadas, a conta do HubSpot não concedeu essa permissão. Conecte de novo a partir de uma conta do HubSpot que tenha workflows.

Status da conexão com o aviso As ações de workflow estão desativadas, porque a conta não concedeu a permissão Automatização.
Status da conexão com o aviso As ações de workflow estão desativadas, porque a conta não concedeu a permissão Automatização.

As ações funcionam em workflows baseados em contatos. Adicione uma etapa e procure MemberArea na lista de ações.

As dez ações

Todas as ações, exceto Create checkout link, têm campos opcionais para a pessoa:

  • Email address: deixe vazio para usar o e-mail do contato inscrito. O MemberArea identifica os membros pelo e-mail, sem diferenciar maiúsculas e minúsculas.
  • First name e Last name: usados só quando uma nova conta de membro é criada. Por padrão, recebem o nome do contato. Remove from group e Remove tag nunca criam ninguém, por isso só têm Email address.

Grant course access

Dá ao contato acesso a um curso. Precisa do Course ID.

Abra o curso na sua área de membros em Cursos e olhe a barra de endereço: o identificador longo depois de /admin/courses/ é o ID do curso.

Importante

O curso precisa estar publicado. Um curso em rascunho nunca é entregue, nem mesmo por um workflow, e a etapa para com uma mensagem informando isso. Publique o curso primeiro.

Grant product or bundle access

Dá ao contato tudo o que um produto contém e, no caso de um pacote, tudo o que todos os seus produtos contêm: cursos, hubs, grupos, eventos, áreas da comunidade e emblemas. Precisa do Product or bundle ID.

  • Para um produto, abra Pagamentos, depois Catálogo, depois Produtos. O endereço é /admin/payments/catalog/products/<product ID>/edit.
  • Para um pacote, abra Pagamentos, depois Catálogo, depois Pacotes. O endereço é /admin/payments/catalog/bundles/<bundle ID>/edit.

Um curso do produto que ainda não foi publicado é ignorado. O membro recebe o curso assim que você o publicar e a etapa for executada de novo.

Revoke access

O espelho da anterior: retira o que um produto ou pacote concede. Precisa do Product or bundle ID e, opcionalmente, do Email address.

Importante

O acesso que o membro pagou nunca é removido. Se alguém comprou o produto na sua área de membros e depois passa por um workflow de revogação, a compra prevalece e a etapa informa que nada foi retirado.

Add to group

Coloca o contato em um dos seus grupos. Precisa do Group ID: abra o grupo em Público, depois Grupos, e copie da barra de endereço o identificador depois de /admin/audience/groups/.

O grupo automático "Todos os membros" não pode ser usado aqui. Todos os membros já estão nele. Um grupo que atingiu o seu limite de membros não aceita mais ninguém, e a etapa informa isso.

Remove from group

Tira o contato de um dos seus grupos. Precisa do Group ID, que você encontra do mesmo jeito que para Add to group. Se o contato não tiver conta de membro ou não estiver no grupo, nada muda e a etapa é concluída mesmo assim.

Add tag

Aplica uma tag ao membro. Preencha Tag com o nome da tag, por exemplo Webinar 2026. Maiúsculas e minúsculas não importam. Se ainda não existir uma tag com esse nome, ela é criada. Uma automação que inicia em Tag aplicada é executada assim que a tag é definida.

Remove tag

Retira uma tag do membro. Preencha Tag com o nome dela. Ao contrário de Add tag, esta ação nunca cria uma tag: um nome desconhecido para a etapa com uma mensagem. Um contato sem conta de membro, ou sem a tag, fica como está.

Set member field

Grava um valor em um dos seus campos de membro. Preencha Member field com o nome do campo como ele aparece em Público, na aba Campos, e Value com o que deve ir nele. O valor é um texto fixo. Para copiar uma propriedade do contato em vez disso, escolha-a em Value from property. Uma propriedade escolhida tem prioridade sobre Value.

Todos os tipos de campo podem ser preenchidos assim, exceto seleção múltipla e uploads, como imagens ou arquivos. Um valor que não combina com o campo, como many para um campo numérico, para a etapa e nada é salvo. Uma automação que inicia em Campo de membro alterado é executada quando o valor realmente muda.

Start automation

Executa uma das suas automações do MemberArea para o contato, assim o workflow no HubSpot decide quando ela começa. Precisa do Automation ID: abra a automação na sua área de membros e copie da barra de endereço o id depois de /admin/automations/.

  1. Dê à automação o gatilho Iniciado a partir de um workflow do HubSpot.
  2. Publique-a e ative-a.
  3. Cole o ID dela em Automation ID no workflow do HubSpot.

Como montar uma automação assim está descrito em Iniciar automações a partir do HubSpot.

Monta um link para o checkout da sua área de membros para um produto e o devolve como campo de saída, pronto para o próximo e-mail ou tarefa do workflow. O comprador paga pelos métodos de pagamento que você configurou para o seu checkout.

Campo O que faz
Product ID Obrigatório. O identificador de /admin/payments/catalog/products/<product ID>/edit.
Price ID Deixe vazio para usar o preço padrão do produto.
Coupon code Aplicado automaticamente ao checkout quando o link é aberto.
utm_source, utm_medium, utm_campaign Adicionados ao link como parâmetros de campanha.
Prefill the contact email Yes preenche o checkout com o e-mail do contato. O padrão é sim.

Diferente das outras, esta ação não altera nada e nunca cria uma conta de membro. Se existir um membro com o e-mail do contato, o link leva a conta dele junto.

O produto precisa estar ativo com um preço que possa ser comprado, e o espaço de trabalho precisa ter o seu próprio endereço web, porque o link precisa ficar em algum lugar. Se o produto estiver inativo ou não tiver esse preço, a etapa para com uma única mensagem para os dois casos. A falta de endereço web tem a sua própria mensagem.

Membros são criados quando não existem

Grant course access, Grant product or bundle access, Add to group, Add tag, Set member field e Start automation procuram o contato pelo endereço de e-mail. Se ainda não houver uma conta de membro para esse endereço, elas criam uma e depois fazem o seu trabalho, assim um workflow não trava em um contato que nunca se cadastrou.

Os novos membros não recebem nenhum e-mail do MemberArea nem uma senha que conheçam. Se o seu plano atingiu o número de membros, nenhuma conta é criada e a etapa para.

Revoke access, Remove from group, Remove tag e Create checkout link nunca criam ninguém. As três primeiras apenas informam que não havia membro, e o link de pagamento funciona com ou sem conta.

O que volta

Cada ação responde com campos que você pode usar mais adiante no mesmo workflow.

Ação Campos de saída
Grant course access Member email, Member ID, Member was created, Course name, Access was granted, Member already had access
Grant product or bundle access Member email, Member ID, Member was created, Product name, Product is a bundle, Access was granted, Items newly granted, Included items
Revoke access Member email, Member ID, Member account found, Product name, Product is a bundle, Access was revoked, Items newly revoked, Included items
Add to group Member email, Member ID, Member was created, Group name, Member was added, Member was already in the group
Remove from group Member email, Member ID, Member was found, Group name, Member was removed
Add tag Member email, Member ID, Member was created, Tag name, Tag was created, Tag was added, Member already had the tag
Remove tag Member email, Member ID, Member was found, Tag name, Tag was removed
Set member field Member email, Member ID, Member was created, Field name, Saved value, Value was changed
Start automation Member email, Member ID, Member was created, Automation name, Automation was started
Create checkout link Checkout link, Product name, Price in cents, Currency, Price, Email was prefilled

Price in cents é o valor na menor unidade da moeda, e Price é o mesmo valor escrito com a moeda, por exemplo 49,00 EUR.

Dica

Crie uma ramificação com base em Member was created para enviar um e-mail de "defina a sua senha" só para as pessoas que realmente são novas.

Quando uma ação falha

Quando uma ação não consegue fazer o seu trabalho, por exemplo porque o curso não está publicado ou o ID do produto está errado, a etapa é marcada como com falha, com um código e uma frase simples que diz o que fazer. O workflow continua com a próxima etapa. Se o próprio MemberArea tiver uma breve interrupção, o HubSpot tenta a etapa de novo mais tarde. O artigo de solução de problemas lista cada código e o que fazer em cada caso.

Last updated on October 31, 2026

Este artigo foi útil?

Artigos relacionados