2026 年 Zapier 的 Twitter 集成

#Zapier 还有 Twitter 集成吗？

截至 2026 年 11 月 2 日，Zapier 没有 Twitter 或 X 应用。旧应用页面的地址 zapier.com/apps/twitter 会跳转到一份简短的 FAQ，其中说该集成“has stopped working (effective August 31, 2023)”（自 2023 年 8 月 31 日起已停止工作），而且 Zapier 的应用目录里也没有 Twitter 或 X 应用。

2023 年的关停分三步进行，全部写在 Zapier 的下线通知（在新标签页打开）里：8 月 18 日起不能再新建 Twitter Zap，8 月 31 日现有 Zap 停止运行，9 月 30 日结束只读访问。当时 Twitter 刚把它的 API 改成了付费档位。

2026 年又添了一个曲折，至今仍在搞乱搜索结果和 AI 的回答。2026 年 2 月 16 日，Zapier 在一个标题为 "X (Twitter) integration is back on Zapier"（X（Twitter）集成回归 Zapier）的地址下发布了一篇帮助文章。2026 年 5 月 29 日，同一篇文章被改写成了 2023 年的下线通知，旧地址现在会跳转到它。一些指南和助手仍在描述一个需要你自己 X 开发者应用的重新上线的 X 应用。Zapier 的目录里如今并没有这样的应用。

用什么来替代取决于任务。发帖要通过自带 X 连接的社交媒体工具，这也是 Zapier 的 FAQ 给出的建议。读取 X 数据（新帖子、提及、某个账号的时间线、粉丝）则通过 X 数据 API，由 Zap 按计划调用。本指南后面只讲读取。

#用 Sorsa API 在 Zap 里读取 X 数据

Sorsa API 是读取公开数据的 Twitter（X）API 与爬虫，它能给 Zap 提供旧应用有过的触发器：Zapier 每隔几分钟向它请求新帖子，并对每条没见过的帖子运行一次 Zap。这套设置用的是 API by Zapier，也就是 Zapier 用来调用任意 API 的较新应用，因为它把你的密钥保存在连接里，而不是 Zap 的字段里。API by Zapier 还处于测试阶段，需要 Zapier 的付费套餐。

1. 获取密钥。 注册 Sorsa API，并在控制台复制密钥。整个过程不涉及 X 账号或开发者应用。

2. 先在 Zapier 外测试请求。 一次调用就能让你看到 Zap 将收到的响应。把账号名换成你自己的。

   curl -X POST "https://api.sorsa.io/v3/mentions" \
     -H "ApiKey: YOUR_API_KEY" \
     -H "Content-Type: application/json" \
     -d '{"query": "northwind_analytics_hq", "order": "latest"}'
   

   {
     "tweets": [
       {
         "id": "1985321047765123072",
         "full_text": "@northwind_analytics_hq love the new export",
         "created_at": "2026-11-02T09:14:07Z",
         "lang": "en",
         "likes_count": 12,
         "reply_count": 2,
         "retweet_count": 1,
         "view_count": 1840,
         "is_reply": false,
         "user": {
           "id": "1622870015463309312",
           "username": "harbor_lane_studio",
           "display_name": "Harbor Lane Studio",
           "followers_count": 4210,
           "verified": false
         }
       }
     ],
     "next_cursor": "DAACCgACG6uP2K4AJxAK"
   }
   

   显示完整响应

3. 添加连接。 在 Zapier 里打开 Apps，点击 Add connection，选择 API by Zapier。选择 Static Headers (API key)，输入一行请求头 ApiKey: YOUR_API_KEY，并把域名过滤设为 api.sorsa.io。测试地址用 https://api.sorsa.io/v3/key-usage-info 就很合适：它会返回你的余额，而且不消耗请求。

4. 创建触发器。 新建一个 Zap，选择 API by Zapier 和 New Item from API 事件。把 Method 设为 POST，URL 设为 https://api.sorsa.io/v3/mentions，Body 设为第 2 步里的 JSON。

5. 告诉 Zapier 帖子在哪里。 在 Response filter 里填 .tweets，在 Dedupe Key 里填 .id。每条帖子都有唯一的字符串 ID，所以 Zap 对每条新帖子只运行一次，已经见过的帖子永远不会再触发。

6. 测试并映射。 测试会加载最新的三条帖子。把 full_text、created_at、作者的 username 和 id 映射到 Slack、Gmail 或表格里；帖子链接的格式是 x.com/ 加用户名，再加 /status/ 和 ID。

