Rubika Account API

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

فعال

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

اتصال حساب روبیکا مستندات روبیکا امتحان در playground

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

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

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

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

app / inbox

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

r

پشتیبانی
Rubika

r

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

r

گروه محصول
Rubika

پلتفرم‌ها

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

ر

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

۲ دقیقه پیش

👍 ۱۲❤️ ۸

ی

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

همین حالا

ر

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 روبیکا یونیوم چه می‌توانید بکنید؟

ارسال پیام

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

مدیا یکپارچه

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

وب‌هوک + Polling

دریافت رویدادهای پشتیبانی‌شده با webhook یا polling، متناسب با تنظیم اتصال.

ریکاوری سشن

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

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

روبیکا برای چه جریان‌هایی مناسب است؟

پشتیبانی چندکاناله

مکالمه روبیکا را کنار کانال‌های دیگر در CRM یا میز پشتیبانی نمایش دهید.

پیام وضعیت سفارش و خدمت

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

انتشار محتوای کانال

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

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

حساب روبیکا یا بات رسمی؟

Account API یونیوم

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

بات رسمی روبیکا

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

معیار تصمیم

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

شروع سریع

cURL

curl -X POST "https://api.uniom.ir/bot<RUBIKA_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/botRUBIKA_API_KEY/sendMessage",
    json=payload,
)

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

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

ورود به یونیوم

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

انتخاب روبیکا

اتصال حساب جدید بسازید.

تکمیل ورود

مراحل تأیید نمایش‌داده‌شده را انجام دهید.

ساخت کلید

کلید محدود برای برنامه بسازید.

تست و پایش

در Playground آزمایش و وضعیت را پایش کنید.

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

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

آیا این سرویس API رسمی روبیکا است؟

خیر. این صفحه اتصال Account API یونیوم را شرح می‌دهد. بات یا API رسمی روبیکا مسیر جداگانه‌ای با سیاست‌های خود پلتفرم است.

آیا ارسال به هر کاربر یا کانالی ممکن است؟

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

قطع اتصال چگونه مدیریت می‌شود؟

وضعیت در پنل قابل مشاهده است و تلاش بازیابی ممکن است انجام شود، اما گاهی تأیید یا ورود مجدد لازم خواهد بود.

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