مقاله‌ها

WhatsApp Business API به زبان ساده: دسترسی، قالب‌ها، هزینه‌ها و اتصال به CRM

WhatsApp Business API راه رسمی متا برای وصل کردن یک شماره به نرم‌افزار است، نه به گوشی. در این مطلب می‌بینید چه چیزهایی لازم دارید، چقدر هزینه دارد و در کار روزانه چه چیزی عوض می‌شود.

به‌طور خلاصه: WhatsApp Business API که امروز به شکل Cloud API ارائه می‌شود، رابط رسمی متاست که به نرم‌افزار اجازه می‌دهد برای یک شماره تجاری پیام WhatsApp بفرستد و دریافت کند. به یک پرتفوی تجاری متا، یک اپلیکیشن، یک شماره تلفن با نام نمایشی و قالب‌های تأییدشده برای هر پیامی نیاز دارید که بیرون از پنجره 24 ساعته پس از آخرین پیام مشتری فرستاده شود. متا به ازای هر پیام تحویل‌شده و بر اساس دسته پیام و کشور هزینه می‌گیرد؛ پیام‌های مشتریان رایگان‌اند. NeuroCRM اتصال Cloud API را به‌صورت دستی و با توکن‌های خودتان برقرار می‌کند و درگاه GREEN-API هم در دسترس است.

WhatsApp Business API چیست؟

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

امروز رابطی که متا مستند می‌کند Cloud API است که روی سرورهای خود متا میزبانی می‌شود. وقتی کسی «whatsapp api»، «API واتساپ» یا «whatsapp cloud api» را جست‌وجو می‌کند، منظورش همین است. «WhatsApp Business Platform» نام کلی‌تری است که متا برای کل خدمات پیام‌رسانی تجاری‌اش به کار می‌برد؛ Cloud API رابطی درون همین پلتفرم است.

آنچه نسبت به گوشی به دست می‌آورید: چند نفر می‌توانند از یک شماره جواب بدهند، پیام‌ها می‌توانند از نرم‌افزار فرستاده شوند و هر چت می‌تواند کنار یک مخاطب و یک معامله قرار بگیرد. آنچه در عوض می‌پذیرید: قوانین قالب‌ها، پنجره 24 ساعته و هزینه به ازای هر پیام — که همه در ادامه توضیح داده شده‌اند.

اپلیکیشن WhatsApp Business، WhatsApp Business Web و API چه فرقی با هم دارند؟

  • اپلیکیشن WhatsApp Business. اپلیکیشنی برای گوشی که به گفته خود WhatsApp با در نظر گرفتن صاحبان کسب‌وکارهای کوچک ساخته شده است. یک کسب‌وکار، و معمولاً یک نفر پشت صفحه‌کلید.
  • WhatsApp Business Web. عبارتی که مردم برای باز کردن همان حساب تجاری در مرورگر جست‌وجو می‌کنند. باز هم همان پنجره چت اپلیکیشن است، نه یکپارچه‌سازی: به معاملات، وظایف یا گزارش‌ها وصل نیست.
  • WhatsApp Business API (Cloud API). یک رابط برنامه‌نویسی. شماره روی پلتفرم ثبت می‌شود و چت‌ها را یک برنامه مدیریت می‌کند، نه گوشی.

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

چه کسی می‌تواند دسترسی بگیرد و چه چیزهایی لازم است؟

راهنمای شروع متا یک حساب Facebook یا حساب مدیریت‌شده متا (managed Meta account)، ثبت‌نام به‌عنوان توسعه‌دهنده و یک دستگاه دارای WhatsApp برای پیام‌های آزمایشی می‌خواهد. در همین مسیر یک پرتفوی تجاری متا (business portfolio) انتخاب می‌کنید یا می‌سازید، یک اپلیکیشن با کاربرد WhatsApp می‌سازید و یک شماره تلفن اضافه می‌کنید.

طبق مستندات متا درباره شماره‌های تلفن، شماره قواعدی دارد:

  • شماره‌ای که همین حالا در WhatsApp استفاده می‌شود، تا اول از WhatsApp حذف نشود، ثبت نمی‌شود.
  • شماره باید مال خودتان باشد، کد کشور و کد منطقه داشته باشد و بتواند برای تأیید، پیامک یا تماس صوتی دریافت کند.
  • هنگام ثبت، نام نمایشی (display name) الزامی است. این نام روی پروفایل WhatsApp همان شماره دیده می‌شود.

