
# 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](connecting-other-tools.md).

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 <span data-t="appName">DM Champ</span> confere às suas [automatizações](../automations/automations.md) 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

- [Automatizações](../automations/automations.md): acionadores, passos, condições e como um fluxo de trabalho é estruturado.
- [WordPress](wordpress.md): publicações e utilizadores no mesmo site.
- [FluentCRM](fluentcrm.md): contactos, etiquetas e listas no mesmo site.
- [Ligar uma Ferramenta que Não Listamos](connecting-other-tools.md): funções personalizadas, a API e webhooks.
