اتصال واتساپ (WhatsApp Business API)
در پنل: تنظیمات ← کارت WhatsApp Business API. راهنمای داخل کارت همین قدم‌ها را دارد، با دکمه‌ی کپی، پیوند مستقیم به صفحه‌ی اپ خودتان و تیک خودکار برای قدم‌هایی که برنامه خودش بررسی می‌کند. بالای کارت نوار سه‌مرحله‌ای «کلیدها درست ← webhook تأیید شد ← اولین پیام رسید» می‌گوید کجای کار هستید و اگر چیزی گیر کرده باشد، دلیلش را با رنگ قرمز می‌نویسد.
دو راه دارد و کارت خودش از روی شماره راه درست را نشان می‌دهد: شماره‌ی آزمایشی متا برای امتحان در ۱۰ دقیقه، یا شماره‌ی واقعی کسب‌وکار برای مشتری‌ها.
الف) شماره‌ی آزمایشی متا
- کادر «اپ متا» را پر کنید (آدرس اپ + App secret اصلی از App settings ← Basic). اپ تازه: use case «Connect with customers through WhatsApp»؛ یا همان اپ اینستاگرام.چه می‌بینید: کادر «اپ متا» سبز.⚠️ اشتباه رایج: Instagram app secret را این‌جا نچسبانید؛ واتساپ با App secret اصلی امضا می‌کند.
- Use case «Connect with customers through WhatsApp» ← Step 1 Try it out ← Continue (شرایط را می‌پذیرد). «Phone Number ID»، «WhatsApp Business Account ID» و توکن Generate token را در همین کارت بچسبانید و «ذخیره و تست».چه می‌بینید: شماره‌ی آزمایشی +1 555…، دو شناسه و دکمه‌ی Generate token.⚠️ اشتباه رایج: توکن Generate token فقط ۲۴ ساعت کار می‌کند؛ قدم «توکن دائمی» را فراموش نکنید.
- در همان صفحه «Recipient» ← Manage phone number list ← شماره‌ی موبایل خودتان را اضافه کنید و کد ۵ رقمی‌ای را که در واتساپ می‌آید بزنید.چه می‌بینید: فهرست گیرنده‌ها (حداکثر ۵ شماره).⚠️ اشتباه رایج: شماره‌ای که در این فهرست نیست با شماره‌ی آزمایشی هیچ پیامی رد و بدل نمی‌کند.
- این قدم را برنامه خودش انجام می‌دهد (با کادر «اپ متا»): Callback URL، Verify token و فیلد messages. فقط اگر خطا داد: Step 2 Production setup ← «Configure Webhooks»: ردیف‌های زیر را بچسبانید، «Verify and save»، بعد در جدول Webhook fields ردیف messages ← Subscribe.چه می‌بینید: «Callback URL»، «Verify token»، «Verify and save» و جدول «Webhook fields».⚠️ اشتباه رایج: Subscribe نکردن messages: webhook تأیید می‌شود ولی هیچ پیامی نمی‌رسد.
- در صفحه‌ی Try it out دکمه‌ی Send message را بزنید (به شماره‌ی خودتان)، بعد از گوشی به همان پیام جواب بدهید و «پیام آزمایشی فرستادم» را بزنید.چه می‌بینید: پیام «hello_world» از شماره‌ی آزمایشی در واتساپ گوشی شما؛ بعد جواب ربات.⚠️ اشتباه رایج: اول به شماره‌ی آزمایشی پیام دادن («این شماره واتساپ ندارد»): اول متا پیام می‌فرستد، شما جواب می‌دهید.
- توکن دائمی: business.facebook.com ← Settings ← System users ← Add (Admin) ← Assign assets: اپ (Full control) و حساب واتساپ (Full control) ← Generate token: Never، با whatsapp_business_messaging و whatsapp_business_management. آن را جای توکن همین کارت بچسبانید و «ذخیره و تست».چه می‌بینید: پنجره‌ی Generate token با انتخاب انقضا (Never) و فهرست دسترسی‌ها.⚠️ اشتباه رایج: Assign نکردن حساب واتساپ به System user: خطای «permission» می‌دهد.
ب) شماره‌ی واقعی کسب‌وکار
- کادر «اپ متا» را پر کنید (آدرس اپ + App secret اصلی از App settings ← Basic). اپ تازه: use case «Connect with customers through WhatsApp»؛ یا همان اپ اینستاگرام.چه می‌بینید: کادر «اپ متا» سبز.⚠️ اشتباه رایج: Instagram app secret را این‌جا نچسبانید؛ واتساپ با App secret اصلی امضا می‌کند.
- شماره‌ای آماده کنید که در اپ معمولی واتساپ فعال نیست: اگر هست، در همان گوشی واتساپ ← Settings ← Account ← Delete account.چه می‌بینید: شماره‌ای با کد کشور که پیامک یا تماس دریافت می‌کند.⚠️ اشتباه رایج: شماره‌ای که هنوز در اپ واتساپ است اضافه نمی‌شود؛ تاریخچه‌ی گفتگوهای آن اپ منتقل نمی‌شود.
- Step 2 Production setup ← Register your WhatsApp phone number ← Add phone number: نام نمایشی، کد پیامک/تماس، و یک PIN ۶ رقمی (تأیید دومرحله‌ای).چه می‌بینید: پنجره‌ی Add phone number؛ بعد «Display name» در حال بررسی (Pending).⚠️ اشتباه رایج: نام نمایشی که با نام برند یکی نیست رد می‌شود؛ PIN را جایی بنویسید (برای ثبت دوباره لازم است).
- توکن دائمی: business.facebook.com ← Settings ← System users ← Add (Admin) ← Assign assets: اپ (Full control) و حساب واتساپ (Full control) ← Generate token: Never، با whatsapp_business_messaging و whatsapp_business_management. آن را جای توکن همین کارت بچسبانید و «ذخیره و تست».چه می‌بینید: پنجره‌ی Generate token با انتخاب انقضا (Never) و فهرست دسترسی‌ها.⚠️ اشتباه رایج: Assign نکردن حساب واتساپ به System user: خطای «permission» می‌دهد.
- در صفحه‌ی واتساپ اپ، در «From» شماره‌ی واقعی را انتخاب کنید، «Phone Number ID» تازه را جای قبلی در همین کارت بچسبانید و «ذخیره و تست».چه می‌بینید: یک Phone Number ID متفاوت برای شماره‌ی واقعی.⚠️ اشتباه رایج: ماندن شناسه‌ی شماره‌ی آزمایشی در کارت.
- این قدم را برنامه خودش انجام می‌دهد (با کادر «اپ متا»): Callback URL، Verify token و فیلد messages. فقط اگر خطا داد: Step 2 Production setup ← «Configure Webhooks»: ردیف‌های زیر را بچسبانید، «Verify and save»، بعد در جدول Webhook fields ردیف messages ← Subscribe.چه می‌بینید: «Callback URL»، «Verify token»، «Verify and save» و جدول «Webhook fields».⚠️ اشتباه رایج: Subscribe نکردن messages: webhook تأیید می‌شود ولی هیچ پیامی نمی‌رسد.
- Production setup ← Add payment: فقط برای قالب‌ها (پیام بعد از ۲۴ ساعت) لازم است؛ جواب دادن به مشتری در ۲۴ ساعت رایگان است.چه می‌بینید: فرم افزودن روش پرداخت در WhatsApp Manager.⚠️ اشتباه رایج: انتظار فرستادن پیام آزاد بعد از ۲۴ ساعت: قانون خود واتساپ فقط قالب تأییدشده را اجازه می‌دهد.
- از یک گوشی دیگر به شماره‌ی واقعی پیام بدهید و «پیام آزمایشی فرستادم» را بزنید.چه می‌بینید: جواب ربات در واتساپ و گفتگو در «گفتگوها».⚠️ اشتباه رایج: ربات نمی‌تواند اول پیام بدهد؛ مشتری باید شروع کند (بعد ۲۴ ساعت فرصت جواب است).
- بعداً (اختیاری): Step 3 Business verification برای سقف پیام بیشتر (از ۲۵۰ به ۲٬۰۰۰ مشتری در روز) و شماره‌های بیشتر.چه می‌بینید: فرم مدارک کسب‌وکار در تنظیمات کسب‌وکار متا.⚠️ اشتباه رایج: برای جواب دادن به مشتری‌ها لازم نیست؛ فقط برای پیام انبوه.
📲 هشدار روی واتساپ شخصی خودم (اختیاری)
اگر به جای تلگرام از واتساپ استفاده می‌کنید، برنامه می‌تواند وقتی مشتری منتظر تیم است (و همین‌طور بعد از قدم «اطلاع به تیم» در یک فلو) به واتساپ شخصی شما خبر بدهد، با یک یادآوری اگر کسی جواب نداد. تا خودتان راهش نیندازید خاموش است؛ در صفحه‌ی کارها و پیگیری، کادر «هشدار روی واتساپ شخصی شما»:
- کارت واتساپ را (بالاتر) وصل کنید: هشدار از شماره‌ی ربات می‌آید.
- شماره‌ی واتساپ خودتان را با کد کشور بنویسید (نه شماره‌ی ربات). با شماره‌ی آزمایشی متا، شماره‌ی شما باید در فهرست گیرنده‌ها باشد.
- «فرستادن قالب هشدار به متا» را بزنید و صبر کنید تا وضعیت «تأیید شد» شود (معمولاً چند دقیقه تا یک روز).
- «فرستادن هشدار آزمایشی» را بزنید و بعد هشدار را روشن کنید. تا متا قالب را تأیید نکرده، کلید روشن نمی‌شود.
متا هر هشدار را با نرخ قالب Utility کشور شما حساب می‌کند. اگر هشداری فرستاده نشود (قالب رد شده، شماره‌ی شما در فهرست آزمایشی نیست، پرداخت متا فعال نیست)، کادر آن را با دلیل متا به رنگ قرمز نشان می‌دهد. زنگوله‌ی پنل همیشه همه‌ی هشدارها را دارد.