Telegram Bot API

وب‌سرویس Telegram Bot API با یونیوم

فعال

این صفحه مخصوص ربات رسمی تلگرام است: توکن BotFather را به یونیوم وصل می‌کنید، بدون OTP و بدون سشن حساب کاربری. درخواست‌ها از مسیر سازگار Bot API اجرا می‌شوند و وب‌هوک، getUpdates، فایل و لاگ‌ها در پنل یونیوم یکپارچه می‌مانند.

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

قابلیت‌ها

با Telegram Bot API یونیوم چه می‌توانید بکنید؟

اتصال با BotFather

توکن ربات تلگرام را وارد می‌کنید و یونیوم همان ساختار شناخته‌شده Telegram Bot API را با مدیریت مرکزی کلیدها و لاگ‌ها ارائه می‌دهد.

پیام، مدیا و فایل

متدهای رایج مثل sendMessage، sendPhoto، sendDocument و getFile از مسیر API یونیوم قابل استفاده هستند.

وبهوک و getUpdates

آپدیت‌های ربات از مسیر webhook یا polling در یونیوم مدیریت می‌شوند و با بقیه پلتفرم‌ها یکپارچه می‌مانند.

Callback و Bot Contract

callback_query، reply markup و پاسخ‌های سازگار با Bot API برای ابزارها و کلاینت‌های موجود حفظ می‌شوند.

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

تلگرام مستقیم یا از یونیوم؟

Account API یونیوم

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

اتصال مستقیم به Bot API تلگرام

نیاز به پروکسی یا سرور خارج از ایران برای دسترسی
مدیریت وب‌هوک و آپدیت‌ها دستی
بدون لاگ متمرکز و داشبورد
نظارت و نگه‌داری جدا از بقیه پیام‌رسان‌ها

معیار تصمیم

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

شروع سریع

cURL

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

n8n

Credential: Telegram API
Access Token: TELEGRAM_BOT_API_KEY (کلید یونیوم متصل به BotFather token)
Base URL: https://api.uniom.ir/bot

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

پنل ← حساب‌های پیام‌رسان ← Telegram Bot API ← وارد کردن توکن BotFather. این مسیر از Telegram Account API جداست.

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