القنوات

ربط واتساب

خطوة بخطوة، من إنشاء تطبيق Meta لحد أول رسالة يرد عليها الوكيل الذكي على رقم واتساب بيزنس بتاعك.

بعد ما تخلص الصفحة دي، أي عميل يبعت على رقم واتساب بيزنس بتاعك هيوصل لصندوق المحادثات، والوكيل الذكي هيرد عليه على الواتساب نفسه. واتساب متاح في كل الباقات.

الربط بيتم من خلال تطبيق Meta بتاع وكالتك و WhatsApp Cloud API. الخطوات كتير شوية بس كل واحدة فيها بسيطة. خصص حوالي ساعة، وخلي جنبك موبايل عليه الرقم اللي هتربطه.

عايزنا نعملها بدالك؟

خدمة «تجهيز Meta» بنجهزلك فيها واتساب وماسنجر وإنستجرام بنفسنا: 1,500 جنيه أو 49 دولار مرة واحدة لباقات Starter و Growth، ومجانية في Pro. اطلبها من «الإعدادات ← الباقة والاشتراك» (الإضافات).

قبل ما تبدأ

  • حساب Meta Business (Business portfolio) لوكالتك على business.facebook.com، وإنت Admin فيه.
  • حساب مطوّر على developers.facebook.com بنفس حساب الفيسبوك.
  • رقم تليفون يستقبل SMS أو مكالمة عشان كود التفعيل.
  • في فلايباي: إنت مالك أو مدير الوكالة.

الرقم ده هيتنقل لـ Cloud API

الرقم اللي بيتسجل على WhatsApp Cloud API غالباً مينفعش يفضل شغال في تطبيق واتساب العادي على الموبايل في نفس الوقت. Meta بتقدّم خيار «coexistence» لأرقام تطبيق WhatsApp Business في بعض الدول، بس لو مش متأكد، الأسلم تستخدم رقم جديد مخصص للوكالة. فكّر في ده كويس قبل ما تنقل رقمك الأساسي.

الجزء الأول: جهّز تطبيق Meta والرقم

اعمل تطبيق Business

  1. ادخل developers.facebook.com/apps ودوس Create app.
  2. اكتب اسم للتطبيق (مثلاً «فلايباي - اسم وكالتك»)، وإيميل التواصل.
  3. اختار حالة الاستخدام (Use case) Connect with customers through WhatsApp، ولو اتسألت عن النوع اختار Business.
  4. اختار الـ Business portfolio بتاع وكالتك ودوس Create app.

ضيف رقم واتساب بيزنس

  1. من قائمة التطبيق افتح WhatsApp ← API Setup (في النسخة الجديدة من لوحة Meta: Use cases ← Customize ← API Setup).
  2. دوس Add phone number، واكتب الاسم اللي هيظهر للعملاء (Display name) ونوع النشاط.
  3. فعّل الرقم بالكود اللي هيوصلك SMS أو مكالمة.

عايز تجرب الأول؟

Meta بتديك رقم تجريبي (Test number) مجاني في نفس الصفحة. تقدر تربطه بفلايباي بنفس الخطوات، بس هو بيرد على 5 أرقام بالكتير بتضيفها من To ← Manage phone number list (وكل رقم بيتأكد بكود). أي حد تاني مش هيوصله رد، وفلايباي هيكتبلك «رقم Meta التجريبي: ضيف رقم العميل ده لقايمة الأرقام المسموحة في تطبيق Meta بتاعك». وبعد ما تتطمن، ضيف رقمك الحقيقي وحدّث الـ Phone number ID في فلايباي.

الرقم الحقيقي بيرد على الكل

برقمك انت، الوكيل الذكي وفريقك يقدروا يردوا على أي عميل يبعت الأول، من غير قايمة أرقام ولا App Review ولا Tech Provider: Meta بتعتبر الوكالة اللي بتستخدم رقمها مطوّر مباشر. ومش محتاج توثيق النشاط التجاري كمان، التوثيق بيرفع بس حدود الرسايل اللي انت بتبدأها (القوالب)، وفلايباي لسه مابيبعتهاش.

انسخ WhatsApp Business Account ID و Phone number ID

في نفس صفحة API Setup هتلاقي تحت الرقم:

  • Phone number ID: رقم طويل خاص بـ Meta. ده مش رقم تليفونك.
  • WhatsApp Business Account ID: رقم حساب واتساب بيزنس اللي الرقم تابع له (موجود كمان في WhatsApp Manager).

احفظهم في ملف ملاحظات، هتحتاجهم كمان شوية.

انسخ الـ App secret

  1. من قائمة التطبيق: App settings ← Basic.
  2. جنب App secret دوس Show، واكتب باسورد الفيسبوك لو اتطلب.
  3. انسخه.

فلايباي بيستخدم الـ App secret عشان يتأكد إن كل رسالة جاية فعلاً من Meta، مش من حد بيقلّدها.

الجزء التاني: توكن دائم من System user

التوكن ده هو «المفتاح» اللي بيخلّي فلايباي يقرا الرسايل ويرد بالنيابة عنك. لازم يكون دائم، عشان كده بنعمله من System user مش من حسابك الشخصي.

