- 流程始于一个触发器,并由一系列相关的操作继续进行。
- 在将数据映射到后续操作之前,应该对每个步骤进行测试。
- 这些连接授权 Activepieces 与选定的应用程序协同工作。
- 发布草稿会激活对自动化流程所做的更改。
Activepieces 让您无需从头开始开发整个集成,即可连接应用程序并运行重复性任务。每个自动化流程都以一个事件开始,并继续执行一个或多个使用先前步骤中获取的数据的操作。
本指南将 在 Activepieces 中创建自动化 Activepieces 会将识别为潜在客户的 Gmail 邮件记录到 Google Sheets 中。当邮件被添加特定标签时,Activepieces 会自动提取发件人、主题和其他数据,并将其保存到电子表格中。
然后,可以对相同的程序进行调整,以用于 利用人工智能从电子邮件中提取待办事项向 Slack 发送通知或向 CRM 添加联系人都是这方面的例子。重要的是要理解触发器、操作和信息映射的工作原理。
在Activepieces中,我们将实现哪些自动化?

流程将使用触发器 新标签电子邮件 来自 Gmail。当向电子邮件添加特定标签时,此功能将被激活。然后,执行以下操作 添加行 Google 表格会创建一个包含检索到信息的行。
结构如下:
- 收到一封与潜在客户相关的电子邮件。
- 用户或 Gmail 规则添加了该标签 线索.
- Activepieces 可以检测到已标记的消息。
- 该流程从电子邮件中提取必要的数据。
- Google 表格会添加一行包含该信息。
使用标签可以控制自动化流程处理哪些消息。如果我们只选择“新邮件”触发器,那么与销售线索无关的私人消息、广告或通知都可能出现在邮件中。
创建流程之前你需要准备什么
在打开 Activepieces 构建器之前,请准备以下物品:
- Activepieces Cloud 实例或自托管实例。
- 一个您可以授权的 Gmail 帐户。
- 拥有访问 Google Sheets 权限的 Google 帐户。
- 一个名为 Gmail 标签的标签 线索.
- 用于存储记录的电子表格。
在工作表的第一行,您可以创建列。 日期, 发件人, 事务 e 消息 ID标题使 Activepieces 更容易确定每个值应该放置在哪里。
最好发送或找到一封测试邮件,并在邮件中添加“潜在客户”标签。Activepieces 需要一个真实案例来展示映射过程中可用的字段。
如何创建流程并配置触发器

