Telegram Account API

وب‌سرویس / API پیام‌رسان تلگرام

فعال

تلگرام در یونیوم با حساب واقعی و سشن امن شما اجرا می‌شود، اما همان قالب آشنای Bot API را به کلاینت‌ها می‌دهد. بنابراین بدون تغییر در ابزار فعلی، می‌توانید چت، کانال، مدیا و وب‌هوک را از یک پنل واحد مدیریت کنید.

اتصال حساب تلگرام مستندات Telegram امتحان در playground

چطور کار می‌کند

داشبورد، گفتگوها و فایل‌های تلگرام را داخل اپلیکیشن خود ببینید

یونیوم چت، گروه، کانال و فایل‌های تلگرام را از حساب واقعی همگام‌سازی می‌کند و با همان قالب Bot API در اختیار اپلیکیشن شما می‌گذارد — بدون نگه‌داری سشن یا زیرساخت MTProto.

اتصال حساب تلگرام مستندات مدیا

app / inbox

حساب‌های همگام

س

کانال اخبار
Telegram

م

پشتیبانی
Telegram

ص

گروه محصول
Telegram

پلتفرم‌ها

کانال اخبار · همین حالا

س

📢 آپدیت انتشار سرویس — همه پیام‌رسان‌ها پایدارند.

۲ دقیقه پیش

👍 ۱۲❤️ ۸

ی

دریافت شد، ممنون! می‌توانم آن را برای کل اعضای گروه بفرستم؟

همین حالا

م

report-q2.pdf
۲.۴ MB · PDF

۱ ساعت پیش

۱۲گفتگوی باز

۴کانال و گروه

۲۳۴مخاطب

واسط سازگار با Bot API

کلاینت‌های موجود شما بدون تغییر کار می‌کنند، اما پشت صحنه از حساب واقعی تلگرام برای دسترسی به قابلیت‌های گسترده‌تر استفاده می‌شود.

لاگ و آمار یکپارچه

پیام‌های تلگرام در همان پنلی که ایتا و سروش‌پلاس را می‌بینید، قابل جست‌وجو هستند.

یک کلید، چند حساب

یک کلید API یونیوم می‌تواند چند حساب و سناریوی تلگرام را همزمان پوشش دهد، بدون اینکه کلاینت شما تغییر کند.

وب‌هوک پایدار

یونیوم در وسط می‌نشیند و تحویل پایدار و retry را برای شما انجام می‌دهد.

نوع حساب

یک API، هر دو حالت حساب تلگرام

Account API

حساب شخصی تلگرام

حساب واقعی تلگرام با سشن امن؛ گفتگوها، مخاطبین و رسانه‌ها به‌صورت زنده همگام می‌شوند.

گفتگوی یک‌به‌یک (DM)
همگام‌سازی مخاطبین
فایل و رسانه
وب‌هوک زنده

Broadcast

کانال و گروه

مدیریت کانال‌های پرمخاطب و گروه‌ها با ارسال همگانی، پیام عمومی و مدیریت اعضا.

ارسال پستی / کانال
گروه و ادمین
پین و اعلان
آمار نمایش

قابلیت‌های API

متدها و قابلیت‌های تلگرام در یونیوم

پیام‌ها

گروه ۱

sendMessage / reply
sendPhoto / Video / Document
بازخوانی و ویرایش
واکنش‌ها و رسید خواندن

اتصال حساب

گروه ۲

ورود با OTP / QR
getChat / getMe
چرخش و مدیریت سشن
منطقه و توکن

فایل و مدیا

گروه ۳

getFile / دانلود
آپلود multipart
کپشن و آلبوم
صدا و ویدیو

آپدیت و وب‌هوک

گروه ۴

getUpdates (polling)
setWebhook / بهاین‌صورت
رویدادهای حساب
صفحه و وضعیت

انتخاب نوع اتصال

Account API یونیوم یا زیرساخت شخصی؟

Account API یونیوم

بدون سرور شخصی و نگه‌داری سشن
متدهای استاندارد تلگرام با قالب واحد
وب‌هوک و صف آپدیت پایدار
لاگ، اعلان و پنل مدیریتی

سرور شخصی / MTProto

نگه‌داری مداوم و ریسک محدود شدن حساب
مدیریت سشن و کلاینت‌های متعدد
خطاگیری بدون ابزار متمرکز
بدون پشتیبانی و مستندات فارسی

معیار تصمیم

برای یک‌پارچگی با بقیه پیام‌رسان‌ها و کاهش نگه‌داری، Account API یونیوم مسیر کوتاه‌تری است؛ زیرساخت شخصی فقط برای نیازهای خاص سزاوار بررسی است.

شروع سریع

cURL

curl -X POST "https://api.uniom.ir/bot<TELEGRAM_API_KEY>/sendMessage" \
  -H "Content-Type: application/json" \
  -d '{"chat_id": "@your_channel", "text": "سلام از تلگرام!"}'

n8n

Credential: Telegram API
Access Token: TELEGRAM_API_KEY (از یونیوم)
Base URL: https://api.uniom.ir/bot

اتصال بات تلگرام

پنل ← حساب‌های پیام‌رسان ← تلگرام ← افزودن توکن بات. تمام شد.

رفتن به پنل سایر پیام‌رسان‌ها

سؤالات

پرسش‌های پرتکرار API تلگرام

یونیوم با Bot API تلگرام چه فرقی دارد؟

قالب متدها همان Telegram Bot API است، اما پشت صحنه از حساب واقعی تلگرام استفاده می‌شود تا به قابلیت‌های کامل‌تری مثل گفتگوی شخصی، کانال و گروه دسترسی داشته باشید. کلاینت موجود شما بدون تغییر کار می‌کند.

آیا برای اتصال به تلگرام به سرور شخصی نیاز دارم؟

خیر. سشن و زیرساخت MTProto توسط یونیوم نگه‌داری می‌شود؛ شما فقط یک کلید API می‌گیرید و با همان قالب Bot API درخواست می‌فرستید.

آیا می‌توانم فایل و رسانه ارسال و دریافت کنم؟

بله. آپلود multipart، دانلود با getFile، ارسال تصویر/ویدیو/سند و کپشن و آلبوم همگی پشتیبانی می‌شوند.

آپدیت‌ها چگونه دریافت می‌شوند؟

می‌توانید از long polling با getUpdates یا وب‌هوک پایدار با setWebhook استفاده کنید؛ یونیوم ارسال امن و retry را مدیریت می‌کند.