برای شروع آزمایش به قالب نیاز ندارید: راهنمای سریع خود متا یک قالب آماده به نام hello_world می‌فرستد. قالب‌های تأییدشده خودتان از وقتی لازم می‌شوند که شما شروع‌کننده گفتگو باشید یا پس از بسته شدن پنجره پاسخ بدهید.

پنجره 24 ساعته چطور کار می‌کند؟

وقتی مشتری به شما پیام می‌دهد یا زنگ می‌زند، یک پنجره 24 ساعته باز می‌شود. هر پیام تازه مشتری آن را از نو شروع می‌کند. تا وقتی پنجره باز است، می‌توانید پیام آزاد بفرستید. وقتی بسته شد، فقط پیام قالبی مجاز است (صفحه قیمت‌گذاری متا این قانون را ذکر کرده است).

قالب‌ها سه دسته‌اند: بازاریابی، کاربردی (utility) و احراز هویت. آن‌ها را در WhatsApp Manager می‌سازید و متا بررسی‌شان می‌کند؛ حساب کنید که قالب تازه مدتی طول می‌کشد تا قابل استفاده شود.

متا هزینه WhatsApp Business API را چطور حساب می‌کند؟

طبق صفحه قیمت‌گذاری متا، بررسی‌شده در 18 نوامبر 2026:

  • متا از 1 ژوئیه 2025 به ازای هر پیام تحویل‌شده هزینه می‌گیرد، نه به ازای هر گفتگو. قیمت به دسته پیام و کد تلفن کشور گیرنده بستگی دارد.
  • پیام‌هایی که مشتریان برای شما می‌فرستند هزینه‌ای ندارند.
  • قالب‌ها بازاریابی، کاربردی یا احراز هویت‌اند؛ پاسخ‌های بدون قالب درون پنجره، پیام خدمات (service) حساب می‌شوند. متا Meta Business Agent را هم در فهرستش آورده است.
  • هر شماره تلفن تجاری ماهانه 1,000 پیام خدمات رایگان دارد که هر ماه از نو شروع می‌شود. از 1 اکتبر 2026، پیام‌های خدمات از پیام 1,001 به بعد پولی‌اند.
  • اگر روی حساب پیام‌رسانی روش پرداختی ثبت نشده باشد، متا پیام‌های خدمات را فقط در حد سهمیه رایگان تحویل می‌دهد.
  • قالب‌های کاربردی که درون پنجره باز فرستاده می‌شوند، تا 30 سپتامبر 2026 رایگان بودند و از 1 اکتبر 2026 پولی‌اند.
  • اگر مشتری از طریق تبلیغ Click to WhatsApp در اپلیکیشن موبایل به شما پیام بدهد و شما درون پنجره پاسخ دهید، یک پنجره ورود رایگان تا 7 روز باز می‌شود که در آن پیام‌های بازاریابی، کاربردی، احراز هویت و خدمات هزینه‌ای ندارند.

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

متا هزینه پیام‌ها را از همان حساب WhatsApp که وصل می‌کنید می‌گیرد. CRM یا هر ارائه‌دهنده نرم‌افزار دیگری هزینه خودش را جداگانه می‌گیرد.

آیا می‌توانم از این طریق پیام بازاریابی بفرستم و ربات راه بیندازم؟

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

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

NeuroCRM چطور به WhatsApp Business API وصل می‌شود؟

NeuroCRM از دو روش برای اتصال WhatsApp پشتیبانی می‌کند. برای مقایسه مفصل‌تر این دو، CRM برای WhatsApp: API رسمی یا درگاه‌های QR را بخوانید. این صفحه به جزئیات بخش API می‌پردازد.

اتصال دستی Cloud API

در تنظیمات ← یکپارچه‌سازی‌ها، WhatsApp Business Cloud API را انتخاب می‌کنید و چهار فیلد را پر می‌کنید:

  1. «شناسه شماره تلفن» (Phone Number ID) از صفحه API Setup متا.
  2. «توکن دسترسی دائمی (کاربر سیستم)» که در Business Settings ← System Users ساخته می‌شود.
  3. App Secret که برای تأیید امضای وب‌هوک‌های ورودی به کار می‌رود.
  4. «شناسه حساب کسب‌وکار واتساپ» (WABA ID).

