SoroushPlus Account API

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

فعال

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

اتصال حساب سروش‌پلاس مستندات سروش‌پلاس امتحان در playground

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

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

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

اتصال حساب سروش‌پلاس مستندات

app / inbox

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

s

پشتیبانی
SoroushPlus

s

کانال
SoroushPlus

s

گروه محصول
SoroushPlus

پلتفرم‌ها

پشتیبانی · سروش‌پلاس · همین حالا

س

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

۲ دقیقه پیش

👍 ۱۲❤️ ۸

ی

دریافت شد، ممنون!

همین حالا

س

report.pdf
۲.۴ MB

۱ ساعت پیش

۱۲گفتگوی باز

۴کانال و گروه

۲۳۴مخاطب

نوع حساب

یک API، هر دو حالت سروش‌پلاس

Account API

حساب شخصی سروش‌پلاس

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

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

Channel

کانال و اطلاع‌رسانی

مدیریت کانال و گروه با ارسال همگانی و پیام عمومی.

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

قابلیت‌های API

متدها و قابلیت‌های سروش‌پلاس در یونیوم

پیام‌ها

گروه 1

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

اتصال حساب

گروه 2

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

فایل و مدیا

گروه 3

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

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

گروه 4

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

سؤالات

پرسش‌های پرتکرار سروش‌پلاس

یونیوم با Bot API سروش‌پلاس چه فرقی دارد؟

قالب متدها همان Bot API است، اما پشت صحنه از حساب واقعی سروش‌پلاس استفاده می‌شود.

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

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

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

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

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

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

قابلیت‌ها

با API سروش‌پلاس یونیوم چه می‌توانید بکنید؟

ارسال پیام

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

وب‌هوک + Polling

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

ادمین کانال‌ها و گروه‌ها

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

لاگ عیب‌یابی

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

کاربردهای عملی

سروش‌پلاس را به محصولتان متصل کنید

پشتیبانی کاربران

پیام سروش‌پلاس را به صف پشتیبانی بیاورید و پاسخ را در متن پرونده مشتری ثبت کنید.

پیام‌های تراکنشی

یادآوری یا وضعیت خدمت را برای مخاطب دارای رضایت ارسال کنید و از داده حساس غیرضروری پرهیز کنید.

گردش‌کار محتوا

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

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

Account API یونیوم یا بات رسمی سروش‌پلاس؟

Account API یونیوم

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

بات رسمی سروش‌پلاس

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

معیار تصمیم

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

شروع سریع

cURL

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

Python

import requests

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

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

print(response.json())
    chat_id="@your_channel",
    text="سلام!"
)

راه‌اندازی حساب سروش‌پلاس در پنج مرحله

ورود به پنل

فضای کاری یونیوم را باز کنید.

افزودن اتصال

سروش‌پلاس را انتخاب کنید.

تأیید حساب

شماره و OTP را تکمیل کنید.

کلید محدود

برای محیط توسعه کلید بسازید.

آزمون نهایی

در Playground متدهای لازم را بسنجید.

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

سوال‌های متداول اتصال سروش‌پلاس

آیا همه endpointهای Bot API پوشش داده می‌شوند؟

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

Account API با بات رسمی چه تفاوتی دارد؟

Account API با سشن حساب انسانی کار می‌کند؛ بات رسمی هویت و توکن مستقل دارد و سیاست‌های رسمی سروش‌پلاس بر آن حاکم است.

آیا می‌توان از کتابخانه فعلی تلگرام استفاده کرد؟

برخی کتابخانه‌ها با تغییر base URL قابل آزمایش‌اند، ولی سازگاری بدون تغییر تضمین نیست. نسخه و مسیرهای مورد استفاده را بررسی کنید.

تعرفه‌ها مستندات تست اتصال وضعیت سرویس