Eitaa Account API

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

فعال

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

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

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

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

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

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

app / inbox

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

e

کانال ایتا
Eitaa

e

پشتیبانی
Eitaa

e

گروه محصول
Eitaa

پلتفرم‌ها

کانال اطلاع‌رسانی · همین حالا

س

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

۲ دقیقه پیش

👍 ۱۲❤️ ۸

ی

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

همین حالا

س

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

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

ارسال پیام

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

دریافت آپدیت‌ها

دریافت رویدادهای پشتیبانی‌شده با webhook یا polling و بررسی نتیجه درخواست‌ها در لاگ پنل.

مدیا و فایل

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

پایش و بازیابی اتصال

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

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

ایتا را کجای محصول استفاده کنید؟

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

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

پیام تراکنشی

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

مدیریت جامعه و کانال

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

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

Account API یونیوم یا اتصال مستقیم؟

Account API یونیوم

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

اتصال مستقیم به API ایتا

زیرساخت، نگهداری و نسخه‌های کتابخانه جدا
قرارداد و فرمت رویداد متفاوت از Bot API
وب‌هوک و مدیریت خطا دست‌ساز
بدون داشبورد و لاگ متمرکز

معیار تصمیم

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

شروع سریع

فقط base_url را روی https://api.uniom.ir/bot بگذارید و توکن خود را با کلید API ایتا جایگزین کنید.

cURL

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

python-telegram-bot

import requests

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

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

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

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

ساخت حساب

وارد داشبورد یونیوم شوید.

انتخاب ایتا

یک اتصال حساب ایتا اضافه کنید.

تأیید OTP

شماره و کد یکبارمصرف را وارد کنید.

ساخت کلید

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

آزمایش

اولین درخواست را در Playground اجرا کنید.

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

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

آیا این همان API رسمی برنامه‌ساز ایتا است؟

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

آیا همه متدهای Telegram Bot API کار می‌کنند؟

خیر؛ ساختار آشناست اما پوشش دقیق به قابلیت پلتفرم و نسخه اتصال بستگی دارد. متد مورد نیازتان را در مستندات و Playground بررسی کنید.

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

یونیوم وضعیت اتصال و تلاش‌های بازیابی را نمایش می‌دهد، اما ممکن است ورود مجدد یا OTP تازه لازم باشد.

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