بعد «تأیید و اتصال» را بزنید. NeuroCRM یک Callback URL و یک Verify Token نشان می‌دهد؛ هر دو را در اپلیکیشن متای خودتان، در WhatsApp ← Configuration ← Webhooks، جای‌گذاری می‌کنید و اشتراک فیلد messages را فعال می‌کنید. می‌توانید چند شماره اضافه کنید.

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

اپراتورها چه می‌بینند

هر چت WhatsApp با کارت مخاطب به همان صندوق ورودی‌ای می‌رسد که کانال‌های دیگرتان در آن هستند. NeuroCRM آن 24 ساعت را از تازه‌ترین پیام واقعی WhatsApp مشتری حساب می‌کند و پنجره را پنج دقیقه زودتر بسته در نظر می‌گیرد.

وقتی پنجره بسته است، NeuroCRM به‌جای متن شما یک قالب تأییدشده می‌فرستد: قالبی که انتخاب کرده‌اید، قالب پیش‌فرض فضای کاری، یا یک قالب تأییدشده بدون متغیر و رسانه. پیش‌نویس شما در کادر پاسخ منتظر جواب مشتری می‌ماند. اگر هیچ قالب تأییدشده‌ای نباشد، ارسال رد می‌شود؛ و قالب دوم پیش از پاسخ مشتری فقط وقتی می‌رود که دوباره آن را از فهرست انتخاب کنید.

قانون‌ها، خودکارسازی‌ها و هوش مصنوعی

  • خودکارسازی‌ها. بیرون از پنجره، خودکارسازی پیامی نمی‌فرستد و قالبی هم انتخاب نمی‌کند: آن مرحله «ارسال‌نشده» علامت می‌خورد. در رویدادهای معامله، پیام به قدیمی‌ترین گفتگوی مخاطب می‌رود، از هر کانالی که باشد.
  • زنجیره‌های فروش. مرحله WhatsApp قالب تأییدشده‌ای را می‌فرستد که نامش را در همان مرحله تعیین می‌کنید.
  • پاسخ‌های هوش مصنوعی. «مرکز تماس عصبی» ماژولی پولی است: ماهانه $200 به‌علاوه $0.50 برای هر گفتگوی موفق، با کلید هوش مصنوعی خودتان و کارمزد 0%، یا از طریق NeuroCRM با کارمزد +20%. بیرون از پنجره 24 ساعته پاسخ نمی‌دهد و قالب هم نمی‌فرستد. خودش هم نوبت ثبت نمی‌کند.

جایگزین: GREEN-API

GREEN-API یک درگاه غیررسمی است. یک شماره شخصی را در کنسول GREEN-API با کد QR وصل می‌کنید و بعد idInstance و apiTokenInstance را در NeuroCRM وارد می‌کنید. راهنمای خود این یکپارچه‌سازی می‌گوید درگاه «برای مواردی که WhatsApp Business API رسمی در دسترس نیست» مناسب است. این درگاه پلتفرم متا نیست، پس قوانین قالب و پنجره‌ای که بالاتر گفتیم درباره آن صدق نمی‌کند.

NeuroCRM با WhatsApp Business API چه کارهایی نمی‌کند؟

  • اتصال یک‌کلیکی ندارد. اطلاعات دسترسی متا دستی وارد می‌شود؛ روند Embedded Signup متا به‌صورت دکمه ارائه نمی‌شود.
  • coexistence (هم‌زیستی) ندارد. شماره‌ای که هم‌زمان در اپلیکیشن WhatsApp Business و در API استفاده شود، از طریق NeuroCRM کار نمی‌کند.
  • هزینه پیام‌های متا جزو قیمت هر کاربر نیست و NeuroCRM آن را تعیین نمی‌کند؛ متا از حسابی که وصل می‌کنید هزینه می‌گیرد.
  • انتخاب خودکار قالب ندارد: بیرون از پنجره 24 ساعته نه خودکارسازی‌ها قالب انتخاب می‌کنند و نه هوش مصنوعی.

اجرای WhatsApp در NeuroCRM چقدر هزینه دارد؟

هر کاربر ماهانه $13 هزینه دارد، یا $10.40 وقتی برای یک سال پرداخت می‌کنید، و پلن رایگانی وجود ندارد. دوره آزمایشی 14 روزه همه امکانات را با تعداد نامحدود کاربر در بر دارد و بعد فضای کاری فقط‌خواندنی می‌شود. تعرفه‌ها را ببینید. «مرکز تماس عصبی» همان ماژول جداگانه‌ای است که بالاتر گفتیم. هزینه پیام‌به‌پیام متا ردیف سومی است که خود متا صورت‌حسابش را می‌فرستد.

