تطبيق أتمتة واتساب في ڤاريونس: التثبيت والربط والقوالب وتأكيد الطلبات
تطبيق أتمتة واتساب هو بطاقة id whatsapp في السوق تفتح مسار /dashboard/whatsapp: يربط رقم واتساب للأعمال عبر تسجيل دخول Meta، ويرسل تأكيدات الطلبات بقوالب معتمدة، ويستقبل ردود العميل عبر Webhook، مع أزرار للاتصال والفصل والمزامنة والتفاصيل.
آخر تحقق: 2026-09-19
يثبَّت التطبيق من سوق /dashboard/apps بزر تثبيت على بطاقة «أتمتة واتساب» المميزة بشارة Featured، ثم يظهر زر فتح ينقل إلى /dashboard/whatsapp. والبطاقة نفسها تعرض الاسم المترجم واسم المطور Vareons والوصف «ربط واتساب الأعمال، تأكيد الطلبات، والرسائل التلقائية» مع شارة سعر مجاني.
داخل التطبيق تبدأ الصفحة بعنوان «واتساب الذكي» وخانة قبول الشروط وسياسة الخصوصية، ثم زر «ربط واتساب» الذي يبقى معطلاً حتى قبول الشروط وتوفر متغيرات NEXT_PUBLIC_FACEBOOK_APP_ID وNEXT_PUBLIC_WHATSAPP_CONFIG_ID والعمل عبر HTTPS. وعند الضغط يُحوَّل المتصفح كاملاً إلى حوار OAuth في facebook.com بإصدار الرسم البياني الحالي مع معامل config_id وحالة محفوظة في sessionStorage، ثم يعود برمز code يُرسل مع redirect_uri إلى POST /api/whatsapp/callback.
بعد الربط تعرض كل بطاقة حساب حالته (متصل أو منقطع) وتاريخ الاتصال وزر «عرض التفاصيل» الذي يجلب GET /api/whatsapp/account-details?phoneNumberId= ويفتح حواراً بثلاث لوحات: نظرة عامة على الرقم، وصحة Webhook، والقوالب مع زر «إعادة نشر القوالب الآن» الذي يستدعي POST /api/whatsapp/redeploy-templates. وزر «إعادة مزامنة Webhook» يستدعي POST /api/whatsapp/subscribe-webhooks لتصحيح الاشتراك ومسار الاسترجاع، وزر «فصل الاتصال» الأحمر يطلب تأكيد المتصفح ثم POST /api/whatsapp/disconnect برقم الهاتف.
إعدادات تأكيد الطلب تظهر فقط عند وجود حساب متصل: حوار بمفتاح تفعيل رسائل التأكيد واختيار اللغة العربية أو الإنجليزية مع زر حفظ يستدعي POST /api/whatsapp/order-confirmation-settings. وعند إنشاء طلب يُرسل القالب المناسب (order_confirmation_ar أو en) ثم تصل ردود العميل (تأكيد أو إلغاء أو تعديل) عبر Webhook لتُحدَّث سجلات WhatsAppOrderConfirmation وحالة الطلب.
تُخزَّن البيانات في نماذج WhatsAppAccount (بمفتاح التاجر ورقم الهاتف) وWhatsAppTemplate وWhatsAppChat وWhatsAppMessage وWhatsAppOrderConfirmation، بينما تعيش المنطق في أربعة وعشرين ملفاً تحت lib/whatsapp تشمل الخدمة والرمز المميز وتفاصيل الحساب ومعاملات القوالب ومعالجة Webhook والتوقيع وبناء مسار الاسترجاع وسجل التشخيص.
خطوات الإعداد في ڤاريونس
ثبّت التطبيق من السوق
افتح /dashboard/apps واضغط تثبيت على بطاقة أتمتة واتساب، ثم اضغط فتح للانتقال إلى /dashboard/whatsapp.
اقبل الشروط واربط الرقم
فعّل خانة قبول الشروط والخصوصية ثم اضغط ربط واتساب لإتمام تسجيل دخول Meta والعودة بالرمز إلى POST /api/whatsapp/callback.
راجع التفاصيل والقوالب
اضغط عرض التفاصيل لفتح النظرة العامة وصحة Webhook والقوالب، واستخدم إعادة نشر القوالب الآن عند الحاجة.
فعّل تأكيد الطلبات
من إعدادات تأكيد الطلب فعّل المفتاح واختر العربية أو الإنجليزية ثم احفظ ليُرسل القالب مع كل طلب جديد.
راقب الردود والمزامنة
تصل ردود العميل عبر Webhook لتحديث الطلب، واستخدم إعادة مزامنة Webhook عند انقطاع الاستقبال وفصل الاتصال عند تغيير الرقم.
أسئلة شائعة
هل تطبيق واتساب مجاني؟
نعم، بطاقة التطبيق في السوق بشارة مجاني ونوع فوترة free، والتثبيت لا يتطلب شراء.
لماذا زر ربط واتساب معطل؟
يبقى معطلاً حتى تقبل الشروط وتتوفر متغيرات تطبيق فيسبوك وإعدادات واتساب ويُفتح الموقع عبر HTTPS.
كيف أصلح توقف استقبال الردود؟
اضغط إعادة مزامنة Webhook من بطاقة الحساب؛ يعيد الاشتراك ويصحح مسار الاسترجاع. وراجع لوحة صحة Webhook من عرض التفاصيل.
هل يمكن تغيير لغة رسائل التأكيد؟
نعم، من إعدادات تأكيد الطلب اختر العربية أو الإنجليزية ثم احفظ؛ يُرسل القالب المطابق مع الطلبات الجديدة.
ماذا يحدث عند فصل الاتصال؟
بعد تأكيد المتصفح يُرسل POST /api/whatsapp/disconnect برقم الهاتف فتتوقف الرسائل التلقائية ويمكن ربط رقم آخر.
أين تُحفظ بيانات واتساب؟
في نماذج الحساب والقوالب والمحادثات والرسائل وتأكيدات الطلبات، مع سجلات تشخيص للفشل وتتبع حالة التسليم.
استكشاف الأخطاء
1) زر الربط معطل: اقبل الشروط وتأكد من متغيرات فيسبوك وHTTPS. 2) فشل الاسترجاع بعد Meta: أعد إرسال الرمز عبر تحديث الصفحة وإعادة الربط. 3) لا تصل الردود: استخدم إعادة مزامنة Webhook وراجع لوحة الصحة. 4) القوالب قديمة: استخدم إعادة نشر القوالب الآن من حوار التفاصيل. 5) رسالة غير متاح في باقتك تعني وضع disabled لخطتك في الكتالوج.
حدود مهمة
• يتطلب حساب WhatsApp Business وتطبيق Meta بصلاحيات صحيحة. • الرسائل المُبادَر بها من التاجر تعتمد قوالب Meta المعتمدة ونافذة الأربع والعشرين ساعة. • الحساب الواحد برقم هاتف واحد؛ التبديل يتطلب فصلاً ثم ربطاً جديداً. • تسليم الرسائل يعتمد على Meta ولا يضمنه ڤاريونس وحده.