7. 启用 Zap。 从现在起，Zap 会按你套餐的轮询间隔检查新帖子。它不会为你启用之前发出的帖子触发。

同样的五个字段适用于所有读取任务。变的只有 URL 和请求体，下一节会说明。

#旧的 Zapier Twitter 触发器及重建方法

旧的 Zapier Twitter 应用里的每个读取触发器，都可以重建为基于 Sorsa API 某个接口的 New Item from API 触发器。写入 X 的操作（发帖、点赞、转发、关注）则不行：Sorsa API 从产品设计上就是只读，所以你的 X 账号永远不会有风险，发帖仍交给官方 X API。

• 账号的新提及

  Sorsa API 请求

  POST /mentions

  请求体或查询参数

  {"query": "your_handle", "order": "latest"}

  Response filter、Dedupe Key

  .tweets、.id

• 某用户的新帖子

  Sorsa API 请求

  POST /user-tweets

  请求体或查询参数

  {"username": "their_handle"}

  Response filter、Dedupe Key

  .tweets、.id

• 匹配搜索的新帖子

  Sorsa API 请求

  POST /search-tweets

  请求体或查询参数

  {"query": "your brand", "order": "latest"}

  Response filter、Dedupe Key

  .tweets、.id

• X 列表中的新帖子

  Sorsa API 请求

  GET /list-tweets

  请求体或查询参数

  查询字符串里的 list_id

  Response filter、Dedupe Key

  .tweets、.id

• 新粉丝

  Sorsa API 请求

  GET /followers

  请求体或查询参数

  查询字符串里的 username

  Response filter、Dedupe Key

  .users、.id

• 查找用户（搜索步骤）

  Sorsa API 请求

  GET /info

  请求体或查询参数

  查询字符串里的 username

  Response filter、Dedupe Key

  一份用户资料，作为操作

• 查找帖子（搜索步骤）

  Sorsa API 请求

  POST /tweet-info

  请求体或查询参数

  {"tweet_link": "post URL or ID"}

  Response filter、Dedupe Key

  一条帖子，作为操作

搜索查询支持 X 自己的运算符，所以一个触发器就能同时监视多件事：from:account_one OR from:account_two、"product name" -filter:retweets，或者 #hashtag min_faves:20。Twitter 搜索运算符指南列出了这些运算符。要监视几十个账号，可以把它们放进一个 X 列表，然后轮询 GET /list-tweets（在新标签页打开）：一次请求就能覆盖最多 5,000 个账号的列表。

参考文档页面展示了每个字段：POST /mentions（在新标签页打开）、POST /user-tweets（在新标签页打开）、POST /search-tweets（在新标签页打开）、GET /followers（在新标签页打开） 和 GET /info（在新标签页打开）。POST /tweet-info 接受帖子链接或单独的 ID。

#Webhooks by Zapier：Retrieve Poll、GET 和 POST

Webhooks by Zapier 也能读取 Sorsa API，只有一个限制：它的轮询触发器 Retrieve Poll 只发送 GET 请求。这让它很适合两个 GET 数据源，即 X 列表和粉丝列表，而不适合搜索和提及，因为那两个是 POST。

• 对 X 列表使用 Retrieve Poll。 URL 为 https://api.sorsa.io/v3/list-tweets?list_id=YOUR_LIST_ID，Key 为 tweets，再加一个名为 ApiKey、值为你的密钥的请求头。Zapier 会自动按 id 字段去重。
• 把 GET 或 POST 用作操作。 在 Schedule by Zapier 触发器（每小时、每天或每周）之后，可以用 POST 操作调用 /search-tweets 生成每日摘要。在任何触发器之后，用 GET 操作调用 /info，可以根据用户名补全联系人信息：粉丝数、简介和所在地。

Zapier 自己的指南指出，Webhooks 把请求头存放在明文的步骤字段里，任何有权访问该 Zap 的人都能读到。在共享工作区里，API by Zapier 的连接是存放密钥更安全的地方。

#Code by Zapier：JavaScript 触发器

Code by Zapier 可以把 JavaScript 或 Python 当作触发器运行，这是唯一一条在 Zapier 免费套餐上也能用的路线。代码用 fetch 调用 Sorsa API，并把帖子以列表形式返回；Zapier 会按 id 对列表去重，和任何轮询触发器一样。

