ربط واتساب (WhatsApp Business API)

في اللوحة: الإعدادات ← بطاقة WhatsApp Business API. يحتوي الدليل داخل البطاقة على هذه الخطوات نفسها، مع زر النسخ ورابط مباشر لصفحة تطبيقك وعلامة تلقائية للخطوات التي يتحقق منها البرنامج بنفسه. وفي أعلى البطاقة شريط من ثلاث مراحل «المفاتيح صحيحة ← تم تأكيد webhook ← وصلت أول رسالة» يبيّن أين أنت، ويكتب السبب بالأحمر إذا تعطّل شيء.

له طريقان وتعرض البطاقة الطريق الصحيح بنفسها حسب الرقم: رقم Meta التجريبي للتجربة في 10 دقائق، أو الرقم الحقيقي للنشاط للعملاء.

أ) رقم Meta التجريبي

1. املأ مربع «تطبيق Meta» (عنوان التطبيق + App secret الرئيسي من App settings ← Basic). تطبيق جديد: حالة الاستخدام «Connect with customers through WhatsApp»؛ أو تطبيق إنستغرام نفسه.ما الذي تراه: مربع «تطبيق Meta» أخضر.⚠️ خطأ شائع: لا تلصق Instagram app secret هنا؛ واتساب يوقّع بـ App secret الرئيسي.
2. حالة الاستخدام «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 يعمل 24 ساعة فقط؛ لا تنسَ خطوة «الرمز الدائم».
3. في الصفحة نفسها «Recipient» ← Manage phone number list ← أضف رقم جوالك وأدخل الرمز المكوّن من 5 أرقام الذي يصل على واتساب.ما الذي تراه: قائمة المستلمين (5 أرقام كحد أقصى).⚠️ خطأ شائع: الرقم غير الموجود في هذه القائمة لا يتبادل أي رسالة مع الرقم التجريبي.
4. هذه الخطوة يقوم بها البرنامج بنفسه (بمربع «تطبيق Meta»): 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».⚠️ خطأ شائع: عدم الاشتراك في messages: يتأكد webhook لكن لا تصل أي رسالة.
5. في صفحة Try it out اضغط Send message (إلى رقمك)، ثم ردّ على تلك الرسالة من هاتفك واضغط «أرسلت رسالة تجريبية».ما الذي تراه: رسالة «hello_world» من الرقم التجريبي على واتساب هاتفك؛ ثم رد البوت.⚠️ خطأ شائع: مراسلة الرقم التجريبي أولاً («هذا الرقم ليس على واتساب»): ترسل Meta أولاً ثم تردّ أنت.
6. الرمز الدائم: 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) وقائمة الصلاحيات.⚠️ خطأ شائع: عدم تعيين حساب واتساب للـ System user: يظهر خطأ «permission».

ب) الرقم الحقيقي للنشاط

1. املأ مربع «تطبيق Meta» (عنوان التطبيق + App secret الرئيسي من App settings ← Basic). تطبيق جديد: حالة الاستخدام «Connect with customers through WhatsApp»؛ أو تطبيق إنستغرام نفسه.ما الذي تراه: مربع «تطبيق Meta» أخضر.⚠️ خطأ شائع: لا تلصق Instagram app secret هنا؛ واتساب يوقّع بـ App secret الرئيسي.
2. جهّز رقماً غير مفعّل في تطبيق واتساب العادي: إن كان مفعّلاً ففي الهاتف نفسه واتساب ← Settings ← Account ← Delete account.ما الذي تراه: رقم برمز الدولة يستقبل الرسائل النصية أو المكالمات.⚠️ خطأ شائع: الرقم الذي ما زال في تطبيق واتساب لا يُضاف؛ ولا تنتقل محادثات ذلك التطبيق.
3. Step 2 Production setup ← Register your WhatsApp phone number ← Add phone number: اسم العرض، ورمز الرسالة/المكالمة، وPIN من 6 أرقام (التحقق بخطوتين).ما الذي تراه: نافذة Add phone number؛ ثم «Display name» قيد المراجعة (Pending).⚠️ خطأ شائع: اسم العرض المختلف عن اسم العلامة يُرفض؛ اكتب الـ PIN في مكان آمن (يلزم لإعادة التسجيل).
4. الرمز الدائم: 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) وقائمة الصلاحيات.⚠️ خطأ شائع: عدم تعيين حساب واتساب للـ System user: يظهر خطأ «permission».
5. في صفحة واتساب للتطبيق اختر الرقم الحقيقي في «From»، والصق «Phone Number ID» الجديد مكان القديم في هذه البطاقة و«حفظ واختبار».ما الذي تراه: Phone Number ID مختلف للرقم الحقيقي.⚠️ خطأ شائع: بقاء معرّف الرقم التجريبي في البطاقة.
6. هذه الخطوة يقوم بها البرنامج بنفسه (بمربع «تطبيق Meta»): 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».⚠️ خطأ شائع: عدم الاشتراك في messages: يتأكد webhook لكن لا تصل أي رسالة.
7. Production setup ← Add payment: يلزم فقط للقوالب (رسالة بعد 24 ساعة)؛ الرد على العميل خلال 24 ساعة مجاني.ما الذي تراه: نموذج إضافة طريقة دفع في WhatsApp Manager.⚠️ خطأ شائع: توقّع إرسال رسالة حرة بعد 24 ساعة: قاعدة واتساب تسمح فقط بقالب معتمد.
8. أرسل رسالة إلى الرقم الحقيقي من هاتف آخر واضغط «أرسلت رسالة تجريبية».ما الذي تراه: رد البوت على واتساب والمحادثة في «المحادثات».⚠️ خطأ شائع: لا يمكن للبوت أن يبدأ؛ يجب أن يبدأ العميل (ثم توجد 24 ساعة للرد).
9. لاحقاً (اختياري): Step 3 Business verification لحدّ رسائل أعلى (من 250 إلى 2000 عميل يومياً) وأرقام أكثر.ما الذي تراه: نموذج مستندات النشاط في إعدادات النشاط في Meta.⚠️ خطأ شائع: غير لازم للرد على العملاء؛ فقط للرسائل الجماعية.

📲 التنبيهات على واتساب الشخصي (اختياري)

إذا كنت تستخدم واتساب بدل تيليجرام، يستطيع البرنامج إبلاغ واتسابك الشخصي عندما يكون عميل بانتظار الفريق (وأيضاً بعد خطوة «إبلاغ الفريق» في مسار)، مع تذكير واحد إذا لم يرد أحد. يبقى متوقفاً حتى تضبطه في صفحة المهام والمتابعة، في مربع «التنبيهات على واتساب الشخصي»:

1. اربط بطاقة واتساب أعلاه: يصل التنبيه من رقم البوت.
2. اكتب رقم واتسابك مع رمز الدولة (ليس رقم البوت). مع رقم Meta التجريبي يجب أن يكون رقمك في قائمة المستلمين.
3. اضغط «إرسال قالب التنبيه إلى Meta» وانتظر حتى تظهر الحالة «تمت الموافقة» (عادةً من دقائق إلى يوم).
4. اضغط «إرسال تنبيه تجريبي» ثم فعّل التنبيهات. لا يقبل المفتاح التفعيل قبل موافقة Meta على القالب.

تحتسب Meta كل تنبيه بسعر قالب Utility في بلدك. إذا تعذّر إرسال تنبيه (القالب مرفوض، رقمك ليس في قائمة الاختبار، الفوترة في Meta غير مفعّلة) يظهر ذلك في المربع باللون الأحمر مع سبب Meta. الجرس في اللوحة يحتفظ دائماً بكل التنبيهات.