Agent-Skills.md

Agent Skills: Telegram Inbound Agent - Manual Run

Automatic inbound Telegram message processing

UncategorizedID: aaaaqwq/claude-code-skills/telegram-inbound-run

Repository

aaaaqwq/claude-code-skills
aAAaqwqLicense: MIT
7317

Install this agent skill to your local

pnpm dlx add-skill https://github.com/aAAaqwq/AGI-Super-Team/tree/HEAD/skills/telegram-inbound-run

Skill Files

Browse the full folder contents for telegram-inbound-run.

Download Skill

Loading file tree…

skills/telegram-inbound-run/SKILL.md

Skill Metadata

Name
telegram-inbound-run
Description
Automatic inbound Telegram message processing

Telegram Inbound Agent - Manual Run

Skill for manually triggering Telegram Inbound Reply Monitor Agent

When to use

  • "check Telegram for replies"
  • "run Telegram inbound agent"
  • "see if anyone replied on Telegram"
  • "check Telegram replies"

What it does

Agent:

  1. Extracts messages from Telegram (last 24 hours)
  2. Filters contacts that we messaged (outbound)
  3. Classifies replies via Claude Haiku (POSITIVE/NEGATIVE/QUESTION/etc)
  4. Logs activity in CRM
  5. Updates lead statuses
  6. Sends notification to Saved Messages
  7. Creates git commit

How to run

Dry run (no CRM changes)

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

Full run

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

Notification test

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

Without AI (rule-based classification)

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

Larger time window

# 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

Output

Stdout (summary)

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

5 new replies (3 positive, 1 questions)

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

Files

  • Summary: $AGENTS_PATH/logs/telegram-inbound-{date}.md
  • Run log: $AGENTS_PATH/logs/telegram_agent_log.json
  • Errors: $AGENTS_PATH/logs/errors/telegram-inbound-{date}.log

CRM updates

  • Activities: added to sales/crm/activities.csv
  • Leads: updated statuses in sales/crm/relationships/leads.csv
  • Git commit: auto-commit with change description

Flags

| Flag | Description | |------|-------------| | --dry-run | Classification only, no CRM updates or notifications | | --no-ai | Rule-based classification (without Claude) | | --since <duration> | Time window: 24h, 48h, 7d, 14d | | --notify-test | Test Telegram notification |

Scheduled Runs

Agent runs automatically 3 times a day:

  • 09:00 - morning check
  • 13:00 - midday check
  • 17:00 - evening check

Via launchd: com.yourcompany.telegram-inbound

Troubleshooting

"No actionable contacts found"

# Check activities.csv for outbound Telegram
grep telegram $CRM_PATH/activities.csv | grep outbound

# Check people.csv for telegram usernames
grep telegram_username $CRM_PATH/contacts/people.csv

"Telegram authorization failed"

# Re-auth
cd $TG_TOOLS_PATH
python3 tools/tg_auth.py

View recent summary

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

Related skills

  • telegram-send - sending outbound messages
  • change-review - review CRM changes before commit
  • update-lead - manual CRM update
  • log-activity - manual activity logging