برای مقایسه سیستم‌ها، مقایسه‌های NeuroCRM و راهنمای جایگزین‌های Kommo را ببینید. برای اینکه WhatsApp را کنار کانال‌های دیگرتان ببینید، مطلب صندوق ورودی یکپارچه را بخوانید.

چک‌لیست پیش از اتصال

  1. شماره‌ای را انتخاب کنید که مال خودتان است و می‌توانید پیامک یا تماس تأیید را روی آن دریافت کنید. اگر از قبل در WhatsApp است، در نظر داشته باشید که اول باید آن را از آنجا حذف کنید.
  2. پرتفوی تجاری متا، اپلیکیشن با کاربرد WhatsApp و یک کاربر سیستمی با توکن دائمی بسازید.
  3. نام نمایشی را انتخاب کنید.
  4. در سمت متا یک روش پرداخت اضافه کنید، وگرنه پیام‌های خدمات بیش از سهمیه رایگان تحویل داده نمی‌شوند.
  5. دست‌کم یک قالب کاربردی در WhatsApp Manager ثبت کنید و پیش از شروع کار منتظر تأیید متا بمانید.
  6. Phone Number ID و WABA ID را از صفحه API Setup یادداشت کنید.
  7. در NeuroCRM اتصال را برقرار کنید، Callback URL و Verify Token را در متا کپی کنید و اشتراک messages را فعال کنید.
  8. برای خودتان پیامی بفرستید، جوابش را بدهید، بعد صبر کنید تا پنجره بسته شود و یک قالب را آزمایش کنید.

پرسش‌های متداول

آیا WhatsApp Business API رایگان است؟

نه کاملاً. متا برای هر پیام تحویل‌شده هزینه می‌گیرد، به‌جز پیام‌های مشتریان، 1,000 پیام خدمات اول هر شماره در هر ماه و پیام‌های درون پنجره ورود رایگان.

WhatsApp API با Cloud API چه فرقی دارد؟

برای راه‌اندازی تازه، در عمل یکی هستند: Cloud API نسخه‌ای است که متا میزبانی و مستند می‌کند، و یکپارچه‌سازی WhatsApp Business Cloud API در NeuroCRM هم از همین استفاده می‌کند.

آیا می‌توانم شماره اپلیکیشن WhatsApp Business خودم را با API استفاده کنم؟

متا می‌گوید شماره‌ای که همین حالا در WhatsApp استفاده می‌شود، پیش از ثبت باید از WhatsApp حذف شود. از طریق NeuroCRM، استفاده هم‌زمان از یک شماره در اپلیکیشن و در API (coexistence) کار نمی‌کند.

چرا پیامم به مشتری نرسید؟

دو دلیل رایج دارد: پنجره 24 ساعته بسته شده بود و پیام قالبی نبود، یا وقتی پیام‌های خدمات رایگان تمام شد، روی حساب متا روش پرداختی ثبت نشده بود. در پنجره بسته، NeuroCRM متن ساده شما را نمی‌فرستد؛ اول یک قالب تأییدشده می‌فرستد و متن شما را در کادر پاسخ نگه می‌دارد.

آیا چند نفر می‌توانند از یک شماره API پاسخ دهند؟

بله. چت‌های یک شماره در NeuroCRM به یک صندوق ورودی مشترک می‌روند و می‌توانید چند شماره وصل کنید.

منابع

  • متا، قیمت‌گذاری WhatsApp Business Platform — https://developers.facebook.com/docs/whatsapp/pricing (بررسی‌شده در 18 نوامبر 2026)
  • متا، شروع کار با Cloud API — https://developers.facebook.com/docs/whatsapp/cloud-api/get-started (بررسی‌شده در 18 نوامبر 2026)
  • متا، شماره‌های تلفن — https://developers.facebook.com/docs/whatsapp/cloud-api/phone-numbers (بررسی‌شده در 18 نوامبر 2026)
  • اپلیکیشن WhatsApp Business — https://whatsappbusiness.com/products/business-app/ (بررسی‌شده در 18 نوامبر 2026)

این مطلب چگونه تهیه شده است: متن را تیم NeuroCRM با کمک هوش مصنوعی نوشته است؛ آنچه درباره محصول گفته شده با کد و راهنمای NeuroCRM تطبیق داده شده و قیمت‌ها از تعرفه منتشرشده در تاریخ به‌روزرسانی برداشته شده‌اند.