
# MemberPress

> **Para quem é isso?** Empresas que vendem assinaturas, cursos ou comunidades pagas através do MemberPress em seu próprio site WordPress. Se você não usa o MemberPress, pode pular esta página.
>
> Usa uma ferramenta de assinatura diferente? Qualquer coisa com uma API ainda pode ser conectada: veja [Conectando uma Ferramenta que Não Listamos](connecting-other-tools.md).

O MemberPress é o plugin do WordPress que vende e restringe o acesso a assinaturas: membros, as assinaturas que eles possuem, suas inscrições e seus pagamentos. Conectá-lo ao <span data-t="appName">DM Champ</span> fornece às suas [automações](../automations/automations.md) etapas que leem a situação de um membro e concedem uma assinatura, para que seu agente de IA possa responder "no que estou inscrito" a partir do registro real, e um novo comprador possa ter acesso sem que ninguém precise abrir o WordPress.

Nada é instalado em seu site WordPress além do próprio complemento do MemberPress, descrito abaixo. Você conecta seu próprio site com sua própria chave de API.

**Disponibilidade:** Automações estão disponíveis em todas as contas. Já está na sua barra lateral e não há nada para habilitar ou solicitar.

---

## O que você precisa

- MemberPress em um site WordPress acessível via **https**, com **links permanentes amigáveis** ativados (**Configurações → Links permanentes**, qualquer opção que não seja "Padrão"), que é o que faz o endereço `/wp-json/` funcionar.
- O complemento **Developer Tools** do MemberPress, que é o que ativa sua API. Ele vem com os planos superiores do MemberPress, então, se você não conseguir encontrá-lo, essa é a primeira coisa a verificar.
- A **chave de API** que ele fornece: no WordPress, **MemberPress → Developer Tools → API key**.

---

## Conectando o MemberPress

Você se conecta de dentro de uma automação, na primeira vez que usa uma etapa do MemberPress.

1. Abra **Automações** na barra lateral (sob o grupo **AI Studio**) e abra ou crie uma automação.
2. Adicione uma etapa e pesquise por **MemberPress** no seletor de etapas.
3. Escolha a ação desejada. A etapa solicitará que você se conecte primeiro.
4. Preencha os dois campos:
   - **URL do site** é o endereço do site WordPress onde o MemberPress é executado, começando com `https://`.
   - **Chave de API** é a chave obtida em **MemberPress → Developer Tools**.
5. Clique em conectar.

Verificamos a chave em seu site antes de salvar qualquer coisa. Um endereço incorreto, uma chave incorreta ou o Developer Tools não estar ativo é recusado na tela com o motivo, para que você nunca obtenha uma conexão que pareça correta e falhe na primeira vez que a automação for executada. Sua chave de API é armazenada criptografada e nunca é exibida novamente para você. Perdeu a chave? Gere uma nova no MemberPress e conecte-se novamente.

---

## As Ações

Cada ação é uma etapa na tela de automação, e todos os campos aceitam dados de etapas anteriores com os botões usuais de inserção de dados.

### Obter membro

Busca um membro: seu perfil e as assinaturas que ele possui.

- **ID do membro** é qual membro. Obrigatório.

### Localizar membro por e-mail

Pesquisa um membro pelo endereço de e-mail e retorna seu id.

- **E-mail** é o endereço a ser pesquisado. Obrigatório, e geralmente é o e-mail do contato proveniente do gatilho.

Esta é a etapa que transforma um endereço de e-mail no id de membro que as outras etapas precisam.

### Criar membro

Cria uma conta de membro. Isso não concede a ele uma assinatura por si só; **Criar transação** é o que faz isso.

- **E-mail** é o endereço de e-mail dele. Obrigatório.
- **Nome de usuário** é o nome com o qual ele fará login. Obrigatório.
- **Nome** e **Sobrenome** são opcionais.
- **Senha** é opcional. Se deixada em branco, o MemberPress gera uma.

### Listar assinaturas de um membro

Todas as assinaturas pertencentes a um membro, da mais recente para a mais antiga.

- **ID do membro** é qual membro. Obrigatório.

### Listar transações de um membro

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

- **ID do membro** é qual membro. Obrigatório.

### Criar transação

Registra um pagamento, que é como o MemberPress concede uma assinatura.

- **ID do Membro** é quem recebe. Obrigatório.
- **ID da Assinatura** é o que eles recebem: o id da assinatura em **MemberPress → Assinaturas**. Obrigatório.
- **Valor** é o que foi pago. Opcional.
- **Status** decide se conta: `complete` é o que concede acesso, e é isso que ele usa quando você 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 Automação

**Responda às perguntas do próprio membro a partir do registro real.**

1. **Gatilho:** seu agente de IA chama esta automação como uma ferramenta quando alguém pergunta sobre sua assinatura. (Adicione a automação como uma **Função de Agente de IA** e o agente poderá executá-la durante a conversa.)
2. **Encontrar membro por e-mail**, com o e-mail do contato.
3. **Listar assinaturas de um membro**, usando o id da etapa 2.
4. Os resultados voltam para o agente, que responde em palavras simples: qual assinatura, se está ativa ou não, e quando ela é renovada.

**E na outra direção: deixe alguém entrar após o pagamento.**

1. **Gatilho:** um **Webhook**, apontado pelo que processou o pagamento.
2. **Encontrar membro por e-mail**. Uma etapa de **Condição** ramifica dependendo se eles existem.
3. Se não, **Criar membro** com seu e-mail e um nome de usuário.
4. **Criar transação** com seu id de membro, o id da assinatura que você está concedendo, o valor e um **Expira em** se o acesso for por um período fixo.
5. Uma etapa de **Enviar mensagem** informa no WhatsApp que eles entraram.

---

## É bom saber

- **Etapas que exigem um ID de membro vêm após uma etapa de Localização.** Encontre o membro por e-mail primeiro, depois passe o id para a próxima etapa.
- **As saídas seguem em frente.** Tudo o que uma ação retorna fica disponível para as etapas posteriores como variáveis.
- **Uma assinatura é concedida registrando um pagamento.** É assim que o próprio MemberPress funciona: **Criar membro** cria a conta, **Criar transação** com um status `complete` é o que abre a porta.
- **Não há gatilho que monitore o MemberPress.** Nada faz polling nele para novos membros ou novos pagamentos. Para fazer com que o MemberPress inicie uma automação, adicione um gatilho de **Webhook** à automação e aponte um webhook do MemberPress para o endereço que ele fornece.
- **A API precisa do complemento Ferramentas do Desenvolvedor.** Sem ele, não há nada em seu site com o qual possamos nos comunicar, não importa quão corretos estejam os outros detalhes.
- **Qualquer coisa que não esteja na lista acima** ainda pode ser feita com a etapa de **Solicitação HTTP**.

---

## Próximos passos

- [Automações](../automations/automations.md): gatilhos, etapas, condições e como um fluxo de trabalho é montado.
- [WordPress](wordpress.md): posts e usuários no mesmo site.
- [FluentCRM](fluentcrm.md): contatos, tags e listas no mesmo site.
- [Conectando uma Ferramenta que Não Listamos](connecting-other-tools.md): funções personalizadas, a API e webhooks.
