العنوان العام

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

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

الوضع «مؤقت» للتجربة فقط: يتغيّر عنوانه مع كل تشغيل، وتحتفظ Meta بالعنوان القديم فتضيع الرسائل. اتبع أحد الطريقين: نفق Cloudflare بنطاقك (كل شيء ثابت؛ يأتي مع البرنامج) أو ngrok بنطاق ثابت مجاني (ngrok لا يأتي مع البرنامج: تثبّته بنفسك).

الطريق 1: نفق Cloudflare بنطاقك (الرسائل وروابط العملاء ثابتة معاً)

1. أنشئ حساباً في Cloudflare وأضف نطاقك إليه (Domains ← Onboard a domain).ما الذي تراه: صفحة التسجيل في Cloudflare، ثم قائمة Domains وحالة نطاقك Active.⚠️ خطأ شائع: النطاق المشترى من مكان آخر يجب أن يأخذ name servers الخاصة بـ Cloudflare أولاً؛ لا يعمل النفق عليه حتى تكتب Cloudflare «Active».
2. Networking ← Tunnels ← Create a tunnel، أعطه اسماً (مثل dmaipro) واضغط Create Tunnel. اختر نظام هذا الكمبيوتر (Windows أو Mac أو Linux — أيّها لا يهم)، وانسخ أمر التثبيت المعروض والصقه في خانة «رمز نفق Cloudflare» في هذه البطاقة.ما الذي تراه: أمر مثل cloudflared service install eyJ… مع سلسلة طويلة.⚠️ خطأ شائع: تشغيل ذلك الأمر على هذا الكمبيوتر — لا حاجة لذلك؛ البرنامج يشغّل النفق بنفسه. لصق الأمر كاملاً لا بأس به، فالبرنامج يستخرج الرمز.
3. في النفق نفسه: Routes ← Add route ← Published application. اختر Subdomain (مثل bot) ونطاقك، واكتب في Service URL http://127.0.0.1:8000 ثم اضغط Add route.ما الذي تراه: نموذج Published application بخانات Subdomain وDomain وService URL.⚠️ خطأ شائع: منفذ غير 8000 أو https في Service URL — عندها يعيد العنوان خطأ ويقول البرنامج «لا يصل إلى هذا البرنامج».
4. في هذه البطاقة اختر طريقة «نفق Cloudflare»، واكتب العنوان الكامل (مثل bot.example.com) في خانة «عنوانك في Cloudflare» واضغط «حفظ واختبار». يسجّل البرنامج العنوان الجديد بنفسه في تيليجرام وواتساب وإنستغرام.ما الذي تراه: تحت البطاقة: «العنوان الحالي» هو عنوانك و«العنوان ثابت.»⚠️ خطأ شائع: نسيان عناوين Meta: بعد هذه الخطوة الصق عناوين الخصوصية وحذف البيانات وOAuth مجدداً في لوحة Meta (البرنامج يغيّر الـ webhooks فقط بنفسه).

المنفذ العام للبرنامج افتراضياً 8000 (إن غيّرته في .env فاستخدم ذلك الرقم).

الطريق 2: ngrok بنطاق ثابت مجاني (عنوان الرسائل فقط ثابت)

1. ثبّت ngrok بنفسك من موقعه الرسمي ngrok.com (لا يأتي مع البرنامج) وأنشئ فيه حساباً مجانياً.ما الذي تراه: صفحة التسجيل في ngrok (Sign up).⚠️ خطأ شائع: بريد إلكتروني ستفقده لاحقاً؛ ومع تشغيل VPN قد يفشل التسجيل.
2. انسخ الرمز، واختر في هذه البطاقة طريقة «ngrok بنطاق ثابت» والصقه في خانة «ngrok authtoken».ما الذي تراه: صفحة «Your Authtoken» مع رمز طويل وزر Copy.⚠️ خطأ شائع: نسخ الأمر كاملاً ngrok config add-authtoken … — لا بأس، البرنامج يستخرج الرمز بنفسه.
3. انسخ نطاقك الثابت المجاني (إن لم يوجد فاضغط «Create domain»)، والصقه في خانة «نطاق ngrok الثابت» واضغط «حفظ واختبار».ما الذي تراه: نطاق مثل name.ngrok-free.app.⚠️ خطأ شائع: لا تقلق بشأن https://، يُقبل معه أو بدونه. بعد هذه الخطوة انسخ عناوين Meta مرة أخرى.

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

روابط العملاء مع ngrok: خيار «روابط العملاء (النماذج، الدفع)» في هذه البطاقة يحدد إلى أين تشير روابط النماذج والدفع. على العنوان المؤقت (الافتراضي، كما كان): بلا صفحة تنبيه ngrok، لكن الروابط المرسلة سابقاً تتوقف بعد إعادة تشغيل الكمبيوتر. على هذا العنوان الثابت: تبقى الروابط السابقة صالحة، لكن ngrok المجاني يعرض أولاً صفحته «Visit Site» التي قد لا تُفتح داخل متصفح إنستغرام أو واتساب — جرّب رابطاً من هاتفك قبل الاختيار. روابط ثابتة بلا أي صفحة تنبيه: وضع «نطاقي أو عنواني الخاص» (نطاقك أو Cloudflare named tunnel).