访问 Activepieces 并进入要保存自动化流程的项目。点击创建新流程的选项,并为其指定一个描述性名称,例如: 在 Google 表格中登记 Gmail 线索.
一切流程都始于一个 触发器或触发点击构建器的第一步,找到 Gmail 部分,然后选择事件。 新标签电子邮件.
Activepieces区分不同类型的触发器:
- 已安排: 他们会定期查看应用程序,了解最新动态。
- 网络钩子: 他们会立即收到另一个应用程序发送的请求。
- 计时器: 它们按照特定的日期或频率执行流程。
- 手册: 它们用于在用户做出决定时启动自动化流程。
本示例中使用的 Gmail 触发器会执行计划内的检查。因此,执行可能不会在标签应用的确切时刻立即开始。
如何连接 Gmail 并获取测试数据
在触发器中,打开连接字段,并为 Gmail 创建一个新的授权。使用相应的帐户登录,并在接受请求的权限之前对其进行审核。
然后选择标签 线索不同版本零件的具体字段名称可能会略有不同,但构建器会指出哪些选项是必需的。
下一步是生成示例数据。根据触发条件的不同,Activepieces 可能会显示以下选项: 加载数据, 测试触发器 o 生成示例数据.
如果系统未找到任何邮件,请返回 Gmail,将“潜在客户”标签添加到最近的一封邮件中,然后重复测试。您也可以在邮件提供模拟数据选项时使用它,尽管 现实世界中的例子更能反映这种结构。 它将接收生产过程中的流体。
在触发器正确显示输出之前,请勿继续操作。Activepieces 需要对每个步骤进行测试,以确保其字段能够在后续步骤中可靠使用。
如何添加 Google 表格操作
按下扳机下方的按钮添加新步骤。搜索 Google 表格 然后选择操作 添加行.
创建或选择可以编辑此表格的 Google 帐户连接。然后填写以下字段:
- 电子表格: 保存销售线索的文件。
- 工作表: 电子表格的特定标签页。
- 第一行包含标题: 如果第一行包含列名,则激活它。
- 价值观: 将插入到每一列中的数据。
请确认关联的帐户拥有编辑权限。如果工作表仅共享了读取权限,即使文件出现在选择器中,操作测试也会返回错误。
如何在 Gmail 和 Google Sheets 之间映射数据
Activepieces 以垂直方式组织工作流程。每个操作都可以访问其前一步生成的输出。在本例中,Google Sheets 可以使用 Gmail 触发器获取的信息。
单击与每一列对应的字段,然后在触发器输出中选择相应的值:
- 日期: 请选择收到消息的日期。
- 发件人: 使用发件人的地址或身份信息。
- 事务: 选择邮件主题。
- 消息 ID: 它会保存Gmail提供的唯一标识符。
可用字段取决于触发器的具体输出。因此,不建议在未先查看生成的示例之前,手动编写路径或从其他流程复制表达式。
您还可以将固定文本与动态值结合使用。例如,状态列可以始终接收该值。 耳环而其他应用则使用来自 Gmail 的数据。
如何避免不必要的或重复的注册
Gmail 的标签已经提供了一个初始过滤器,但您可以添加一个 路由器 如果需要添加其他条件,例如,只有当邮件主题包含“预算”一词或发件人属于特定域时,分支才能继续。
路由可以包含多个条件,并为不符合任何条件的数据提供一个备用分支。避免在初始阶段创建不必要的分支:初始流程越简单,其功能测试就越容易。
为了减少重复项,请将消息 ID 保存到 Google 表格中。在更高级的自动化流程中,您可以预先搜索该 ID,并仅在该 ID 不存在时才添加相应的行。
如何在发布前测试自动化
从其自身的控制面板测试 Google Sheets 操作。Activepieces 将使用从 Gmail 获取的示例数据执行此步骤。
该测试可以生成一个真实的行。 在电子表格中。使用虚拟数据,或在确认各列已正确填写后删除记录。
具体检查以下内容:
- 日期已按预期格式保存。
- 发件人显示在正确的列中。
- 这件事并非毫无意义。
- 该标识符属于被测消息。
- 各列之间的数值没有发生变化。
如果一切正常,请按 发布在编辑器中所做的更改在发布之前都将显示为草稿。保存或关闭编辑器并不一定意味着新版本已生效。
已发布的版本会被锁定。如果您再次编辑它,Activepieces 会基于该版本创建一个新草稿,这样您就可以进行更改而不会立即中断正在运行的自动化流程。
如何检查流程执行情况
将“潜在客户”标签添加到另一封电子邮件中,然后等待触发。之后打开该部分。 跑 来自 Activepieces 面板。
每次执行都会使用成功或错误指示器显示步骤状态。打开其中一个,即可查看:
- 该段落收到的数据。
- 发送到应用程序的值。
- Gmail 或 Google Sheets 返回的响应。
- 操作失败时生成的技术信息。
这种查看方式比盲目地重新配置工作流程要有用得多。如果 Gmail 可以正常工作但 Google Sheets 却无法使用,问题通常出在连接、工作表选择、权限或列映射方面。
在Activepieces中创建自动化时常见的错误

Gmail字段在映射过程中不会显示。
触发器尚未生成示例数据。请返回第一步,加载或触发一个真实事件,并验证输出是否包含发件人和主题。
Google Sheets 无法显示电子表格
请仔细检查是否已连接正确的帐户,以及该帐户是否拥有访问该文件的权限。共享工作表后,请刷新选择器或重新授权连接。
测试通过,但流程无法运行。
请确保您已发布草稿。在您点击“发布”之前,编辑所做的更改不会影响正式版本。 发布.
数据出现在错误的列中。
检查标题并重新选择操作中的工作表。如果在设置步骤后修改了第一行,则可能需要重新进行映射。
此操作会创建重复行
不要将测试期间生成的行与实际运行生成的行混淆。如果仍然存在重复项,请存储电子邮件标识符,并在创建新记录之前检查其是否存在。
连接已停止。
授权可能会被撤销或过期。打开受影响的连接,重新验证帐户,然后重复步骤测试。
该流程使用的是旧配置。
您可能编辑过草稿但未发布。请查看版本历史记录,确认哪个版本显示为已发布。
触发器需要一段时间才能检测到电子邮件。
定时触发器会定期检查应用程序,并非总是即时生效。请等待下一个时间间隔,并检查消息是否包含所选标签。
一旦你理解了这个流程,你就可以在不改变核心逻辑的情况下,用其他工具替换 Gmail 和 Google Sheets。选择触发器,生成示例,添加操作,映射数据,测试每个步骤,然后发布最终版本。
Activepieces 还允许您创建包含 Webhook、循环、条件和 HTTP 调用的流程,但最好从小规模、可观察的自动化流程入手。这样,您可以在连接关键系统或处理敏感信息之前,轻松识别每个错误发生的位置。
如果您仍在比较不同平台,可以查看 n8n 是什么?如何在不失去控制的情况下自动化任务?对于仅限本地的任务,也有以下选项: 在 Windows 11 中自动执行重复性流程.
指数