آدرس عمومی
در پنل: تنظیمات ← کارت آدرس عمومی. راهنمای داخل کارت همین قدم‌ها را دارد، با دکمه‌ی کپی، پیوند مستقیم به صفحه‌ی اپ خودتان و تیک خودکار برای قدم‌هایی که برنامه خودش بررسی می‌کند. بالای کارت نوار سه‌مرحله‌ای «کلیدها درست ← webhook تأیید شد ← اولین پیام رسید» می‌گوید کجای کار هستید و اگر چیزی گیر کرده باشد، دلیلش را با رنگ قرمز می‌نویسد.
با یک کلیک: اگر دکمه‌ی گرفتن آدرس ثابت روی کارت هست، همین کامپیوتر خودش یک آدرس ثابت می‌گیرد؛ بدون حساب Cloudflare و دامنه‌ی شما. وگرنه یکی از دو راه زیر را بروید.
حالت «موقت» فقط برای امتحان است: آدرسش با هر بار روشن شدن عوض می‌شود، متا آدرس قدیمی را نگه می‌دارد و پیام‌ها گم می‌شوند. یکی از این دو راه را بروید: تونل Cloudflare با دامنه‌ی خودتان (همه‌چیز ثابت؛ همراه برنامه است) یا ngrok با دامنه‌ی ثابت رایگان (ngrok همراه برنامه نیست: خودتان نصبش می‌کنید).
راه ۱: تونل Cloudflare با دامنه‌ی خودتان (پیام‌ها و لینک‌های مشتری هر دو ثابت)
- در Cloudflare حساب بسازید و دامنه‌ی خود را به آن اضافه کنید (Domains ← Onboard a domain).چه می‌بینید: صفحه‌ی ثبت‌نام Cloudflare، بعد فهرست Domains با وضعیت Active برای دامنه‌ی شما.⚠️ اشتباه رایج: دامنه‌ای که جای دیگری خریده‌اید باید اول name serverهای Cloudflare را بگیرد؛ تا Cloudflare «Active» ننوشته، تونل روی آن کار نمی‌کند.
- Networking ← Tunnels ← Create a tunnel، یک نام بدهید (مثلاً dmaipro) و Create Tunnel را بزنید. سیستم این کامپیوتر را انتخاب کنید (Windows، Mac یا Linux — هر کدام باشد فرقی نمی‌کند)، دستور نصبی که نشان می‌دهد را کپی کنید و در کادر «توکن تونل Cloudflare» همین کارت بچسبانید.چه می‌بینید: دستوری مثل cloudflared service install eyJ… با یک رشته‌ی بلند.⚠️ اشتباه رایج: اجرا کردن آن دستور روی این کامپیوتر — لازم نیست؛ برنامه تونل را خودش اجرا می‌کند. چسباندن کل دستور اشکالی ندارد، برنامه توکن را جدا می‌کند.
- در همان تونل: 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 — آن‌وقت آدرس خطا برمی‌گرداند و برنامه می‌گوید «به این برنامه نمی‌رسد».
- در همین کارت روش «تونل Cloudflare» را بگذارید، آدرس کامل (مثلاً bot.example.com) را در کادر «آدرس شما در Cloudflare» بنویسید و «ذخیره و تست» را بزنید. برنامه آدرس تازه را خودش در تلگرام، واتساپ و اینستاگرام ثبت می‌کند.چه می‌بینید: زیر کارت: «آدرس فعلی» برابر آدرس شما و «آدرس ثابت است.»⚠️ اشتباه رایج: فراموش کردن آدرس‌های متا: بعد از این قدم آدرس‌های حریم خصوصی، حذف داده و OAuth را دوباره در داشبورد متا بچسبانید (برنامه فقط webhookها را خودش عوض می‌کند).
پورت عمومی برنامه به‌طور پیش‌فرض 8000 است (اگر در .env عوض کرده‌اید، همان عدد).
راه ۲: ngrok با دامنه‌ی ثابت رایگان (فقط آدرس پیام‌ها ثابت)
- ngrok را خودتان از سایت رسمی ngrok.com نصب کنید (همراه برنامه نیست) و در آن یک حساب رایگان بسازید.چه می‌بینید: صفحه‌ی ثبت‌نام ngrok (Sign up).⚠️ اشتباه رایج: ایمیلی که بعداً از دستش می‌دهید؛ با VPN روشن ممکن است ثبت‌نام نشود.
- توکن را کپی کنید، در همین کارت روش «ngrok با دامنه‌ی ثابت» را بگذارید و آن را در کادر «ngrok authtoken» بچسبانید.چه می‌بینید: صفحه‌ی «Your Authtoken» با یک توکن بلند و دکمه‌ی Copy.⚠️ اشتباه رایج: کپی کردن کل دستور ngrok config add-authtoken … — اشکالی ندارد، برنامه خودش توکن را جدا می‌کند.
- دامنه‌ی ثابت رایگان خود را کپی کنید (اگر نیست «Create domain»)، در کادر «دامنه‌ی ثابت ngrok» بچسبانید و «ذخیره و تست» را بزنید.چه می‌بینید: یک دامنه مثل name.ngrok-free.app.⚠️ اشتباه رایج: نگران https:// نباشید، با یا بی آن قبول می‌شود. بعد از این قدم آدرس‌های متا را دوباره کپی کنید.
ngrok همراه برنامه نیست (شرایط ngrok اجازه نمی‌دهد): خودتان آن را از ngrok.com نصب کنید؛ برنامه فقط نسخه‌ای را اجرا می‌کند که امضای خود ngrok را دارد. اگر دامنه‌ی شخصی دارید، حالت «دامنه یا آدرس خودم» را انتخاب کنید.
لینک‌های مشتری با ngrok: گزینه‌ی «لینک‌های مشتری (فرم، پرداخت)» در همین کارت تعیین می‌کند لینک فرم و پرداخت به کجا برود. روی آدرس موقت (پیش‌فرض، مثل قبل): صفحه‌ی اطلاع ngrok ندارد، ولی لینک‌هایی که قبلاً فرستاده‌اید با خاموش و روشن شدن کامپیوتر از کار می‌افتند. روی همین آدرس ثابت: لینک‌های قبلی کار می‌کنند، ولی ngrok رایگان اول صفحه‌ی «Visit Site» خودش را نشان می‌دهد که شاید در مرورگر داخل اینستاگرام یا واتساپ باز نشود — پیش از انتخاب، یک لینک را با گوشی خودتان امتحان کنید. لینک ثابت بدون هیچ صفحه‌ی اطلاع: حالت «دامنه یا آدرس خودم» (دامنه‌ی خودتان یا Cloudflare named tunnel).