دليل ربط رقم واتساب شركتك

هذا الدليل يوصلك من الصفر لين يشتغل صندوقك ويستقبل ويرسل رسائل. ياخذ تقريباً 30–60 دقيقة أول مرة. في كل الدليل: company = اسم رابط شركتك اللي اخترته وقت التسجيل، يعني صندوقك على https://company.wa.alkhalf.com.

المتطلبات

• حساب فيسبوك شخصي (للدخول فقط — ما يظهر للعملاء).
• Meta Business Portfolio (حساب أعمال) من business.facebook.com باسم شركتك.
• رقم جوال أو ثابت غير مسجّل حالياً في تطبيق واتساب. لو الرقم شغال على واتساب أو واتساب أعمال: احذف الحساب من التطبيق أولاً (الإعدادات ← الحساب ← حذف الحساب)، أو انقله من شركة مزود سابقة.
• بطاقة دفع (Visa / Mastercard / مدى) لرسائل القوالب.
• موقع إلكتروني أو صفحة "سياسة الخصوصية" (تطلبها Meta لتشغيل التطبيق).

1. أنشئ تطبيق Meta

1. ادخل developers.facebook.com/apps ← Create app.
2. اختر حالة الاستخدام Connect with customers through WhatsApp (أو النوع Business).
3. اكتب اسم التطبيق (مثلاً: اسم شركتك Inbox) واربطه بـ Business Portfolio حق شركتك.
4. بعد الإنشاء، من القائمة الجانبية افتح WhatsApp ← API Setup.

2. أضف رقم الشركة

1. في API Setup ← Add phone number.
2. اكتب اسم العرض (Display name) — لازم يطابق اسم شركتك أو علامتها التجارية، وإلا ينرفض.
3. اختر التصنيف، ثم أدخل الرقم وفعّله برمز SMS أو مكالمة.
4. بعد الإضافة انسخ من نفس الصفحة:
   • Phone number ID
   • WhatsApp Business Account ID (WABA ID)

3. التوكن الدائم (System User)

التوكن المؤقت اللي يطلع في API Setup ينتهي خلال 24 ساعة. سوّ توكن دائم:

1. ادخل إعدادات الأعمال ← Users ← System users ← Add ← اسم (مثل inbox) والدور Admin.
2. اضغط Assign assets:
   • Apps ← تطبيقك ← Full control.
   • WhatsApp accounts ← حسابك ← Full control.
3. اضغط Generate new token ← اختر التطبيق ← المدة Never ← فعّل الصلاحيات: whatsapp_business_messaging و whatsapp_business_management.
4. انسخ التوكن واحفظه (يطلع مرة وحدة).

وانسخ App Secret: تطبيقك ← App settings ← Basic ← App secret ← Show.

4. حط البيانات في صندوقك

1. ادخل صندوقك https://company.wa.alkhalf.com بحساب المدير.
2. الإعدادات ← ربط واتساب وعبّي: Phone number ID، WABA ID، Access token، App Secret ← حفظ.
3. في نفس الصفحة بتلقى Callback URL و Verify token — انسخهم للخطوة الجاية.

5. اربط الـ Webhook (استقبال الرسائل)

1. في تطبيق Meta ← WhatsApp ← Configuration ← Webhook ← Edit.
2. Callback URL: https://company.wa.alkhalf.com/webhook
3. Verify token: نفس اللي في صندوقك ← Verify and save.
4. تحت Webhook fields ← فعّل messages (Subscribe).

تأكد من كل شي من الإعدادات ← فحص Meta في صندوقك: يفحص التوكن، الرقم، ارتباطه بالحساب، الاشتراك، والقوالب.

6. التشغيل الفعلي (Live)

1. تطبيقك ← App settings ← Basic: أضف Privacy policy URL واختر التصنيف.
2. من أعلى الصفحة غيّر وضع التطبيق من Development إلى Live. بدون هذا ما توصلك رسائل العملاء الحقيقية.
3. (ينصح) وثّق نشاطك من إعدادات الأعمال ← Security Center ← Business verification — يرفع حد الإرسال اليومي ويخلي اسمك يظهر.

7. وسيلة الدفع لـ Meta

1. ادخل WhatsApp Manager ← Account tools ← Payment settings.
2. حدد الدولة والعملة (ما تتغير بعدين بسهولة) وأضف البطاقة.

8. القوالب (أول رسالة للعميل)

ما تقدر تبدأ محادثة مع عميل (أو ترد بعد 24 ساعة من آخر رسالة منه) إلا بـ قالب معتمد. أنشئه من WhatsApp Manager ← Message templates:

• Utility: إشعارات معاملات (طلب، موعد، فاتورة، توثيق) — الأرخص. Marketing: عروض وترحيب ودعايات — الأغلى. Authentication: رموز تحقق فقط.
• المتغيرات {{1}} {{2}}: لا تحطها في أول أو آخر النص، ولا تخلي النص قصير مع متغيرات كثيرة — Meta يرفضه.
• عبارات الترحيب والعروض في قالب Utility تخلي Meta يحوّله Marketing.
• الأزرار: رد سريع (العميل يضغط ويوصلك رده، ويفتح محادثة مجانية 24 ساعة) أو رابط (ثابت أو آخره متغير).
• بعد الاعتماد يظهر القالب تلقائياً في صندوقك (إرسال لعميل، الرسائل الجماعية، الربط API).

9. الفريق والبوت

1. الإعدادات ← الأقسام: أنشئ أقسامك (مبيعات، دعم…).
2. الإعدادات ← الموظفين: أضف كل موظف وحدد أقسامه وصلاحيته (مدير / مشرف / موظف).
3. الإعدادات ← البوت: رسالة الترحيب، القائمة، أوقات الدوام، ورد خارج الدوام.
4. (حسب باقتك) الذكاء الاصطناعي، الرسائل الجماعية، الربط API مع نظامك.
5. تطبيق الجوال: افتح رابط صندوقك من متصفح الجوال ← "إضافة إلى الشاشة الرئيسية".

حل المشاكل الشائعة

• Verify and save يفشل: تأكد إن Verify token مطابق وإنك ضغطت حفظ في الصندوق قبل، وإن الرابط ينتهي بـ /webhook.
• الرسائل ما توصل الصندوق: التطبيق مو Live، أو حقل messages مو مفعّل، أو الرقم غير تابع لنفس الـ WABA — شغّل "فحص Meta".
• 131042: وسيلة الدفع أو العملة غير محددة (الخطوة 7).
• 131047: مرت 24 ساعة على آخر رسالة من العميل — أرسل قالب.
• 132001: اسم القالب أو لغته غلط، أو القالب في حساب WABA ثاني.
• 133010: الرقم غير مسجّل في Cloud API — أكمل تسجيله من API Setup.
• 190 / Invalid OAuth token: التوكن منتهي — استخدم توكن System User الدائم (الخطوة 3).
• 131056 / حد الإرسال: أرسلت كثير لنفس العميل بوقت قصير، أو وصلت حد الرقم اليومي (يرتفع مع جودة الرسائل والتوثيق).

الصندوق نفسه يعرض أي خطأ تقني في التنبيهات مع شرح بالعربي وش تسوي.