چطور یک ربات خبر تلگرام با khapi بسازیم
آموزش عملی ساخت ربات خبر تلگرام با API فعلی khapi؛ دریافت امن خبر، جلوگیری از ارسال تکراری و انتشار در کانال با Telegram Bot API.
معماری ربات
ربات از دو API مستقل استفاده میکند: khapi برای دریافت خبر و Telegram Bot API برای ارسال پیام. کلید khapi و توکن تلگرام باید فقط روی سرور نگهداری شوند.
جریان کار پیشنهادی:
۱. هر چند دقیقه آخرین خبرها از khapi دریافت شوند.
۲. شناسه خبرهای ارسالشده بررسی شود.
۳. پیام کوتاه شامل عنوان، منبع و لینک ساخته شود.
۴. پیام به کانال ارسال و شناسه خبر ثبت شود.
پیشنیازها
- ساخت ربات با BotFather
- افزودن ربات به کانال بهعنوان مدیر
- دریافت شناسه کانال مانند `@channel_name`
- ساخت کلید API در پنل khapi
- نصب کتابخانه requests
pip install requests
تنظیم متغیرهای محیطی
export KHAPI_API_KEY="your_khapi_key"
export TELEGRAM_BOT_TOKEN="your_bot_token"
export TELEGRAM_CHANNEL="@your_channel"
توکنها را داخل کد، تصویر آموزشی یا مخزن عمومی قرار ندهید.
نمونه کامل Python
import json
import os
from pathlib import Path
import requests
KHAPI_URL = "https://khapi.ir/api/v1/news"
API_KEY = os.environ["KHAPI_API_KEY"]
BOT_TOKEN = os.environ["TELEGRAM_BOT_TOKEN"]
CHANNEL = os.environ["TELEGRAM_CHANNEL"]
STATE_FILE = Path("sent-news.json")
def load_sent_ids():
if not STATE_FILE.exists():
return set()
return set(json.loads(STATE_FILE.read_text(encoding="utf-8")))
def save_sent_ids(values):
recent = list(values)[-1000:]
STATE_FILE.write_text(
json.dumps(recent, ensure_ascii=False),
encoding="utf-8",
)
def fetch_news():
response = requests.get(
KHAPI_URL,
headers={"x-api-key": API_KEY},
params={
"q": "فناوری",
"sort_by": "published_at",
"page": 1,
"page_size": 10,
},
timeout=20,
)
response.raise_for_status()
return response.json().get("articles", [])
def send_to_telegram(article):
text = (
f"{article.get(\"title\", \"خبر جدید\")}\n\n"
f"منبع: {article.get(\"source\", \"نامشخص\")}\n"
f"{article.get(\"url\", \"\")}"
)
response = requests.post(
f"https://api.telegram.org/bot{BOT_TOKEN}/sendMessage",
json={
"chat_id": CHANNEL,
"text": text,
"disable_web_page_preview": False,
},
timeout=20,
)
response.raise_for_status()
sent_ids = load_sent_ids()
for article in reversed(fetch_news()):
article_id = str(article.get("id"))
if not article_id or article_id in sent_ids:
continue
send_to_telegram(article)
sent_ids.add(article_id)
save_sent_ids(sent_ids)
جلوگیری از تکرار
فایل JSON برای نمونه ساده مناسب است. در سرویس واقعی بهتر است شناسه خبر، زمان ارسال و شناسه پیام تلگرام در SQLite، PostgreSQL یا Redis ذخیره شود.
شناسه را فقط پس از پاسخ موفق تلگرام ثبت کنید. اگر ارسال شکست خورد، خبر باید در اجرای بعدی دوباره امتحان شود.
زمانبندی
در Linux میتوانید اسکریپت را با Cron هر پنج دقیقه اجرا کنید:
*/5 * * * * /path/to/venv/bin/python /path/to/news_bot.py
برای اجرای پایدارتر، یک سرویس systemd یا صف وظیفه مانند Celery امکان ثبت خطا، retry و مانیتورینگ بهتری فراهم میکند.
مدیریت خطا
- برای پاسخ ۴۲۹ از khapi یا تلگرام retry با تأخیر تصاعدی در نظر بگیرید.
- متن پیام را از محدودیت طول تلگرام کوتاهتر نگه دارید.
- timeout شبکه تعیین کنید.
- خطا را بدون چاپ توکنها ثبت کنید.
- اگر لینک خبر خالی است، پیام ناقص را ارسال نکنید.
توسعههای بعدی
میتوانید فیلتر منبع و دسته، چند کانال، قالب پیام متفاوت، خلاصه خبر و گزارش روزانه را به همین معماری اضافه کنید.
جمعبندی
نسخه قابل اتکای ربات باید سه ویژگی داشته باشد: استفاده از endpoint فعلی `/api/v1/news`، نگهداری امن کلیدها و ثبت شناسه خبرهای ارسالشده. با این سه اصل، اجرای زمانبندیشده باعث ارسال تکراری یا افشای کلید نخواهد شد.
این مطلب چطور به کار شما بیاید؟
مفاهیم این مقاله را مستقیم در پنل khapi امتحان کنید:
آماده شروع هستید؟
۳ روز استفادهٔ رایگان از پنل تحلیلگر، مطابق محدودیتهای دورهٔ آزمایشی و بدون نیاز به کارت بانکی.