اعمل System user

  1. افتح business.facebook.com/settings.
  2. روح Business Settings ← Users ← System users ودوس Add.
  3. اكتب اسم (مثلاً «Flyby») واختار الدور Admin، ودوس Create system user.

اديله صلاحية على التطبيق وحساب الواتساب

وهو مختار، دوس Assign assets (أو Add assets):

  1. Apps ← اختار تطبيقك ← فعّل Manage app (تحكم كامل).
  2. WhatsApp accounts ← اختار حساب واتساب بيزنس ← فعّل تحكم كامل (Full control).
  3. دوس Save changes.

اعمل التوكن

  1. دوس Generate new token واختار تطبيقك.
  2. في Token expiration اختار Never.
  3. علّم على الأذونات دي:
    • whatsapp_business_messaging
    • whatsapp_business_management
    • business_management (اختياري)
  4. دوس Generate token وانسخه فوراً: Meta مش هتوريهولك تاني.

أشهر غلطة

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

الجزء التالت: اربط في فلايباي

شغّل واتساب بيزنس

افتح «الإعدادات ← القنوات والربط» وشغّل مفتاح واتساب بيزنس. هيظهرلك جزء «الـ Webhook (الصقه في تطبيق Meta)» فيه Callback URL و Verify token، وتحته خانات البيانات.

الصق البيانات

الخانة في فلايبايجبتها منين
توكن مستخدم النظام (System user)التوكن اللي عملته في الجزء التاني
App secretApp settings ← Basic
WhatsApp Business Account IDWhatsApp ← API Setup
Phone number IDWhatsApp ← API Setup

دوس «ربط»

فلايباي هيتأكد إن الرقم تابع لحساب الواتساب ده، وهيشترك تطبيقك في رسايل الحساب، وهيسجّل الـ Callback URL في Meta تلقائياً. لو كله تمام هتظهر رسالة «تم الربط مع Meta» والبادج يبقى مربوط، واسم الرقم يظهر تحت «واتساب بيزنس».

التوكن والسر بيتشفّروا

بعد الحفظ، التوكن والـ App secret بيتحفظوا مشفّرين ومش بيظهروا تاني. لو حبيت تعدّل حاجة تانية سيب خاناتهم فاضية والقيمة القديمة هتفضل زي ما هي. الزرار بعد كده اسمه «حفظ واختبار».

أكّد الـ Webhook في Meta

حتى لو التسجيل التلقائي نجح، كمّل الخطوة دي عشان تضمن إن الرسايل شغالة:

  1. في تطبيق Meta افتح WhatsApp ← Configuration.
  2. في جزء Webhook دوس Edit، والصق Callback URL و Verify token من فلايباي (فيه زرار نسخ جنب كل واحد).
  3. دوس Verify and save.
  4. تحت Webhook fields دوس Manage وفعّل Subscribe جنب messages.

لو ظهرلك تنبيه «اتربط، بس معرفناش نظبط رابط الـ Webhook تلقائي»، الخطوة دي إجبارية.

حوّل التطبيق لـ Live

في أعلى لوحة التطبيق، حوّل App Mode من Development لـ Live. Meta مش بتبعت بعض الـ Webhooks والتطبيق في وضع Development.

Meta هتطلب منك Privacy Policy URL في App settings ← Basic قبل التحويل. حط لينك سياسة الخصوصية بتاعة وكالتك (على موقعك).

مش محتاج App Review لواتساب: التطبيق بيخدم رقمك انت. ومن غير توثيق النشاط التجاري لسه تقدر ترد على كل العملاء، التوثيق بيرفع بس حدود الرسايل اللي بتبدأها انت (250 شخص في اليوم من غير توثيق) وعدد الأرقام (2).

جرّب الربط

  1. من موبايل تاني (مش الرقم المربوط) ابعت «السلام عليكم، عايز أسعار عمرة» على رقم الواتساب.
  2. في فلايباي، تحت الـ Callback URL، «آخر حدث» المفروض يتحدّث بتاريخ دلوقتي.
  3. افتح المحادثات: هتلاقي محادثة جديدة بقناة واتساب، والوكيل رد خلال ثواني. على موبايل العميل هيظهر إن الرسالة اتقرت و«بيكتب…» قبل الرد.

العملاء هيبعتوا إيه؟

  • الرسايل النصية والأزرار بيقراها الوكيل ويرد عليها.
  • الصور والفويس والفيديو والملفات والملصقات والمواقع وجهات الاتصال بتظهر في المحادثة كوصف قصير (زي «📷 صورة» أو «🎤 رسالة صوتية») عشان فريقك يعرف إن العميل بعت حاجة ويتابع معاه.
  • الرسايل الطويلة من الوكيل بتتقسم تلقائياً لو عدّت حد واتساب.

قاعدة الـ 24 ساعة

تقدر ترد رد حر بس خلال 24 ساعة من آخر رسالة من العميل. بعد كده واتساب بيطلب قوالب معتمدة، وفلايباي لسه مش بيبعت قوالب، فالرسالة هتفشل لحد ما العميل يكتب تاني. اقرا نافذة الرسايل.

لو حاجة مش شغالة

لسه فيه مشكلة؟ ابعتلنا على support@flyby.world ومعاك نص رسالة الخطأ.

الخطوة الجاية

في الصفحة دي