WhatsApp API — ارسال پیام به‌صورت برنامه‌نویسی‌شده

یک WhatsApp API کامل برای ارسال متن، رسانه و مدیریت مکالمات از طریق رابط ساده REST. بدون Puppeteer، بدون مرورگر headless — WebSocket خالص.

curl -X POST https://api2whats.com/send-text \
  -H "Authorization: Bearer ***" \
  -H "Content-Type: application/json" \
  -d '{"to": "971501234567", "message": "Hello from the API!"}'

WhatsApp API چیست؟

یک WhatsApp API به شما امکان می‌دهد پیام‌های واتس‌اپ را از نرم‌افزار خود ارسال و دریافت کنید. به‌جای باز کردن اپ واتس‌اپ روی گوشی و تایپ دستی پیام‌ها، کد شما درخواست‌های HTTP به یک endpoint API ارسال می‌کند. API اتصال به سرورهای واتس‌اپ، تحویل پیام، ردیابی وضعیت و هدایت پیام‌های ورودی را مدیریت می‌کند.

این برای هر کسب‌وکاری که نیاز به ارتباط با مشتریان در مقیاس دارد مفید است. تأیید سفارش، به‌روزرسانی‌های ارسال، یادآوری قرار ملاقات، پاسخ‌های پشتیبانی مشتریان، کمپین‌های بازاریابی — همه این‌ها را می‌توان از طریق یک WhatsApp API خودکار کرد. پیام‌ها در همان گفتگوی واتس‌اپی ظاهر می‌شوند که مشتریان از قبل استفاده می‌کنند، یعنی در واقع آن‌ها را می‌خوانند. نرخ باز شدن پیام‌های واتس‌اپ معمولاً بیش از ۹۰٪ است، در مقایسه با ۲۰٪ برای ایمیل.

مفهوم ساده است: اپلیکیشن شما یک درخواست HTTP به سرور API ارسال می‌کند، سرور API پیام را از طریق واتس‌اپ به گیرنده تحویل می‌دهد و شما پاسخی دریافت می‌کنید که تحویل را تأیید می‌کند. برای پیام‌های ورودی، API آن‌ها را به‌صورت real-time به URL webhook شما هدایت می‌کند تا سیستم شما بتواند فوراً آن‌ها را پردازش کند.

نحوه کار WhatsApp API ما

API ما بر اساس پروتکل WhatsApp Web با اتصالات مستقیم WebSocket ساخته شده است. این امر با راه‌حل‌هایی که از Puppeteer یا مرورگرهای headless برای خودکارسازی رابط وب استفاده می‌کنند، کاملاً متفاوت است. اتصال مستقیم WebSocket یعنی تأخیر کمتر، مصرف منابع کمتر و اطمینان‌پذیری به‌مراتب بهتر.

هر نمونه‌ای که می‌سازید، یک اتصال WebSocket احراز هویت‌شده به سرورهای واتس‌اپ حفظ می‌کند. وقتی از طریق API پیامی ارسال می‌کنید، مستقیماً از طریق همین اتصال WebSocket ارسال می‌شود. نه هزینه رندر مرورگر وجود دارد، نه پردازش اسکرین‌شات و نه دستکاری شکننده DOM. اتصال دائمی است و اتصال مجدد را به‌طور خودکار مدیریت می‌کند.

ما همچنین یک استخر پراکسی SOCKS5 توزیع‌شده در چندین منطقه اجرا می‌کنیم. این کار دو هدف دارد: اطمینان از اتصال مطمئن بدون توجه به مکان سرورهای شما، و توزیع اتصالات روی چندین نشانی IP برای جلوگیری از محدودیت نرخ. هر نمونه از طریق پراکسی متفاوتی متصل می‌شود، بنابراین حتی اگر ده نمونه را هم‌زمان اجرا کنید، هر کدام مسیر اتصال تمیز مخصوص خود را دارند.

با API چه کارهایی می‌توانید انجام دهید

ارسال پیام متنی

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

ارسال رسانه

فراتر از متن بروید. تصویر، ویدیو، سند، فایل صوتی و استیکر بفرستید. رسانه را می‌توان به‌صورت URL (که API آن را دریافت و تحویل می‌دهد) یا داده کدگذاری‌شده با Base64 برای ارسال درون‌خطی ارائه کرد. اسناد می‌توانند PDF، فایل Word، صفحه‌گسترده — هر نوع فایلی که واتس‌اپ پشتیبانی می‌کند — باشند.

دریافت پیام از طریق Webhook

وقتی کسی به شماره متصل شما پیامی بفرستد، API آن را به‌صورت درخواست POST به URL webhook شما هدایت می‌کند. شماره فرستنده، محتوای پیام، پیوست‌های رسانه‌ای و اطلاعات مهر زمانی را دریافت می‌کنید. کنترل‌کننده webhook شما پیام را پردازش می‌کند و می‌تواند هر پاسخ یا گردش‌کار خودکاری را فعال کند.

