将 FastComments 连接到 Zapier

连接您的账户

1. 在 Zapier 中，向 Zap 添加一个 FastComments 步骤，或在 Zapier 应用目录中打开 FastComments 应用页面。
2. 选择 Sign in to FastComments。Zapier 会先询问您的地区：除非您的账户是在欧盟地区创建的（eu.fastcomments.com），否则请选择 United States。
3. 将打开 FastComments 窗口。如果您尚未登录，请登录。
4. 查看同意页面。页面显示 Zapier 应用、将要连接的账户以及请求的权限（读取和写入）。选择 Approve。
5. Zapier 会存储该连接，并使用您的站点名称和用户名对其进行标记。

该连接使用 OAuth。没有 API 密钥被复制到 Zapier，Zapier 持有的令牌仅对您批准的账户有效。

谁可以连接

批准连接的人员必须是 FastComments 账户的 API 管理员。账户所有者拥有此权限；其他团队成员可以在“用户”页面上被授予此权限。没有此权限的用户会看到“you do not have permission”页面，而不是同意表单。

连接正确的站点

同意页面会连接您当前登录的账户。如果您管理多个账户，请在批准之前从账户切换器中切换到正确的账户，或使用同意页面上的 switch account 链接。Zapier 中的连接标签会显示站点名称，因此错误的选择很容易被发现。

查看和撤销访问

每个连接都会出现在 FastComments 仪表板的 Connected Apps 下，显示其拥有的权限以及上次使用时间。在此撤销后会立即断开 Zapier 的连接；任何使用该连接的 Zap 都会停止，直至重新连接。您也可以在 Zapier 的 My Apps 中删除该连接。

触发器

触发器在 FastComments 中发生某些事件时启动 Zap。所有三种触发器都是即时的：FastComments 会在事件发生的瞬间通过 webhook 将其发送给 Zapier。不会轮询您的账户，也不会消耗 API 积分等待。

每个触发器返回完整的评论信息：id、页面 URL 和 URL ID、评论者姓名和电子邮件、评论文本（Markdown 和 HTML 格式）、投票计数、批准和垃圾标记、语言区域、域名以及任何提及。字段与 Webhooks、Data Structures 中记录的 webhook 负载相匹配。

选项

域名。 每个触发器都有一个可选的域名过滤器，列出您账户中配置的域名。留空则接收所有域名的事件。

包含未批准和垃圾评论。 仅适用于“新评论”触发器。默认情况下，已被置于审核或标记为垃圾的评论会被跳过。当此类评论随后被批准时，“更新的评论”触发器会为其触发，因此需要对每条可见评论作出响应的 Zap 应使用“更新的评论”并在已批准字段上添加过滤器。

交付工作原理

打开 Zap 会在您的账户上创建一个 webhook 订阅，可在 Webhooks 页面中看到，来源为 API。关闭 Zap 会删除该订阅。Zapier 自身的限制适用于每分钟接受的事件数量；FastComments 会重试失败的交付，且延迟逐渐增加，并在订阅连续失败六天后将其禁用。可以在 Webhooks 页面重新启用被禁用的订阅，或简单地关闭再打开 Zap 以创建一个新的订阅。

一个账户最多可拥有 50 个 API 订阅。每个使用 FastComments 触发器的 Zap 占用一个订阅。

操作和搜索

操作在 FastComments 中创建数据；搜索则查找数据，以便后续步骤使用。每个操作都会调用 FastComments REST API，并消耗与您自己的代码调用相同的 API 积分：每次调用消耗 1 积分，除非另有说明。

创建评论

在页面上发布评论。

创建页面

在页面上出现任何评论之前创建页面记录，以便对其进行列出和限制。需要提供 URL ID、标题、URL，并可选地提供允许查看的 SSO 组 ID。

创建 SSO 用户

创建单点登录用户。需要提供您自己的用户 ID、用户名和电子邮件，以及可选的显示名称、显示标签、头像、网站、组 ID、以及通知和隐私标志。无法通过 Zapier 授予管理角色。

创建 Feed 帖子

从 HTML 内容在 FastComments feed 中创建帖子，可选提供标题、作者、标签以及一个链接预览。

