telegram-inbound-run

用途

Telegram Inbound Run 是一个用于手动触发“Telegram 入站回复监控智能体”的技能，适用于需要检查 Telegram 回复并同步到 CRM 的场景。典型触发说法包括“check Telegram for replies”“run Telegram inbound agent”“see if anyone replied on Telegram”“check Telegram replies”等。

主要能力

该智能体执行以下操作：

从 Telegram 提取最近 24 小时的消息；
过滤出我们主动发过消息（outbound）的联系人；
通过 Claude Haiku 对回复进行分类（POSITIVE/NEGATIVE/QUESTION 等）；
在 CRM 中记录活动；
更新潜在客户状态；
向 Saved Messages 发送通知；
创建 git 提交。

使用方式

提供多种运行命令：

干跑（不修改 CRM）：

cd $AGENTS_PATH/telegram-inbound
python3 telegram_inbound_agent.py --dry-run --since 24h

完整运行：

cd $AGENTS_PATH/telegram-inbound
python3 telegram_inbound_agent.py --since 24h

通知测试：

cd $AGENTS_PATH/telegram-inbound
python3 telegram_inbound_agent.py --notify-test

不使用 AI（基于规则分类）：

cd $AGENTS_PATH/telegram-inbound
python3 telegram_inbound_agent.py --no-ai --since 24h

更大时间窗口：

# Last 48 hours
python3 telegram_inbound_agent.py --since 48h

# Last 7 days
python3 telegram_inbound_agent.py --since 7d

# Last 14 days
python3 telegram_inbound_agent.py --since 14d

参数说明

参数	说明
--dry-run	仅分类，不更新 CRM 或发送通知
--no-ai	基于规则的分类（不使用 Claude）
--since <duration>	时间窗口：24h、48h、7d、14d
--notify-test	测试 Telegram 通知

输出

标准输出（摘要）示例：

📬 Telegram Inbound: 2026-02-12 09:00

5 new replies (3 positive, 1 questions)

✅ POSITIVE (3):
  • John Doe: Interested in labeling service
  ...

生成文件：

摘要：$AGENTS_PATH/logs/telegram-inbound-{date}.md
运行日志：$AGENTS_PATH/logs/telegram_agent_log.json
错误日志：$AGENTS_PATH/logs/errors/telegram-inbound-{date}.log

CRM 更新：

活动：添加到 sales/crm/activities.csv
客户线索：在 sales/crm/relationships/leads.csv 中更新状态
Git 提交：自动提交并附带变更说明

适用场景

适合需要监控 Telegram 回复、并将回复分类结果同步至 CRM 的销售或运营流程。可通过 launchd（com.yourcompany.telegram-inbound）配置每天自动运行三次：09:00 早间检查、13:00 午间检查、17:00 晚间检查。

限制与故障排查

若出现“No actionable contacts found”，可检查 activities.csv 中的 outbound Telegram 记录：

grep telegram $CRM_PATH/activities.csv | grep outbound

以及 people.csv 中的 telegram 用户名：

grep telegram_username $CRM_PATH/contacts/people.csv

若“Telegram authorization failed”，可重新认证：

cd $TG_TOOLS_PATH
python3 tools/tg_auth.py

查看最近摘要：

cat $AGENTS_PATH/logs/telegram-inbound-$(date +%Y-%m-%d).md

技能介绍

用途