مدیریت چند شماره

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

ردیابی وضعیت پیام

هر پیامی که ارسال می‌کنید یک شناسه یکتا می‌گیرد. می‌توانید وضعیت هر پیام را جست‌وجو کنید — آیا در انتظار است، ارسال شده، تحویل داده شده یا خوانده شده. webhook‌ها نیز به‌روزرسانی‌های وضعیت را به‌صورت real-time ارسال می‌کنند، بنابراین سیستم شما بدون polling، لحظه تحویل یا خوانده شدن پیام را می‌داند.

endpointهای API

API از یک طراحی REST تمیز پیروی می‌کند. همه endpointها JSON را دریافت و برمی‌گردانند. endpointهای اصلی عبارت‌اند از:

• POST /send-text — ارسال پیام متنی
• POST /send-image — ارسال تصویر
• POST /send-video — ارسال ویدیو
• POST /send-document — ارسال سند یا فایل
• POST /send-audio — ارسال فایل صوتی
• POST /send-location — ارسال نشانگر موقعیت مکانی
• GET /message-status/{id} — بررسی وضعیت تحویل
• POST /set-webhook — پیکربندی URL webhook خود
• GET /instance/status — بررسی وضعیت اتصال

هر endpoint به کلید API ارسالی در هدر Authorization نیاز دارد. محدودیت‌های نرخ بر اساس طرح اعمال می‌شوند و API هنگام بروز مشکل، پیام‌های خطای واضح با کدهای وضعیت HTTP برمی‌گرداند.

روش‌های اتصال

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

اتصال با کد QR

کد QR را از داشبورد خود با اپ واتس‌اپ روی گوشی خود اسکن کنید. این سریع‌ترین روش است — حدود ۱۰ ثانیه طول می‌کشد. اگر به‌موقع اسکن نکنید، کد QR به‌طور خودکار بازسازی می‌شود. پس از اسکن، اتصال برقرار می‌شود و نمونه تا زمانی که آن را قطع نکنید آنلاین می‌ماند.

اتصال با کد جفت‌سازی

به‌جای اسکن کد QR، یک کد جفت‌سازی عددی روی گوشی خود وارد کنید. این روش زمانی مفید است که نتوانید کد QR را اسکن کنید — برای مثال هنگام اتصال شماره‌ای روی سرور راه‌دور. کد جفت‌سازی توسط API تولید می‌شود و پس از چند دقیقه منقضی می‌گردد.

زبان‌های برنامه‌نویسی پشتیبانی‌شده

API مستقل از زبان است. هر زبانی که بتواند درخواست HTTP ارسال کند می‌تواند از آن استفاده کند. ما نمونه کدهای آماده برای موارد زیر ارائه می‌دهیم:

• PHP — استفاده از cURL یا Guzzle
• Python — استفاده از کتابخانه requests
• JavaScript — استفاده از fetch یا axios (Node.js و مرورگر)
• cURL — استفاده مستقیم از خط فرمان
• Go — استفاده از net/http
• Java — استفاده از HttpURLConnection یا OkHttp

اگر زبان شما بتواند یک درخواست HTTP POST با بدنه JSON ارسال کند، می‌تواند از این API استفاده کند. نیازی به نصب SDK نیست.

جریان تحویل پیام

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

1. اپلیکیشن شما درخواست HTTP با کلید API و داده پیام به API ارسال می‌کند
2. API درخواست شما را اعتبارسنجی می‌کند: کلید API را بررسی می‌کند، قالب شماره تلفن را تأیید می‌کند و مطمئن می‌شود نمونه متصل است
3. پیام برای تحویل از طریق اتصال WebSocket نمونه مربوطه در صف قرار می‌گیرد
4. پیام از طریق اتصال دائمی WebSocket به سرورهای واتس‌اپ منتقل می‌شود
5. واتس‌اپ پیام را به گوشی گیرنده تحویل می‌دهد
6. API تأیید تحویل را از واتس‌اپ دریافت می‌کند و وضعیت پیام را به‌روزرسانی می‌کند
7. اگر webhook پیکربندی شده باشد، به‌روزرسانی وضعیت به سرور شما هدایت می‌شود

کل این جریان از درخواست شما تا تأیید تحویل معمولاً ۱ تا ۳ ثانیه طول می‌کشد. به‌روزرسانی‌های وضعیت (تحویل، خوانده شدن) بسته به اتصال گیرنده و زمان باز کردن پیام توسط او، ممکن است بیشتر طول بکشد.

مدیریت نمونه‌ها

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

• API key — توکن احراز هویت یکتا
• Connection status — متصل، قطع‌شده یا در حال اتصال مجدد
• Phone number — شماره واتس‌اپ مرتبط با نمونه
• Webhook URL — محل هدایت پیام‌های ورودی
• Message history — گزارش پیام‌های ارسالی و دریافتی

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

