n8n

阅读需 1 分钟

使用经 n8n 验证的 Sofia 节点，你可以在任何一个 n8n 工作流中发布、定时并跟踪你的帖子：只需要一个个人密钥就够了。

Sofia 的 n8n 节点无需写一行代码，就能把你的账号与工作流连接起来：一张表单、一家网店或一份电子表格都可以触发一条帖子，帖子发布或失败后也可以启动另一个工作流。

本页内容

安装方法

1. 打开节点面板。在工作流中点击「+」，搜索「Sofia」。
2. 安装节点。选择 Sofia，然后点击「Install node」。实例所有者安装一次，所有成员即可使用。
3. 或者安装包。在自托管实例上，打开「Settings › Community nodes › Install」，输入包名 n8n-nodes-sofia-post。

1. 创建个人密钥。在设置的「Sofia API」页面，「个人访问」标签页，点击「新建密钥」。它只显示一次。
2. 在 n8n 中创建凭据。添加一个「Sofia API」凭据，把密钥粘贴到「Personal Key」字段（sofia_pk_live_…）。「API URL」保持不变；n8n 会用 GET /v1/me 测试密钥。
3. 在工作流中使用。一个凭据即可访问你所有的门店，权限与你相同。

项目	n8n 中的名称	作用
操作	Sofia › Post › Create	发布、定时或保存草稿，每个所选账号对应一条帖子，媒体通过地址提供
操作	Sofia › Post › Get	读取一条帖子及其在各网络上的状态
触发器	Sofia Trigger › Post Published	帖子在至少一个网络上发布成功时启动工作流
触发器	Sofia Trigger › Post Failed	有网络拒绝帖子时启动工作流，即使其他网络已发布成功

「Establishment」和「Accounts」列表来自你的门店和已连接账号。「Schedule At」留空即立即发布；日期按工作流的时区读取。「Draft」会保存帖子而不发布。字段不一致（带日期的草稿、不完整的媒体地址）会在帖子创建之前就被拒绝。

1. 创建帖子。添加一个「Sofia」节点，选择「Post › Create」，选好门店及其账号，写好文字，然后在「Additional Fields」下添加「Media URLs」和「Schedule At」。
2. 读取状态。再添加一个「Sofia」节点，选择「Post › Get」，把上一步返回的 id 交给它。帖子发出后，它的 status 会是 published、partial 或 failed，并附带各网络的链接和返回结果。
3. 处理失败。用一个「Sofia Trigger」节点选择「Post Failed」来启动另一个工作流，并把它连接到 Slack 或邮件节点，附上下面的消息。

{{ $json.platforms }}: {{ $json.errors }}

触发器会轮询 Sofia。它从工作流激活之后出现的帖子开始：更早的帖子不会重放。「Fetch Test Event」会显示最新的一条帖子，方便你映射字段；选择某个门店后，只监视该门店。

401：密钥已失效，请新建一个密钥并粘贴到同一个凭据中。
429：调用过多；错误信息会说明需要等待多少秒后再重试。
其他拒绝情况：Sofia 的错误及其代码会显示在 n8n 中。启用「Continue On Fail」后，被拒绝的条目会变成一个 error 条目，而不会中断工作流。

如果你的自动化已经在 n8n 里，就用 n8n。如果你的工具能接入 Zapier，优先用 Zapier；需要写代码时，请使用 Webhook 或 Sofia API。

这篇文章有帮助吗？