telegram-assistant

name	Telegram Assistant
description	ส่งข้อความแจ้งเตือน รายงาน และอัปเดตสถานะงานผ่าน Telegram
version	1.0.0
author	L.I.N.K.
tags	["communication","telegram","notification","automation"]

Telegram Assistant Skill

ความสามารถในการเชื่อมต่อและสื่อสารผ่าน Telegram เพื่อให้คุณไม่พลาดทุกความเคลื่อนไหวของ AI Agent

ความสามารถหลัก

1. ส่งข้อความแจ้งเตือน (Send Notifications): ส่งข้อความด่วนเมื่อ AI ทำงานที่ได้รับมอบหมายเสร็จสิ้น
2. ส่งรายงาน (Send Reports): ส่งไฟล์สรุปการวิเคราะห์หรือรายงาน Markdown เข้าแชทโดยตรง
3. ตรวจสอบสถานะ (Status Updates): อัปเดตความคืบหน้าของ Task ยาวๆ (เช่น การทำ Research) ผ่านมือถือ

วิธีการใช้งาน

บอกให้ L.I.N.K. ส่งข้อมูลผ่าน Telegram เช่น:

• "ส่งสรุปผลการวิเคราะห์นี้เข้า Telegram ให้หน่อย"
• "ถ้าทำ Research เรื่องราคาก่อสร้างเสร็จแล้ว ช่วยเตือนใน Telegram ด้วย"
• "ส่งไฟล์ PDF รายงานล่าสุดเข้า Telegram"

การตั้งค่า (Configuration)

สกิลนี้ต้องการ Environment Variables ต่อไปนี้ในไฟล์ .env:

• TELEGRAM_BOT_TOKEN: โทเค็นที่ได้จาก @BotFather
• TELEGRAM_CHAT_ID: ไอดีของแชทที่ต้องการรับข้อมูล

ขั้นตอนการติดตั้งสำหรับ AI (AI Setup Procedure)

หากตรวจพบว่ายังไม่มีการตั้งค่า Telegram ให้ทำตามขั้นตอนดังนี้:

1. ขอ Bot Token: แนะนำให้ผู้ใช้ไปที่ @BotFather พิมพ์ /newbot และนำ Token มาส่งให้คุณ
2. ขอ Chat ID: แนะนำให้ผู้ใช้ไปที่ @userinfobot และนำ ID มาส่งให้คุณ
3. บันทึกข้อมูล: เมื่อได้รับข้อมูลครบแล้ว ให้ใช้เครื่องมือ configure_system(action='set', key='telegram_bot_token', value='...') และ telegram_chat_id เพื่อบันทึกลงไฟล์ .env
4. ทดสอบ: หลังจากบันทึกแล้ว ให้ลองส่งข้อความทดสอบเข้า Telegram ทันทีเพื่อยืนยันการเชื่อมต่อ

ตัวอย่างคำสั่งภายใน

L.I.N.K. จะใช้สคริปต์ backend/src/telegram_utils.py ในการประมวลผลการส่งข้อมูล