رفع مشکلات
راهنمای گام‌به‌گام حل پرتکرارترین مشکلات شاهو — با دسته‌بندی موضوعی و راه‌حل‌های دقیق.
مشکلات ویجت گفتگو
ویجت اصلاً نمایش داده نمی‌شه
مطمئن شو کد درست قبل از </body> قرار گرفته:
<script src="https://myshahoo.ir/widget.js?key=YOUR_API_KEY" async></script>کلید API رو از پنل، بخش کانال‌ها ← وب‌سایت دوباره کپی کن. اگر اشتباه کپی شده باشه، ویجت لود نمی‌شه.
با F12 کنسول رو باز کن. اگر خطای ۴۰۴ یا ۴۰۳ دیدی، کلید API اشتباهه.
اگر از CDN یا کش استفاده می‌کنی، کش رو پاک کن. با Ctrl + F5 صفحه رو رفرش کن.
ویجت لود می‌شه ولی کار نمی‌کنه
اگر ویجت نمایش داده می‌شه ولی پیام نمی‌فرسته:
- در کنسول مرورگر خطاها رو چک کن
- مطمئن شو کلید API فعال است
- اتصال اینترنت رو بررسی کن
- فیلترشکن رو خاموش کن (ویجت روی سرور ایران میزبانی می‌شه)
- مرورگر رو به آخرین نسخه به‌روز کن
ویجت در HTTPS کار نمی‌کنه
مطمئن شو آدرس اسکریپت با https:// شروع می‌شه (نه
http://). مرورگرها به‌درخواست‌های
http:// از صفحات https:// اجازه نمی‌دن.
رنگ ویجت با تنظیمات من فرق داره
- کش مرورگر رو پاک کن
- اگر از CDN استفاده می‌کنی، کش CDN رو purge کن
- تغییرات در ۵ دقیقه اعمال می‌شن
مشکلات اعلان‌ها
اعلان مرورگر دریافت نمی‌کنم
در نوار آدرس مرورگر، روی آیکون قفل کنار آدرس کلیک کن و اجازه‌ی Notifications رو روی Allow بذار.
در macOS، برو به System Settings ← Notifications ← [Browser] و Allow Notifications رو فعال کن.
اگر DND روشن باشه، اعلان‌ها نمایش داده نمی‌شن. DND رو خاموش کن.
صدای اعلان پخش نمی‌شه
- مطمئن شو صدای مرورگر قطع نیست
- در پنل، یک بار روی هر جای صفحه کلیک کن (مرورگرها برای پخش صدا نیاز به تعامل کاربر دارن)
- در تنظیمات ← اعلان‌ها، صدای اعلان رو فعال کن
- اگر مشکل ادامه داشت، کش مرورگر رو پاک کن
عنوان تب تعداد اشتباه نشون می‌ده
این معمولاً به‌خاطر کش مرورگره. راه‌حل:
- صفحه رو رفرش کن
- از پنل خارج و دوباره وارد شو
- در آخرین راه‌حل، کوکی‌ها و کش رو پاک کن
مشکلات کانال‌ها
واتساپ وصل نمی‌شه
- مطمئن شو حساب WhatsApp Business API داری
- مطمئن شو شماره در WhatsApp Business ثبت شده
- در Meta for Developers، دسترسی‌های لازم رو تأیید کن
- اگر خطای «شماره در حال استفاده» دادی، شماره رو از WhatsApp عادی حذف کن
اینستاگرام اجازه نمی‌ده
پیش‌نیازها:
- حساب باید Business یا Creator باشه
- صفحه‌ی Facebook باید به اینستاگرام متصل باشه
- تو باید ادمین صفحه‌ی Facebook باشی
ربات تلگرام پیام نمی‌گیره
- توکن ربات رو از BotFather دوباره بگیر
- مطمئن شو ربات به گروه یا کانال اضافه شده
- در BotFather، Privacy Mode رو غیرفعال کن (اگه در گروه استفاده می‌کنی)
- توکن رو در پنل دوباره وارد کن
پیام‌ها با تأخیر می‌رسن
- اینترنت پایدار داشته باش
- در بخش اعلان‌ها، فعال بودن را چک کن
- اگر کانال خاصی کند است، با پشتیبانی تماس بگیر
مشکلات API
خطای 401 Unauthorized
دلایل ممکنه:
- هدر
Authorizationارسال نمی‌شه - فرمت اشتباهه — باید
Bearer YOUR_KEYباشه - کلید API منقضی یا حذف شده
- کلید رو اشتباه کپی کردی (فاصله‌های اضافی)
راه‌حل:
curl -X GET "https://myshahoo.ir/api/v1/conversations/" \
-H "Authorization: Bearer sk_live_abc123..." \
-H "Content-Type: application/json"خطای 429 Too Many Requests
از محدودیت rate limit گذشتی. راه‌حل‌ها:
- کمی صبر کن (مثلاً ۳۰ ثانیه)
- از
X-RateLimit-Resetبرای زمان دقیق استفاده کن - درخواست‌ها رو در بازه‌ی طولانی‌تر پخش کن
- اگر واقعاً به تعداد بالاتری نیاز داری، پلن رو ارتقا بده
Webhook دریافت نمی‌کنم
- مطمئن شو آدرس با HTTPS شروع می‌شه
- سرورت به اینترنت دسترسی داره؟
- فایروال یا IP Whitelist جلوی درخواست رو نمی‌گیره؟
- در بخش لاگ‌های Webhook، پاسخ سرورت رو ببین
- اگر سرورت خطا می‌ده، در لاگ شاهو می‌تونی ببینی
امضای HMAC رد می‌شه
رایج‌ترین دلایل:
- بدنه‌ی خام درخواست رو تغییر دادی (مثلاً با JSON parse و re-stringify)
- Secret Key اشتباهه
- الگوریتم HMAC اشتباهه (باید SHA256 باشه)
- مقایسه‌ی امضا case-sensitive است
همیشه بدنه‌ی خام درخواست (bytes) رو تأیید کن، نه بعد از parse:
def webhook_view(request):
signature = request.headers.get('X-Shahoo-Signature')
raw_body = request.body
expected = hmac.new(
SECRET.encode(),
raw_body,
hashlib.sha256
).hexdigest()
if not hmac.compare_digest(expected, signature):
return HttpResponse(status=401)مشکلات پنل کاربری
پنل لود نمی‌شه
- مرورگر رو به‌روز کن
- کش مرورگر رو پاک کن
- با مرورگر دیگری امتحان کن
- فیلترشکن رو خاموش کن
- اگر باز هم مشکل بود، سرعت اینترنتت رو چک کن
نمی‌تونم وارد بشم
- مطمئن شو شماره موبایل درست وارد کردی
- کد OTP رو به‌سرعت وارد کن (۲ دقیقه اعتبار)
- اگر کد نگرفتی، دکمه‌ی «ارسال مجدد» رو بزن
- مطمئن شو SMS روی گوشی مسدود نشده
- اگر شماره‌ات عوض شده، با پشتیبانی تماس بگیر
اطلاعات پنل قدیمیه
کش مرورگر رو پاک کن یا با Ctrl + Shift + R صفحه رو هارد‌رفرش کن.
رنگ پنل اشتباهه (روشن/تاریک)
روی آیکون ماه/خورشید در تاپ‌بار کلیک کن یا از تنظیمات ← ظاهر تم دلخواه رو انتخاب کن.
مشکلات پرداخت
پرداخت ناموفق بود
- اطلاعات کارت رو دوباره چک کن
- مطمئن شو کارت رمز دوم پویا فعاله
- سقف تراکنش روزانه رو چک کن
- با کارت دیگری امتحان کن
- اگر باز هم مشکل داشت، با پشتیبانی تماس بگیر
پلنم ارتقا نیافته بعد از پرداخت
- ممکنه چند دقیقه طول بکشه
- از پنل خارج و دوباره وارد شو
- فاکتور رو در بخش صورت‌حساب چک کن
- اگر بعد از ۳۰ دقیقه اعمال نشد، با پشتیبانی تماس بگیر
می‌خوام فاکتور رسمی بگیرم
با پشتیبانی تماس بگیر و اطلاعات زیر رو بده:
- نام شرکت یا سازمان
- کد اقتصادی یا شناسه ملی
- آدرس
- شماره تلفن
- ایمیل برای ارسال فاکتور
می‌خوام اشتراکم رو لغو کنم
- در پنل، برو به صورت‌حساب
- روی لغو اشتراک کلیک کن
- دلیل رو بنویس
- تأیید کن
اگر در ۷ روز اول باشی، پول کامل برمی‌گرده. بعد از اون، بر اساس سیاست بازپرداخت.
اگر مشکل حل نشد
اگر بعد از امتحان راه‌حل‌های بالا مشکل حل نشد، با پشتیبانی تماس بگیر. برای اینکه سریع‌تر بهت کمک کنیم، اطلاعات زیر رو آماده کن:
- شرح دقیق مشکل
- مراحل بازتولید مشکل
- اسکرین‌شات یا ویدیو (اگر ممکنه)
- نام مرورگر و نسخه‌ی آن
- سیستم‌عامل (ویندوز، مک، لینوکس، موبایل)
- پیام‌های خطای کنسول مرورگر (F12)
- اگر API مربوطه، درخواست و پاسخ
- کلید API (فقط بخش اول — کامل نفرست)
