ساخته‌شده برای توسعه محصول

رابط برنامه‌نویسی واحد برای چند پیام‌رسان

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

مرجع API آزمایشگاه API زنده ساخت کلید

بلوک‌های فنی

از نمونه اولیه تا سرویس پایدار

REST API

عملیات مشترک پیام، چت و فایل از یک مبدا با کلید API در مسیر درخواست؛ بدون توکن جدا برای هر پلتفرم.

وب‌هوک + Long-poll

پیام‌های ورودی با امضای HMAC به endpoint شما می‌رسد؛ retry، deduplication و long-poll تا ۹۰ ثانیه برای تحویل مطمئن.

اتصال از طرف کاربر

برای پلتفرم‌های حساب‌محور، ورود با کد اتصال یا OTP در جریان کنترل‌شده؛ برای ربات‌ها توکن همان پلتفرم.

کلیدهای محدود

برای هر محیط کلید جدا با scope دقیق بسازید؛ کلیدها در مرورگر یا مخزن کد قرار نمی‌گیرند و همیشه قابل ابطال‌اند.

MCP Server

ابزارهای پیام‌رسانی را به Claude، Cursor و کلاینت‌های MCP بدهید؛ با PAT محدود و audit trail کامل.

لاگ و عیب‌یابی

هر فراخوانی با ورودی، خروجی، latency و کد وضعیت در پنل ثبت می‌شود؛ بدون ذخیره غیرضروری متن پیام.

شروع سریع

اولین پیام در کمتر از یک دقیقه

فقط base_url را روی https://api.uniom.ir/bot بگذارید و توکن را با کلید API خودتان جایگزین کنید.

curl -X POST "https://api.uniom.ir/bot<API_KEY>/sendMessage" \
  -H "Content-Type: application/json" \
  -d '{"chat_id": "@my_channel", "text": "سلام از یونیوم!"}'

import requests

payload = {
    "chat_id": "@my_channel",
    "text": "سلام!"
}

response = requests.post(
    "https://api.uniom.ir/botAPI_KEY/sendMessage",
    json=payload,
)

print(response.json())

POST /bot{API_KEY}/sendMessage HTTP/1.1
Host: api.uniom.ir
Content-Type: application/json

{"chat_id": "@my_channel", "text": "سلام از یونیوم!"}

این متد را در آزمایشگاه API تست کنید ←

مرجع فوری

متدهای پرکاربرد

متد	کاربرد	نوع
/getMe	وضعیت اتصال و اطلاعات فضای کاری	GET
/sendMessage	ارسال متن به چت، کانال یا گروه	POST
/sendPhoto · /sendVideo · /sendFile	ارسال مدیا و فایل از URL یا آپلود	POST
/sendMediaGroup	ارسال آلبوم چندتایی	POST
/getUpdates	دریافت رویدادها با long-poll	GET
/setWebhook · /deleteWebhook	تنظیم یا حذف وب‌هوک + آدرس پینگ	POST
/editMessageText · /deleteMessage	ویرایش و حذف پیام ارسال‌شده	POST

فهرست کامل متدها و پارامترها در مرجع API است. قابلیت هر پلتفرم در صفحه همان پیام‌رسان شفاف ذکر شده است.

وب‌هوک به شیوه‌ی یونیوم

رویدادها در قالب Update استاندارد با امضای HMAC به endpoint شما تحویل می‌شود. پاسخ ۲۰۰ سریع، تحویل مجدد برای خطاها و کلید deduplication برای جلوگیری از پردازش تکراری — همه در سمت یونیوم مدیریت می‌شود.

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

اتصال امن

کلید محدود، دسترسی حداقلی

Scope دقیق

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

جداسازی محیط

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

لاگ بدون راز

مقادیر حساس مثل کلیدها و هدرهای Authorization از لاگ حذف می‌شوند؛ حسابرسی بدون درز داده.

اولین کلید را در داشبورد بسازید

اتصال را اضافه کنید، کلید توسعه بسازید و اولین درخواست را در Playground بفرستید.

ورود به داشبورد