WhatsApp Account API

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

راه‌اندازی با هماهنگی

حساب واتساپ را با کد اتصال یا QR متصل کنید و پیام، مدیا و رویدادها را از همان API سازگار با Telegram Bot ارسال و دریافت کنید. اتصال جدید نیاز به هماهنگی دارد — از تماس درخواست دهید.

درخواست اتصال واتساپ مستندات واتساپ امتحان در playground

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

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

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

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

app / inbox

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

w

پشتیبانی
WhatsApp

w

فروش
WhatsApp

w

کانال
WhatsApp

پلتفرم‌ها

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

و

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

۲ دقیقه پیش

👍 ۱۲❤️ ۸

ی

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

همین حالا

و

report.pdf
۲.۴ MB

۱ ساعت پیش

۱۲گفتگوی باز

۴کانال و گروه

۲۳۴مخاطب

نوع حساب

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

Account API

واتساپ شخصی

اتصال واتساپ شخصی برای گفتگوی یک‌به‌یک، مخاطبین و گروه‌ها.

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

Business

واتساپ بیزینس

مدیریت واتساپ بیزینس برای CRM، پشتیبانی و پیگیری فروش.

فروش و پیگیری
تمپلیت پیام
برچسب و گروه
وب‌هوک پایدار

قابلیت‌های API

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

پیام‌ها

گروه 1

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

اتصال حساب

گروه 2

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

فایل و مدیا

گروه 3

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

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

گروه 4

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

سؤالات

پرسش‌های پرتکرار واتساپ

یونیوم با WhatsApp Business API چه فرقی دارد؟

یونیوم از حساب واتساپ (شخصی و بیزینس) بدون درگیرشدن با فرآیند سخت تأیید متا به‌صورت همگام استفاده می‌کند.

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

خیر. سشن و زیرساخت توسط یونیوم نگه‌داری می‌شود؛ شما فقط یک کلید API می‌گیرید.

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

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

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

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

قابلیت‌ها

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

ارسال پیام

متن، عکس، ویدیو، صدا، فایل، ویس و آلبوم مدیا — همان فراخوانی‌های Bot API.

ورود با کد اتصال یا QR

اتصال امن با کد هشت‌رقمی یا اسکن QR؛ سشن به‌صورت دائمی روی زیرساخت یونیوم نگه داشته می‌شود.

وب‌هوک + Polling

آپدیت‌های واتساپ در همان فرمت Update تلگرام، با وب‌هوک یا long polling.

مخاطب و تاریخچه

گفتگوها، مخاطبین و تاریخچه چت را با متدهای getChat / getChatHistory بخوانید.

ویرایش، فوروارد و حذف

editMessageText، forwardMessage، copyMessage و deleteMessage برای مدیریت گفتگو.

لاگ و عیب‌یابی

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

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

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

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

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

اطلاع‌رسانی تراکنشی

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

تیم فروش

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

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

Account API یونیوم یا Cloud API رسمی واتساپ؟

Account API یونیوم

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

Meta Cloud API

زیرساخت رسمی Meta و توکن کسب‌وکار
الزام تمپلیت و کانال تأییدشده
نرخ‌گذاری دلاری و الزامات خودش

معیار تصمیم

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

شروع سریع

cURL

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

Python

import requests

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

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

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

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

ورود به پنل

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

افزودن واتساپ

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

اتصال حساب

کد هشت‌رقمی یا QR را در جریان امن وارد کنید.

کلید محدود

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

آزمون نهایی

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

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

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

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

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

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

بیشتر متدهای پرکاربرد مثل sendMessage، sendPhoto و getUpdates با تنظیم base URL کار می‌کنند. متدهای پیشرفته‌تر را در مستندات و Playground قبل از انتشار بررسی کنید.

چرا حسابم از دستگاه دیگری خارج شد؟

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

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

کلید جدا، scope محدود، webhook مقاوم، لاگ بدون راز و رضایت صریح مخاطب را در نظر بگیرید. ارسال ناخواسته می‌تواند منجر به محدود شدن شماره شود.

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