Telegram 线索搜索机器人，线索存进 Google 表格

Telegram 线索搜索机器人，线索存进 Google 表格

一个在 Telegram 机器人背后运行的 n8n 工作流。你用平常的话给机器人发一个职位和一个州。模型把这两样取出来，一个 Apify Actor 搜索符合的人，工作流每隔几分钟查看一次搜索。搜索结束后，有邮箱的线索被加进一张 Google 表格，机器人回复存了多少条。

在这之上搭东西之前，先读下面的“这个 Actor 已经变了”：文件里写的 Actor 现在接收的是另一种输入。

包里有什么

• workflow.json：n8n 导出的工作流，十九个节点，没有便签。里面没有任何凭据。
• README.md：这份设置说明，压缩包里的是英文版。

我们相对原来的副本改了什么

• runActor 和 getDatasetItems 里的 Apify 请求头放的是一个占位符 Bearer <token>。现在写的是 Bearer <YOUR_APIFY_TOKEN>。
• 作者的表格和标签页 ID 都已删掉。Google Sheets 改为要 YOUR_SHEET_ID，并按名称 Leads 找标签页。

开始之前

• 一个 Telegram 能通过 HTTPS 访问到的 n8n 实例。n8n Cloud 可以，你自己的服务器则需要一个公网地址。
• 一个 Telegram 机器人和它的令牌，从 BotFather 获取。
• 一个能用 gpt-4.1-mini 的 OpenAI API 密钥。
• 一个 Apify 账号和它的 API 令牌，还要有额度，外加一个接收职位和州的线索搜索 Actor（见下文）。
• 一个 Google 账号，以及一张放线索的 Google 表格。

这个 Actor 已经变了

runActor 带着一个职位、一个州和几项邮箱设置启动 Actor GlxYrQp6f3YAzH2W2。2026 年 11 月 2 日，Apify 上这个 ID 的页面把它叫作 Email & Phone Finder，来自 peakydev 账号。它的输入页面只列出一个字段：一个列出人员的 CSV 或 Excel 文件。它的价格记录说这个 Actor 正在变成 LinkedIn 个人资料抓取工具。这个机器人发出的搜索已经对不上它了。

要换的话，挑一个按职位和州搜索人员的 Actor。比如 boneswill 账号下的 Leads Finder Actor，它的输入页面列出了 personTitle 和 personState。然后：

1. 把新 Actor 的 ID 填进 runActor 的地址，按它的输入页面写请求体。
2. 把 getRun 的地址改成 https://api.apify.com/v2/actor-runs/{{ $('runActor').item.json.data.id }}，这个地址对任何 Actor 都适用。
3. 跑一次搜索，让 setValues 对上新 Actor 返回的字段。也检查一下 If（见“一次运行的过程”第 6 步）。

设置

1. 在 n8n 里新建一个工作流，打开它的菜单，选 Import from File，选中 workflow.json。
2. 建一张 Google 表格，里面有一个名为 Leads 的标签页，第 1 行写这些表头：personName、title、email、linkedIn、person_location 和 organization_website。复制表格的 ID：地址里 /d/ 和 /edit 之间那一长串。
3. 用你机器人的令牌添加 Telegram 凭据。在 Telegram Trigger 和三个发消息的节点里选中它。
4. 添加 OpenAI 凭据，在 OpenAI Chat Model 里选中它。
5. 添加 Google Sheets OAuth2 凭据。在 Google Sheets 里选中它，把 YOUR_SHEET_ID 换成这个 ID。
6. 按上面的说明替换 Actor。在 runActor 和 getDatasetItems 里，把 Authorization 请求头里的 <YOUR_APIFY_TOKEN> 换成你的令牌。尖括号也要删掉，请求头写成 Bearer、一个空格，再加令牌。getRun 在文件里没有这个请求头，也给它加上同样的。
7. 如果不想让别人用这个机器人，在 Telegram Trigger 后面加一个 If 节点，只放行你自己的用户 ID，也就是 {{ $json.message.from.id }}。触发器自带的 Restrict to User IDs 选项会显示在这个节点里，但 n8n 的代码从节点 1.2 版才应用它，而这个是 1.1 版。
8. 保存，按 Publish。然后给机器人发一条消息，比如“marketing directors in Texas”。

一次运行的过程

1. 机器人每收到一条消息，Telegram Trigger 就启动一次运行。
2. Query Fixer 让 gpt-4.1-mini 取出两个字段：jobTitle，以及消息里写了州时的 personState。它的提示词要求两者都写成标准形式。
3. runActor 用这个职位和州启动 Actor，只要已验证的邮箱，跳过没有邮箱的线索，最多 1000 条结果。它不等搜索完成。
4. Wait 暂停两分钟，然后 getRun 向 Apify 询问这次运行的状态。Switch 把 FAILED 送到 Send a failed message，把 SUCCEEDED 送到 getDatasetItems，把 RUNNING 送到 Wait1，它暂停三分钟后再问一次。
5. getDatasetItems 取回结果，Aggregate 把它们收进一个叫 data 的列表。
6. If 检查列表里第二个条目有没有 id。有的话，工作流就把结果当作出错通知，Send a error message 回复那个条目 fullName 里的第一句话。这个检查符合工作流做出来时这个 Actor 的结果格式。
7. 否则 Split Out 把列表拆回每条线索一个条目。setValues 保留六个字段，把城市、州和国家合成 person_location。接着 Filter 去掉没有邮箱的线索，Remove Duplicates 去掉重复的邮箱。
8. Google Sheets 把每条线索追加为一行，Send a success message 回复一次，写明行数、职位和地点。

改变回复

• 三条消息：Send a success message、Send a failed message 和 Send a error message 的文字。成功消息结尾感谢用户使用 LeadGenBot，把你机器人的名字放在那里。
• 等待：Wait 在第一次查看之前，Wait1 在两次查看之间。
• 搜索：runActor 的请求体，以及 Query Fixer 取出的两个字段。

注意事项

• 任何找到你机器人的人都能发起搜索，花你的 Apify 和 OpenAI 额度。设置第 7 步可以堵住这一点。
• Switch 只为三种状态设了路线。第一次查看时还在排队的运行，或者超时、被中止的运行，会让工作流直接结束，不回复。
• 提取器读的是州，不是城市或国家。没写州的消息会给 Actor 发一个空的州。
• Remove Duplicates 只比较一次搜索里的线索，所以第二次搜索可能把表格里已有的人再加一遍。
• 成功消息报告的是这次运行存下的行数，也就是去掉没有邮箱的线索之后的数。
• 每条消息都会发给 OpenAI，职位和州会发给 Apify。表格里存着姓名、邮箱和 LinkedIn 地址。给任何人写信之前，先查清你和对方所在地关于联系他人的规定。
• Apify 令牌写在请求头里，分享工作流之前要删掉。