از انتخاب پلتفرم تا عیب‌یابی اتصال

مسیرهای اصلی یادگیری و اجرا در یک صفحه: مرجع API، ابزار آزمایش، راهنمای MCP، وضعیت سرویس و جامعه توسعه‌دهندگان یونیوم.

Docsساختار و نمونه درخواست
تست اتصالآزمایش با حساب خودتان
Communityتلگرام و بله

اولین اتصال در چهار مرحله

اگر تازه کار را شروع کرده‌اید، این مسیر کوتاه‌ترین راه تا اولین پیام واقعی است.

۱. ساخت حساب

در داشبورد ثبت‌نام کنید و فضای کاری خود را بسازید.

۲. افزودن اتصال

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

۳. ساخت کلید API

از صفحه «کلیدهای API» یک کلید با scope محدود بسازید. کلید فقط یک‌بار نشان داده می‌شود؛ آن را در جای امن ذخیره کنید.

۴. ارسال اولین پیام

در تست اتصال یک درخواست ارسال پیام بسنجید یا با curl همین کلید را امتحان کنید.

هر چیزی که برای ساختن لازم دارید

مرجع فنی، ابزار توسعه و وضعیت سرویس — به‌همان ترتیبی که در پروژه به آن‌ها نیاز پیدا می‌کنید.

مرجع API

همه‌ی متدها، پارامترها و نمونه درخواست‌ها با قالب Telegram Bot API.

باز کردن مرجع

راهنماهای شروع

اتصال حساب، ساخت کلید و اولین وب‌هوک — گام‌به‌گام با مثال واقعی.

مطالعه راهنما

تست اتصال

درخواست‌ها را با حساب خودتان بسنجید و از صفحه «لاگ‌ها» خطای اجرا را پیدا کنید.

ورود به تست اتصال

ابزارهای توسعه

MCP server برای عامل‌های AI، مسیر فنی REST و اتصال بدون کد با n8n و Make.

راهنمای MCP

وضعیت سرویس

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

مشاهده وضعیت

تغییرات سرویس

متدهای جدید، اصلاح رفتار و بهبودهای API — به‌روزرسانی‌شده در مستندات.

گزارش تغییرات

برای هر پیام‌رسان یک راهنما

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

اگر چیز کار نکرد

پیش از پشتیبانی، این سه مسیر معمولاً علت را پیدا می‌کنند.

اتصال از کار افتاد

اگر پیام خطای INVALID_AUTH یا transport failed دیدید، اتصال حساب را از صفحه «حساب‌های پیام‌رسان» دوباره فعال کنید. این یعنی credential دوباره احراز هویت شده است.

پیام نرسید

اول صفحه «لاگ‌ها» را باز کنید و status تحویل را ببینید. اگر delivered نبود، پلتفرم مقصد محدودیت دارد یا پیام خارج ساعات مجاز فرستاده شده است.

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

HTTPS را بررسی کنید، idempotency key را با message_id بسازید تا پیام تکراری ثبت نشود و تایم‌اوت endpoint را کوتاه (۱۰ ثانیه) نگه دارید.

هنوز گیر کردید؟ از پشتیبانی زنده یا کانال @uniom_ir کمک بگیرید.

اولین پیام را همین حالا بفرستید

ثبت‌نام رایگان، سه اتصال و یک کلید محدود — تا پیام واقعی کمتر از ده دقیقه فاصله دارید.

شروع رایگان