اطمینان‌پذیری و آپ‌تایم

ما در همه طرح‌ها SLA آپ‌تایم 99.9% را حفظ می‌کنیم. زیرساخت ما برای اطمینان‌پذیری ساخته شده است:

• Automatic reconnection — اگر اتصال WebSocket قطع شود، API ظرف چند ثانیه به‌طور خودکار دوباره متصل می‌شود
• Proxy failover — اگر یکی از سرورهای پراکسی مشکل داشته باشد، ترافیک از طریق سرور دیگری در استخر مسیریابی می‌شود
• Message queuing — اگر اتصال واتس‌اپ موقتاً در دسترس نباشد، پیام‌ها در صف قرار می‌گیرند و با بازگشت اتصال تحویل داده می‌شوند
• Health monitoring — ما همه نمونه‌ها را به‌صورت شبانه‌روزی پایش می‌کنیم و پیش از آنکه مشکلات بر تحویل تأثیر بگذارند، به‌طور پیشگیرانه آن‌ها را برطرف می‌کنیم

API فقط زمانی خطای 503 Service Unavailable برمی‌گرداند که همه مسیرهای اتصال امتحان شده باشند، که بسیار نادر است. در عمل، پیام‌های شما حتی اگر اجزای جداگانه دچار وقفه‌های کوتاه شوند، تحویل داده خواهند شد.

امنیت و حریم خصوصی

تمام ارتباطات API از طریق HTTPS رمزنگاری می‌شود. کلیدهای API با هش bcrypt به‌صورت امن ذخیره می‌شوند — ما هرگز آن‌ها را به‌صورت متن ساده ذخیره نمی‌کنیم. URLهای webhook شما اعتبارسنجی می‌شوند و تمام payloadهای webhook امضا می‌شوند تا بتوانید تأیید کنید واقعاً از سرورهای ما آمده‌اند.

مگر اینکه صراحتاً آن را از طریق webhook هدایت کنید، به محتوای پیام‌های شما دسترسی نداریم. پیام‌های میان شما و مشتریانتان خصوصی باقی می‌مانند. اتصال واتس‌اپ برای لایه انتقال پیام از رمزنگاری سرتاسری استفاده می‌کند.

تعرفه‌ها

طرح‌ها از $9.99 در ماه شروع می‌شوند و شامل تعدادی مشخص از درخواست‌های API در روز، نمونه‌ها و قابلیت‌ها هستند. هیچ هزینه پنهانی وجود ندارد، هیچ هزینه‌ای به‌ازای هر پیام گرفته نمی‌شود و هیچ غافلگیری مازادی در کار نیست. می‌توانید در هر زمان از داشبورد خود، طرح خود را ارتقا یا تنزل دهید.

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

موارد استفاده

API واتس‌اپ ما در طیف گسترده‌ای از صنایع و کاربردها استفاده می‌شود. در اینجا برخی از رایج‌ترین کاربردهایی که مشتریان ما می‌سازند آمده است:

• E-commerce — تأیید سفارش، به‌روزرسانی‌های ارسال، اعلان‌های تحویل، به‌روزرسانی وضعیت مرجوعی و یادآوری سبد خرید رهاشده
• Healthcare — یادآوری قرار ملاقات، اعلان تمدید نسخه دارو، تحویل جواب آزمایش و پیگیری‌های بیمار
• Education — تأیید ثبت‌نام در دوره، مهلت تحویل تکلیف، نتایج امتحان و ارتباط اولیا و مربیان
• Real Estate — هشدارهای ثبت ملک، تأیید بازدید، اعلان‌های پیشنهاد و ارتباط با مستأجران
• Financial Services — هشدارهای تراکنش، تحویل صورتحساب، یادآوری پرداخت و اعلان‌های حساب
• Restaurants — تأیید سفارش، یادآوری رزرو میز، جمع‌آوری بازخورد و پیشنهادهای تبلیغاتی
• Logistics — به‌روزرسانی‌های ردیابی مرسوله، تأییدهای تحویل، تخصیص راننده و اعلان‌های انبار

هر کسب‌وکاری که از طریق واتس‌اپ با مشتریان ارتباط برقرار می‌کند، می‌تواند از خودکارسازی آن مکالمات از طریق API بهره‌مند شود. نکته کلیدی، شناسایی پیام‌های تکراری و قابل پیش‌بینی است — همان‌هایی که باید خودکار شوند.

شروع به کار

1. ساخت حساب رایگان — ۳۰ ثانیه طول می‌کشد
2. طرحی متناسب با نیازهای خود انتخاب کنید
3. از داشبورد
4. شماره تلفن خود را از طریق کد QR یا کد جفت‌سازی متصل کنید
5. از کلید API خود برای ارسال اولین پیام استفاده کنید

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