SuperAPI AI 工具集
合作ENAI 行业资讯收藏
Skill 广场heyreach

heyreach

营销与增长

查看项目

更新于 10-15 10:27

技能介绍

用途

HeyReach 集成技能用于对接 HeyReach LinkedIn 自动化平台，让用户通过命令行脚本完成 LinkedIn 外联活动的日常管理。当用户提到 heyreach、linkedin outreach、linkedin campaigns、list campaigns、add leads 等关键词时加载本技能。

主要能力

技能覆盖以下操作类别：

  • 活动操作：列出所有活动（list_campaigns.py）、获取活动详情（get_campaign.py）、暂停或恢复活动（toggle_campaign.py）。
  • 线索操作：向活动添加线索（add_leads.py）、获取活动线索（get_leads.py）。
  • 会话操作：获取消息线程（get_conversations.py）。
  • LinkedIn 账号操作：列出已连接账号（list_accounts.py）。
  • 列表操作：列出线索列表（list_lists.py）、创建线索列表（create_list.py）。
  • 分析操作：获取整体分析（get_stats.py）、获取活动指标（get_metrics.py）。

使用方式

首次使用前必须运行配置检查：

python 00-system/skills/heyreach/heyreach-master/scripts/check_heyreach_config.py --json

根据返回的配置状态处理：配置正常则继续操作；需要 API 密钥则提示用户提供并保存到 .env；需要创建 .env 文件则创建并写入密钥；密钥存在但无效则重新验证。

获取 API 密钥的步骤：登录 https://app.heyreach.io，进入 Settings → API（或 Integrations），复制 API 密钥，然后将其写入 .env：

HEYREACH_API_KEY=their-key-here

所有脚本位于 00-system/skills/heyreach/heyreach-master/scripts/ 目录，多数支持 --json 参数。常用命令示例：

  • 列出活动：python list_campaigns.py [--limit N] [--offset N] [--json]
  • 获取活动详情：python get_campaign.py --campaign-id ID [--json]
  • 暂停/恢复活动：python toggle_campaign.py --campaign-id ID --status ACTIVE|PAUSED [--json]
  • 添加线索：python add_leads.py --campaign-id ID --linkedin-urls URL1,URL2 [--json]，或 python add_leads.py --campaign-id ID --leads '[{"linkedInUrl":"..."}]' [--json]
  • 获取活动线索：python get_leads.py --campaign-id ID [--limit N] [--json]
  • 获取会话：python get_conversations.py [--campaign-id ID] [--limit N] [--json]
  • 列出账号：python list_accounts.py [--json]
  • 列出列表：python list_lists.py [--limit N] [--json]
  • 创建列表：python create_list.py --name NAME [--description DESC] [--json]
  • 获取整体统计：python get_stats.py [--json]
  • 获取活动指标：python get_metrics.py --campaign-id ID [--json]

技能内置智能路由表，将用户说法映射到对应脚本和必需参数，例如“list campaigns”对应 list_campaigns.py，“add leads to [campaign]”对应 add_leads.py 并需要 --campaign-id 和 --linkedin-urls。

适用场景

适合需要批量管理 LinkedIn 外联活动的用户，例如查看活动状态与表现、向指定活动导入潜在客户、查看回复会话、管理多个 LinkedIn 账号以及创建线索列表。

限制

使用前必须配置有效的 HeyReach API 密钥。错误处理方面：401 表示 API 密钥无效，需重新设置并获取新密钥；403 表示 API 不可用，需检查订阅；404 表示资源未找到，需核对活动或线索 ID；429 表示触发速率限制，由客户端自动重试。

参考文档

setup-guide.md（完整设置）、api-reference.md（API 文档）、error-handling.md（故障排查）。

版本：1.0，创建于 2025-12-19。