创建标签

创建评论者可使用的标签，可选提供其链接的 URL。

标记评论

将评论标记为需要审核。提供执行标记的用户 ID，或留空以使用 Zapier 集成的身份标记。

搜索

搜索未找到结果时不会导致 Zap 失败。可在 Zapier 的 "find or create" 模式下将搜索与创建结合，在页面或用户缺失时自动创建它们。

示例 Zap

只需几分钟即可设置的工作流示例。

获取新评论的通知。 当触发 New Comment 时，使用 Slack 的 “Send Channel Message” 或 Discord 的 “Send Channel Message”。将评论者姓名、评论内容和页面 URL 映射到消息中。添加域过滤器，以便每个站点通知不同的频道。

记录每条评论。 当触发 New Comment 时，使用 Google Sheets 的 “Create Spreadsheet Row”。将 Deleted Comment 作为第二个 Zap，向表格追加一行，包含评论 ID，这样表格即可充当审计日志。

在评论获批时给作者发送邮件。 当触发 Updated Comment 并通过 Zapier 过滤器（Approved 为 true）时，使用 Gmail 的 “Send Email”。由于 Updated Comment 会在每次更改时触发，过滤器确保此 Zap 仅在获批时响应。

将评论者添加到您的 CRM 或邮件列表。 当触发 New Comment 时，使用 HubSpot 的 “Create or Update Contact” 或 Mailchimp 的 “Add or Update Subscriber”，并使用评论者的电子邮件。在将任何人添加到营销列表之前，请遵守您的隐私政策和当地法律。

从表单创建评论。 当触发 Typeform 或 Google Forms 的 “New Response” 时，使用 FastComments 的 Create Comment，并提供您站点用于推荐的页面 URL ID。将 Approved 保持未选中，以便在评论显示前进行审核。

将公告发布到 Feed。 当触发 Zapier 的 RSS “New Item in Feed” 时，使用 Create Feed Post，将条目的标题、内容和链接发布到 Feed。

为成员提供 SSO 用户身份。 使用 Memberstack、Memberful 或您自己的 webhook，然后执行 Find SSO User，随后在 “find or create” 模式下执行 Create SSO User。

升级被举报的评论。 当触发 Updated Comment 并通过过滤器（标记计数大于零）时，使用 Trello 的 “Create Card” 或 Linear 的 “Create Issue”，并附上评论 ID 以及指向审核页面的链接。

在页面上线时发布。 当触发 WordPress 或 Ghost 的 “New Post” 时，使用 Create Page，并提供文章 URL，这样页面将在首条评论出现前即被列出并受限。

归档已删除的评论。 当触发 Deleted Comment 时，使用 Airtable 的 “Create Record”，并保存完整的评论内容以满足合规保留要求。

Troubleshooting

"You do not have permission" 在连接时出现。 已登录的用户不是该账户的 API 管理员。请让账户所有者在 Users 页面授予 API 权限，或以所有者身份连接。

连接标记了错误的站点。 同意页面会连接您当时登录的账户。 在 Zapier 中断开连接，在 FastComments 仪表板切换账户，然后重新连接。

事件停止到达。 在仪表板的 Webhooks 页面检查。 如果订阅的端点连续六天失败，系统会自动禁用并显示原因。 在那里重新启用，或关闭再打开 Zap。 如果订阅完全消失，说明有人删除了它；关闭再打开 Zap 会重新创建。

Zapier 提示需要重新连接账户。 连接可能已在 Connected Apps 页面被撤销，批准连接的用户失去了 API 权限，或账户被删除。 在 Zapier 中重新连接。

操作因 "does not have write access" 失败。 连接时仅批准了只读权限。 重新连接并批准两项权限。

速率限制和配额。 操作和搜索会消耗您计划中的 API 配额，并受与 REST API 相同的速率限制。 触发器不消耗配额。 当 Zap 遇到限制时，Zapier 会在 FastComments 报告的延迟后重试。

Domain 下拉列表为空。 在 FastComments 仪表板的 Domains 页面配置后，域名会出现。 将该字段留空可接收所有域名的事件。