DM Champ Docs

MemberPress

Para quem é isto? Empresas que vendem assinaturas, cursos ou comunidades pagas através do MemberPress no seu próprio site WordPress. Se não utiliza o MemberPress, pode ignorar esta página.

Utiliza outra ferramenta de assinaturas? Qualquer ferramenta com uma API pode ser ligada: consulte Ligar uma Ferramenta que Não Listamos.

O MemberPress é o plugin de WordPress que vende e restringe o acesso a assinaturas: membros, as assinaturas que possuem, as suas subscrições e os seus pagamentos. Ligá-lo ao DM Champ confere às suas automatizações passos que leem o estado de um membro e concedem uma assinatura, para que o seu agente de IA possa responder a “a que estou subscrito?” a partir do registo real, e um novo comprador possa ser admitido sem que ninguém tenha de abrir o WordPress.

Nada é instalado no seu site WordPress para além do próprio suplemento do MemberPress, descrito abaixo. Liga o seu próprio site com a sua própria chave de API.

Disponibilidade: As Automatizações estão disponíveis em todas as contas. Já se encontram na sua barra lateral e não há nada para ativar ou solicitar.

O que precisa

  • MemberPress num site WordPress acessível via https, com ligações permanentes amigáveis ativadas (Definições → Ligações permanentes, qualquer opção que não seja “Simples”), que é o que faz o endereço /wp-json/ funcionar.
  • O suplemento Developer Tools do MemberPress, que é o que ativa a sua API. Este vem incluído nos planos superiores do MemberPress, por isso, se não o encontrar, é a primeira coisa a verificar.
  • A chave de API que este lhe fornece: no WordPress, MemberPress → Developer Tools → API key.

Ligar o MemberPress

A ligação é feita a partir de uma automatização, na primeira vez que utiliza um passo do MemberPress.

  1. Abra Automatizações na barra lateral (no grupo AI Studio) e abra ou crie uma automatização.
  2. Adicione um passo e procure por MemberPress no seletor de passos.
  3. Escolha a ação pretendida. O passo solicitará que se ligue primeiro.
  4. Preencha os dois campos:
    • URL do site é o endereço do site WordPress onde o MemberPress está a correr, começando com https://.
    • Chave de API é a chave obtida em MemberPress → Developer Tools.
  5. Clique em ligar.

Verificamos a chave no seu site antes de guardar qualquer informação. Um endereço incorreto, uma chave errada ou o facto de as Developer Tools não estarem ativas são recusados no ecrã com o respetivo motivo, para que nunca obtenha uma ligação que parece correta mas falha na primeira execução da automatização. A sua chave de API é armazenada de forma encriptada e nunca lhe é mostrada novamente. Perdeu-a? Gere uma nova no MemberPress e ligue-se novamente.

As Ações

Cada ação é um passo na tela de automatização, e todos os campos aceitam dados de passos anteriores com os habituais botões de inserção de dados.

Obter membro

Recupera um membro: o seu perfil e as assinaturas que detém.

  • ID de membro é o membro em questão. Obrigatório.

Encontrar membro por e-mail

Procura um membro pelo endereço de e-mail e devolve o seu id.

  • E-mail é o endereço a procurar. Obrigatório e, normalmente, o e-mail do contacto proveniente do acionador.

Este é o passo que transforma um endereço de e-mail no id de membro de que os outros passos necessitam.

Criar membro

Cria uma conta de membro. Por si só, não lhe atribui uma adesão; a opção Criar transação é que o faz.

  • E-mail é o seu endereço de e-mail. Obrigatório.
  • Nome de utilizador é o nome com que irá iniciar sessão. Obrigatório.
  • Nome e Apelido são opcionais.
  • Palavra-passe é opcional. Se for deixada em branco, o MemberPress gera uma.

Listar as subscrições de um membro

Todas as subscrições pertencentes a um membro, da mais recente para a mais antiga.

  • ID de membro é o membro em questão. Obrigatório.

Listar as transações de um membro

Todos os pagamentos pertencentes a um membro, do mais recente para o mais antigo.

  • ID de membro é o membro em questão. Obrigatório.

Criar transação

Regista um pagamento, que é a forma como o MemberPress concede uma adesão.

  • ID de Membro é quem recebe. Obrigatório.
  • ID de Adesão é o que recebem: o id da adesão em MemberPress → Adesões. Obrigatório.
  • Montante é o que foi pago. Opcional.
  • Estado decide se conta: complete é o que concede acesso, e é o que utiliza quando deixa o campo vazio.
  • Expira em é quando o acesso termina, escrito como data e hora, por exemplo 2027-01-31 23:59:59. Deixe vazio para uma concessão que não expira.

Um exemplo de automatização

Responda às perguntas de um membro a partir do registo real.

  1. Acionador: o seu agente de IA chama esta automatização como uma ferramenta quando alguém pergunta sobre a sua adesão. (Adicione a automatização como uma Função de Agente de IA e o agente pode executá-la a meio da conversa.)
  2. Encontrar membro por e-mail, com o e-mail do contacto.
  3. Listar as subscrições de um membro, utilizando o id do passo 2.
  4. Os resultados voltam para o agente, que responde por palavras simples: qual a adesão, se está ativa ou não, e quando é renovada.

E na outra direção: deixe alguém entrar depois de pagar.

  1. Acionador: um Webhook, apontado pelo que processou o pagamento.
  2. Encontrar membro por e-mail. Um passo de Condição ramifica consoante a existência ou não do membro.
  3. Se não existir, Criar membro com o seu e-mail e um nome de utilizador.
  4. Criar transação com o seu id de membro, o id da adesão que está a conceder, o montante e um Expira em se o acesso for por um período fixo.
  5. Um passo de Enviar mensagem informa-os via WhatsApp de que já têm acesso.

É bom saber

  • Os passos que requerem um ID de membro vêm depois de um passo de Encontrar. Encontre primeiro o membro por e-mail e, em seguida, passe o id para o passo seguinte.
  • Os resultados seguem em frente. Tudo o que uma ação devolve fica disponível para os passos seguintes como variáveis.
  • Uma adesão é concedida através do registo de um pagamento. É assim que o próprio MemberPress funciona: Criar membro cria a conta, Criar transação com um estado complete é o que abre a porta.
  • Não existe nenhum acionador que monitorize o MemberPress. Nada verifica a existência de novos membros ou novos pagamentos. Para que o MemberPress inicie uma automatização, adicione um acionador de Webhook à automatização e aponte um webhook do MemberPress para o endereço que este lhe fornece.
  • A API necessita do suplemento Developer Tools. Sem ele, não há nada no seu site com que possamos comunicar, independentemente de quão corretos estejam os restantes detalhes.
  • Qualquer coisa que não esteja na lista acima ainda pode ser feita com o passo de Pedido HTTP.

Próximos Passos