Basalam Account API

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

فعال

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

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

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

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

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

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

app / inbox

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

b

فروشگاه
Basalam

b

سفارش‌ها
Basalam

b

پیام مشتری
Basalam

پلتفرم‌ها

فروشگاه · باسلام · همین حالا

ب

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

۲ دقیقه پیش

👍 ۱۲❤️ ۸

ی

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

همین حالا

ب

report.pdf
۲.۴ MB

۱ ساعت پیش

۱۲گفتگوی باز

۴کانال و گروه

۲۳۴مخاطب

نوع حساب

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

OAuth

فروشگاه باسلام

ورود با OAuth باسلام و دسترسی به فروشگاه، سفارش و مشتری.

ورود با OAuth
سفارش و مشتری
پیام فروشنده
وب‌هوک رویداد

Automation

اتوماسیون فروش

پیام سفارش، وضعیت و اطلاع‌رسانی به مشتری با قالب Bot API.

پیام سفارش
وضعیت ارسال
یادآوری
وب‌هوک پایدار

قابلیت‌های API

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

فروشگاه

گروه 1

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

اتصال OAuth

گروه 2

ورود با OAuth
توکن فروشگاه
چرخش توکن
منطقه و محدوده

پیام‌ها

گروه 3

پیام به مشتری
قالب Bot API
وضعیت پیام
دریافت پیام

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

گروه 4

رویداد سفارش
setWebhook / وب‌هوک
رویدادهای حساب
صفحه و وضعیت

سؤالات

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

اتصال به باسلام چگونه است؟

با OAuth باسلام وارد می‌شوید؛ یونیوم توکن فروشگاه را برای خودکارسازی پیام و سفارش مدیریت می‌کند.

آیا پیام سفارش به مشتری ارسال می‌شود؟

بله. می‌توانید پیام وضعیت سفارش و اطلاع‌رسانی را با قالب Bot API ارسال کنید.

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

خیر. سشن و توکن توسط یونیوم نگه‌داری می‌شود.

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

با وب‌هوک پایدار یا long polling؛ یونیوم تحویل و retry را مدیریت می‌کند.

قابلیت‌ها

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

پیام فروشگاه

متن و مدیای پشتیبانی‌شده را در چت‌های فروشگاه بفرستید؛ دقیقاً از همان مسیر استاندارد یونیوم.

OAuth یا توکن شخصی

ورود با جریان OAuth یا توکن شخصی؛ توکن مانند یک راز عملیاتی نگهداری و از لاگ حذف می‌شود.

رویداد سفارش

رویدادهای سفارش و وضعیت فروشگاه را با وب‌هوک یا long polling دریافت کنید و به گردش‌کار خود وصل کنید.

مانیتورینگ در پنل

وضعیت اتصال، لاگ فراخوانی‌ها و خطاهای تحویل در پنل یونیوم قابل ردیابی است.

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

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

پشتیبانی مشتری فروشگاه

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

اطلاع‌رسانی سفارش

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

اتوماسیون بازگشت

پاسخ دکمه یا کلیدواژه مشتری را به فرآیند مرجوعی یا باشگاه مشتریان وصل کنید.

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

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

Account API یونیوم

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

بات رسمی باسلام

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

معیار تصمیم

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

شروع سریع

cURL

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

Python

import requests

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

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

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

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

ورود به پنل

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

افزودن باسلام

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

تأیید دسترسی

OAuth یا توکن شخصی را در جریان امن وارد کنید.

کلید توسعه

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

آزمایش جریان

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

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

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

تفاوت این اتصال با بات رسمی باسلام چیست؟

Account API با حساب فروشگاه و OAuth یا توکن شخصی کار می‌کند؛ بات رسمی محدود به قابلیت‌های اعلام‌شده باسلام است.

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

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

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

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

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