telegram-inbound-run

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