const res = await fetch("https://api.sorsa.io/v3/mentions", {
  method: "POST",
  headers: {
    "ApiKey": "YOUR_API_KEY",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({ query: "northwind_analytics_hq", order: "latest" })
});
if (!res.ok) throw new Error("Sorsa API " + res.status);
const data = await res.json();
output = (data.tweets || []).map(t => ({
  id: t.id,
  text: t.full_text,
  created_at: t.created_at,
  author: t.user.username,
  url: "https://x.com/" + t.user.username + "/status/" + t.id
}));

Zapier 有两个限制需要注意。Code 步骤不能存放机密信息，所以密钥会直接写在代码里，任何有权访问该 Zap 的人都能看到。另外，免费套餐只给 Code 步骤一秒的运行时间，对一次实时调用来说很紧张；Professional 套餐允许 30 秒。返回 403 表示缺少 ApiKey 请求头或请求额度已用完；返回 429 表示一秒内超过了 20 次请求，单个 Zap 永远达不到这个数。

#Zap 多久检查一次 X，要花多少钱

读取 X 数据的 Zap 靠计时器检查：Zapier 免费套餐每 15 分钟一次，Professional 每 2 分钟一次，Team 和 Enterprise 每分钟一次，付费套餐还可以为每个 Zap 设置更长的间隔。Zapier 里不存在针对 X 数据的即时触发器，不论来自 Sorsa API 还是别人，所以新帖子会在一个间隔之内出现。

轮询在 Zapier 里不花钱：Zapier 只在某个操作运行时才计一次任务，也就是每条新帖子一次。在 API 一侧，每次轮询都是一次 Sorsa API 请求，不论有没有发现新帖子。这让轮询间隔成了控制成本的主要杠杆：每 2 分钟轮询一次的 Zap 每月发出 2.16 万次请求，每 15 分钟一次的则是 2,880 次。

按每条帖子算，通过 Sorsa API 读取每 1,000 条推文 $0.07 起，因为每次请求返回约 20 条。官方 X API 每读取一条帖子收费 $0.005（在新标签页打开），也就是每 1,000 条 $5.00，而且第一次调用前就需要带 OAuth 的开发者应用。

有两个习惯能让请求数保持在低位。用 OR 把相关的搜索合并成一个查询，这样一个 Zap 就能顶五个用。再把轮询间隔设成任务真正需要的值：每日报告用不着 2 分钟一次的 Zap，而客服提醒往往需要。

须知

带轮询触发器的 Zap 不会为你启用它之前就已存在的帖子触发，它的测试也只显示最新的三条帖子。要一次性把较早的帖子载入表格，请用一次性导出，之后再让 Zap 从那一刻起添加新帖子。

#Zap 不触发时怎么办

大多数“悄无声息”的 Zap 都出于五个原因之一，Zap 历史记录会告诉你是哪一个。

• 403 "missing key in request header"（请求头里缺少密钥）

  原因

  请求头名称有误或为空

  解决办法

  名称严格写成 ApiKey

• 401 "invalid api key"（API 密钥无效）

  原因

  输入有误或密钥已轮换

  解决办法

  从控制台重新粘贴密钥

• 工作几周后出现 403

  原因

  本月请求额度用完了

  解决办法

  升级套餐，或开启额外请求

• 测试正常，正式运行却从不触发

  原因

  Zap 启用后没有新内容

  解决办法

  发新帖后等一个间隔

• 每次轮询都重复触发同样的帖子

  原因

  Dedupe Key 不是 .id

  解决办法

  把 Dedupe Key 设为 .id

Sorsa API 从不对失败的请求收费，所以配置错误的 Zap 在你排查期间不会花钱。

#搭建你的第一个 X Zap

Zapier 自 2023 年起就没有 Twitter 应用了，现在 Zap 通过轮询 API 来读取 X 数据。Sorsa API 只需要 API by Zapier 连接里的一个请求头就能完成这项工作：每次请求约 20 条推文，每 1,000 条推文 $0.07 起，所有套餐都是每秒 20 次请求。先从一个把提及发送到 Slack 的 Zap 开始，跑通之后再加上搜索或 X 列表。

同样的做法也适用于其他自动化工具：见 n8n 版 Twitter API和 Make 版 Twitter API。要不借助 Zapier 把 X 数据拉进电子表格，请阅读如何把 Twitter 数据导出到 Google Sheets。如果需要一分钟甚至更短的提醒，推特实时监测展示了脚本可以运行的轮询循环。

#常见问题