
# MemberPress

> **这是为谁准备的？** 在自己的 WordPress 网站上通过 MemberPress 销售会员资格、课程或付费社区的企业。如果您不使用 MemberPress，可以跳过此页面。
>
> 使用了其他会员工具？任何带有 API 的工具都可以连接：请参阅 [连接我们未列出的工具](connecting-other-tools.md)。

MemberPress 是一款用于销售和限制会员资格的 WordPress 插件：包括会员、他们持有的会员资格、他们的订阅以及他们的付款。将其连接到 <span data-t="appName">DM Champ</span> 可以为您的 [自动化](../automations/automations.md) 提供读取会员状态并授予会员资格的步骤，这样您的 AI 代理就可以根据真实记录回答“我注册了什么”，并且新买家无需任何人打开 WordPress 即可进入。

除了下文所述的 MemberPress 自身插件外，您的 WordPress 网站上无需安装任何其他内容。您可以使用自己的 API 密钥连接自己的网站。

**可用性：** 每个账户均可使用自动化功能。它已经在您的侧边栏中，无需启用或申请。

---

## 您需要准备什么

- 运行在 **https** 上且开启了 **固定链接 (pretty permalinks)** 的 WordPress 网站（**设置 → 固定链接**，选择“普通”以外的任何选项），这是使 `/wp-json/` 地址生效的前提。
- MemberPress 的 **Developer Tools** 插件，这是开启其 API 的关键。它包含在 MemberPress 的高级计划中，因此如果您找不到它，请首先检查这一点。
- 它提供的 **API 密钥**：在 WordPress 中，**MemberPress → Developer Tools → API key**。

---

## 连接 MemberPress

您可以在自动化流程内部，首次使用 MemberPress 步骤时进行连接。

1. 打开侧边栏中的 **Automations**（在 **AI Studio** 组下），然后打开或创建一个自动化流程。
2. 添加一个步骤，并在步骤选择器中搜索 **MemberPress**。
3. 选择您需要的操作。该步骤会要求您先进行连接。
4. 填写两个字段：
   - **Site URL** 是 MemberPress 运行所在的 WordPress 网站地址，以 `https://` 开头。
   - **API key** 是来自 **MemberPress → Developer Tools** 的密钥。
5. 点击连接。

我们在保存任何内容之前会先根据您的网站验证密钥。错误的地址、错误的密钥或未激活的 Developer Tools 会在屏幕上被拒绝并显示原因，因此您永远不会遇到看起来正常但在自动化首次运行时失败的连接。您的 API 密钥经过加密存储，绝不会再次向您显示。丢失了？在 MemberPress 中生成一个新的并重新连接即可。

---

## 操作

每个操作都是自动化画布上的一个步骤，每个字段都接受来自先前步骤的数据，并提供常规的插入数据按钮。

### 获取会员 (Get member)

获取一名会员：包括他们的个人资料以及他们持有的会员资格。

- **会员 ID** 是指哪位会员。必填项。

### 通过电子邮件查找会员

通过电子邮件地址查找会员，并返回其 ID。

- **电子邮件**是要查找的地址。必填项，通常是触发器中联系人的电子邮件。

此步骤将电子邮件地址转换为其他步骤所需的会员 ID。

### 创建会员

创建一个会员账户。它本身不会授予会员资格；**创建交易**才是实现该功能的操作。

- **电子邮件**是他们的电子邮件地址。必填项。
- **用户名**是他们登录时使用的名称。必填项。
- **名字**和**姓氏**为选填项。
- **密码**为选填项。如果留空，MemberPress 将自动生成一个。

### 列出会员的订阅

属于某位会员的所有订阅，按最新日期排序。

- **会员 ID** 是指哪位会员。必填项。

### 列出会员的交易

属于某位会员的所有付款记录，按最新日期排序。

- **会员 ID** 是指哪位会员。必填项。

### 创建交易

记录一笔付款，这是 MemberPress 授予会员资格的方式。

- **会员 ID** 是指获得权限的对象。必填。
- **会员资格 ID** 是指他们获得的权限内容：来自 **MemberPress → 会员资格** 中的会员资格 ID。必填。
- **金额** 是指支付的金额。可选。
- **状态** 决定了它是否生效：`complete` 是授予访问权限的状态，如果您将此字段留空，系统将默认使用该状态。
- **过期时间** 是指访问权限结束的时间，以日期和时间格式书写，例如 `2027-01-31 23:59:59`。**若要授予永久访问权限，请将其留空。**

---

## 一个自动化示例

**根据真实记录回答会员自己的问题。**

1. **触发器：** 当有人询问其会员资格时，您的 AI 智能体将此自动化作为工具调用。（将此自动化添加为 **AI 智能体功能**，智能体即可在对话过程中运行它。）
2. **通过电子邮件查找会员**，使用联系人的电子邮件。
3. **列出会员的订阅**，使用第 2 步获取的 ID。
4. 结果返回给智能体，智能体以通俗易懂的语言回答：会员资格类型、是否处于活跃状态以及续费时间。

**反向操作：在用户付款后授予其访问权限。**

1. **触发器：** 一个 **Webhook**，指向处理付款的任何服务。
2. **通过电子邮件查找会员**。使用 **条件** 步骤根据他们是否存在进行分支处理。
3. 如果不存在，则使用他们的电子邮件和用户名 **创建会员**。
4. **创建交易**，包含他们的会员 ID、您要授予的会员资格 ID、金额，以及如果访问权限有固定期限，则填写 **过期时间**。
5. **发送消息** 步骤通过 WhatsApp 通知他们已获得访问权限。

---

## 值得了解的信息

- **需要会员 ID 的步骤必须放在“查找”步骤之后。** 先通过电子邮件查找会员，然后将 ID 传递给下一步。
- **输出结果向下传递。** 操作返回的所有内容都可作为变量供后续步骤使用。
- **授予会员资格是通过记录付款来实现的。** 这正是 MemberPress 本身的工作方式：**创建会员** 用于建立账户，使用 `complete` 状态 **创建交易** 则是开启访问权限的关键。
- **没有直接监控 MemberPress 的触发器。** 系统不会轮询 MemberPress 以获取新会员或新付款。若要让 MemberPress 启动自动化，请在自动化中添加 **Webhook** 触发器，并将 MemberPress 的 Webhook 指向它提供的地址。
- **API 需要安装 Developer Tools 插件。** 否则，无论您的其他详细信息设置得多么正确，您的站点都无法与我们进行通信。
- **上述列表中未包含的任何操作** 仍然可以通过 **HTTP 请求** 步骤来完成。

---

## 后续步骤

- [自动化](../automations/automations.md)：触发器、步骤、条件以及工作流的构建方式。
- [WordPress](wordpress.md)：同一站点上的文章和用户。
- [FluentCRM](fluentcrm.md)：同一站点上的联系人、标签和列表。
- [连接未列出的工具](connecting-other-tools.md)：自定义函数、API 和 Webhook。
