Bale Account API

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

فعال

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

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

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

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

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

اتصال حساب بله مستندات

app / inbox

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

b

پشتیبانی
Bale

b

گروه فروش
Bale

b

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

پلتفرم‌ها

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

ب

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

۲ دقیقه پیش

👍 ۱۲❤️ ۸

ی

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

همین حالا

ب

report.pdf
۲.۴ MB

۱ ساعت پیش

۱۲گفتگوی باز

۴کانال و گروه

۲۳۴مخاطب

نوع حساب

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

Account API

حساب شخصی بله

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

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

Bot API

ربات رسمی بله

قالب Bot API رسمی بله با inline keyboard، درگاه پرداخت و وب‌هوک پایدار.

Inline Keyboard
درگاه پرداخت
ارسال پستی
وب‌هوک پایدار

قابلیت‌های API

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

پیام‌ها

گروه 1

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

اتصال حساب و ربات

گروه 2

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

فایل و مدیا

گروه 3

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

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

گروه 4

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

سؤالات

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

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

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

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

بله. توکن BotFather را وارد کنید و از همان قالب Bot API اقدام کنید.

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

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

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

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

قابلیت‌ها

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

ارسال پیام

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

ورود با شماره و OTP

ورود با شماره موبایل و کد یکبارمصرف؛ از دسترسی به OTP و کلید API مانند یک راز عملیاتی محافظت کنید.

وب‌هوک + Polling

آپدیت‌ها را با وب‌هوک یا long polling دریافت کنید.

مانیتورینگ آنلاین

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

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

بله را در گردش‌کار کسب‌وکار قرار دهید

پشتیبانی و پیگیری

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

پیام خدمات مالی

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

اطلاع‌رسانی سازمانی

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

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

Account API یونیوم یا بازوی رسمی بله؟

Account API یونیوم

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

بازوی رسمی بله

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

معیار تصمیم

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

شروع سریع

cURL

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

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

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

ورود به پنل

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

افزودن بله

اتصال حساب بله را انتخاب کنید.

تأیید شماره

OTP را در جریان امن وارد کنید.

کلید توسعه

یک کلید با scope لازم بسازید.

آزمایش جریان

ارسال و دریافت را در Playground بسنجید.

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

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

تفاوت این اتصال با بازوی بله چیست؟

Account API با حساب کاربری و OTP کار می‌کند؛ بازوی رسمی از توکن و دامنه قابلیت تعریف‌شده بله استفاده می‌کند.

آیا کتابخانه تلگرام بدون تغییر کار می‌کند؟

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

برای محیط عملیاتی چه کنم؟

کلید جدا، scope محدود، webhook مقاوم، لاگ بدون راز و یک سناریوی ورود مجدد برای قطع سشن در نظر بگیرید.

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