跳到主要内容

用个人 API 密钥连接 Zapier

使用 Zapier 的 Marcomm AI 应用,从新闻稿、博客文章和媒体活动启动 Zap,并创建、发布和发送它们。该应用仅限受邀使用。

  1. 1
    在 Marcomm 中打开设置 → 集成 → Zapier,查看当前状态和所需的值。
    设置、集成、Zapier 页面,显示状态、连接步骤、需勾选的范围和 API 访问状态
    Zapier 页面显示当前状态、步骤、要复制的值,以及此工作区的 API 访问是否已获批。
  2. 2
    打开设置 → API。如果工作区还没有 API 访问权限,由所有者或管理员填写申请 API 访问权限并选择提交申请。
  3. 3
    获批后打开创建密钥,选择个人密钥,勾选所需的范围,然后选择创建密钥。密钥只显示一次,请立即复制。
  4. 4
    打开 Marcomm AI 发来的邀请链接,把 Marcomm AI 应用添加到你的 Zapier 账号。
  5. 5
    创建 Zap,选择 Marcomm AI 作为触发器或操作,Zapier 要求连接时,把密钥粘贴到 API Key(API 密钥)。

发布和发送步骤无法撤销,请先用草稿测试。

该应用尚未进入 Zapier 公开目录,需要 Marcomm AI 的邀请链接。它有七个触发器:New Press Release、Press Release Approval Requested、Press Release Published、New Blog Post、Blog Post Published、New Press Event 和 RSVP Invite Updated。操作可以创建、更新新闻稿、提交审批、发布和发送新闻稿,创建并发布博客文章,创建媒体活动,以及创建 RSVP 邀请函、添加收件人和发送。两个搜索可查找新闻稿或博客文章。

范围决定密钥能做什么。内容(content)读取新闻稿、博客文章和媒体活动,撰写内容(content:write)创建和编辑草稿,发布与发送(distribution)发布并通过邮件发送,审批(approvals)处理审批步骤。后三项只能用于个人密钥,因为操作会记录在创建密钥的人名下。工作区密钥只能读取,每个密钥都按创建者的角色和权限执行。

发布和发送无法撤销。只有请求带有 confirm: true 或 Idempotency-Key 请求头时,API 才会执行;如果仍需审批,或内容已定时发布、处于禁发期,API 不会发布并返回 409。用同一个 Idempotency-Key 重发同一请求时,24 小时内不会再次执行,而是返回第一次的结果。每个写入步骤都会发送由 Zap 和输入值生成的幂等键。如果要在 24 小时内有意重复完全相同的步骤,请在 Repeat Key 中填入每次运行都不同的值。

Team 套餐及以上可以使用 API。Marcomm AI 团队会逐一审核申请,密钥在获批后才能使用。密钥只能包含工作区已获批的范围,每人最多可创建 10 个密钥。默认上限为每个工作区每分钟 60 次、每天 10,000 次,超出后 API 会返回 429 和 Retry-After 请求头。如需提高上限,请使用设置 → API中的需要更高的上限吗?。要断开 Zapier,请选择密钥旁的吊销,使用该密钥的系统会立即失去访问权限。

常见问题

使用 Authorization: Bearer 加密钥的请求头调用 GET https://marcomm.works/api/v1/me。只要密钥已获批,无论范围如何都能使用,并返回工作区、密钥名称和密钥的范围。

密钥不会记录由哪个服务使用,因此 Marcomm 不会把 Zapier 卡片标记为已连接。每个密钥的最后使用时间可在设置 → API中查看。

不可以。Zapier 应用可以提交审批,由审批人在 Marcomm 中决定。通过 API,可以用带有审批范围的个人密钥批准或驳回。

集成