سوالات فنی
پاسخ پرتکرارترین سوالات فنی درباره‌ی نصب، API، Webhook، امنیت و یکپارچه‌سازی.
نصب و راه‌اندازی
ویجت روی سایت ظاهر نمی‌شه. چیکار کنم؟
چند دلیل ممکنه داشته باشه:
- کلید API اشتباهه — دوباره از پنل کپی کن
- کد در جای درست نیست — باید قبل از
</body>باشه - کش مرورگر — یک بار Ctrl + F5 بزن
- تداخل با اسکریپت دیگه — در کنسول مرورگر خطاها رو چک کن
برای بررسی دقیق‌تر، در کنسول مرورگر این رو تایپ کن:
typeof window.SahooWidget
اگر "object" برگردوند، ویجت لود شده. اگر
"undefined"، یعنی اسکریپت لود نشده.
آیا ویجت روی سایت HTTPS کار می‌کنه؟
بله. اسکریپت از https://myshahoo.ir لود می‌شه و
روی سایت‌های HTTPS بدون مشکل کار می‌کنه.
روی چند سایت می‌تونم نصب کنم؟
| پلن | تعداد سایت |
|---|---|
| Starter | ۱ |
| Growth | ۵ |
| Business | نامحدود |
روی وردپرس چند سایت می‌تونم نصب کنم؟
برای هر سایت، یک کلید API جداگانه بساز. این به تفکیک گزارش‌ها کمک می‌کنه.
API
چطور API key بسازم؟
در پنل، برو به تنظیمات ← امنیت ← کلیدهای API و روی ساخت کلید جدید کلیک کن.
API key رو گم کردم. چیکار کنم؟
کلید API فقط یک بار نمایش داده می‌شه. اگر گم شد، باید کلید قبلی رو حذف کنی و کلید جدید بسازی.
چند API key می‌تونم داشته باشم؟
| پلن | تعداد |
|---|---|
| Growth | ۵ کلید |
| Business | نامحدود |
Rate limit چیه و چطور کار می‌کنه؟
Rate limit یعنی حداکثر تعداد درخواست در دقیقه. پلن Growth: ۶۰ درخواست در دقیقه. پلن Business: ۳۰۰ درخواست در دقیقه.
اگر از حد بگذری، پاسخ 429 می‌گیری. از header
X-RateLimit-Reset می‌تونی زمان بعدی رو بفهمی.
چطور خطای 401 (Unauthorized) رو رفع کنم؟
- بررسی کن هدر
Authorizationارسال می‌شه - فرمت رو چک کن:
Bearer YOUR_API_KEY(با فاصله) - مطمئن شو کلید معتبره و منقضی نشده
- اگر لازمه، کلید جدید بساز
از کدوم زبان‌ها پشتیبانی می‌کنید؟
SDKهای رسمی برای:
- Python
- Node.js / JavaScript
- PHP
برای سایر زبان‌ها، می‌تونی از REST API مستقیم استفاده کنی.
Webhooks
چطور درخواست جعلی Webhook رو تشخیص بدم؟
همیشه امضای HMAC-SHA256 رو در هدر X-Shahoo-Signature
تأیید کن. راهنمای کامل در
صفحه‌ی Webhooks هست.
چرا Webhook چند بار ارسال می‌شه؟
اگر سرور تو پاسخ درست نده، شاهو retry می‌کنه.
برای جلوگیری از پردازش تکراری، از فیلد id در payload
استفاده کن.
حداکثر زمان پاسخ سرور چقدره؟
۱۰ ثانیه. اگر بیشتر طول بکشه، timeout می‌شه و شاهو دوباره تلاش می‌کنه.
چند بار retry می‌شه؟
۷ بار در طول ۲۴ ساعت. فاصله‌ها به‌صورت exponential افزایش پیدا می‌کنه.
اگر Webhook رو غیرفعال کنم، رویدادها ذخیره می‌شن؟
خیر. وقتی Webhook غیرفعال باشه، رویدادها ارسال نمی‌شن. اگه دوباره فعال کنی، فقط رویدادهای جدید ارسال می‌شن.
امنیت
داده‌هام کجا ذخیره می‌شن؟
روی سرورهای داخل ایران، با رمزنگاری AES-256. پشتیبان‌گیری روزانه از دو دیتاسنتر جداگانه انجام می‌شه.
آیا از GDPR پیروی می‌کنید؟
بله، شاهو با اصول GDPR سازگاره — هرچند GDPR مخصوص اتحادیه اروپاست، ما اصول حفاظت از داده‌ها رو رعایت می‌کنیم.
چطور داده‌هام رو حذف کنم؟
در پنل، برو به تنظیمات ← امنیت ← حذف حساب کاربری. بعد از حذف، ۷ روز فرصت لغو داری. بعد از اون، داده‌ها به‌صورت دائمی پاک می‌شن.
می‌تونم از داده‌هام خروجی بگیرم؟
بله. در بخش تنظیمات ← امنیت ← خروجی داده‌ها، یک فایل ZIP شامل تمام داده‌ها به فرمت JSON یا CSV دریافت می‌کنی.
یکپارچه‌سازی
آیا با Zapier کار می‌کنه؟
بله. از طریق API و Webhook می‌تونی به Zapier وصل کنی. یک اپلیکیشن رسمی هم در حال ساخت هست.
چطور با CRM خودم یکپارچه کنم؟
از Webhook استفاده کن. مثلاً هر وقت مشتری جدید اضافه شد،
customer.created دریافت می‌کنی و می‌تونی اون رو در
CRM خودت هم ثبت کنی.
با Google Analytics کار می‌کنه؟
بله. در تنظیمات ← اتصال‌ها، می‌تونی Google Analytics رو وصل کنی تا ترافیک سایتت رو ردیابی کنی.
عملکرد
ویجت روی سرعت سایتم تأثیر داره؟
خیر. اسکریپت زیر ۲۰KB است و با async لود می‌شه، پس
روی DOMContentLoaded تأثیر نمی‌ذاره.
چند مکالمه همزمان پشتیبانی می‌کنید؟
| پلن | مکالمه‌ی همزمان |
|---|---|
| Starter | ۱۰ |
| Growth | ۱۰۰ |
| Business | نامحدود |
آیا در ایران قطع دسترسی داره؟
خیر. سرورهای شاهو داخل ایران هستند و به‌طور کامل در دسترس. این یکی از مزیت‌های اصلی شاهو نسبت به رقبای خارجیه.
صورت‌حساب
چطور پلنم رو ارتقا بدم؟
در پنل، برو به صورت‌حساب و روی ارتقا در پلن موردنظر کلیک کن. تفاوت قیمت روزانه محاسبه می‌شه.
اگر وسط ماه ارتقا بدم، پول ماه قبل برمی‌گرده؟
خیر، پول ماه قبل برنمی‌گرده. ولی برای ماه جدید فقط تفاوت رو پرداخت می‌کنی.
چطور اشتراکم رو لغو کنم؟
در پنل، برو به صورت‌حساب ← لغو اشتراک. اگر توی ۷ روز اول باشی، پول کامل برمی‌گرده.
فاکتور رسمی برای سازمان می‌خوام.
با پشتیبانی تماس بگیر. فاکتور رسمی با مهر و امضا صادر می‌شه و از طریق ایمیل ارسال می‌شه.
هوش مصنوعی
آیا AI شاهو روی داده‌های من آموزش می‌بینه؟
خیر. AI شاهو کاملاً روی سرورهای اختصاصی اجرا می‌شه و داده‌های تو برای آموزش مدل‌های عمومی استفاده نمی‌شن.
چطور AI رو غیرفعال کنم؟
در پنل، برو به تنظیمات ← هوش مصنوعی و همه‌ی گزینه‌ها رو غیرفعال کن.
AI فارسی چقدر دقیقه؟
مدل ما مخصوص زبان فارسی آموزش دیده و در تست‌های داخلی، دقت بالای ۹۲٪ در تشخیص احساسات و خلاصه‌سازی داره.
سوالات متفرقه
می‌تونم برند شاهو رو سفارشی‌سازی کنم؟
در پلن Business، می‌تونی ویجت رو کاملاً با برند خودت سفارشی کنی — حتی لوگوی شاهو در پایین ویجت برداشته می‌شه.
حالت dark mode دارید؟
بله، هم پنل و هم ویجت از dark mode پشتیبانی می‌کنن.
چه زبان‌هایی پشتیبانی می‌شن؟
در حال حاضر: فارسی (کامل)، انگلیسی (پایه). زبان‌های دیگر در نقشه‌ی راه ما هستند.
چطور با پشتیبانی تماس بگیرم؟
- گفتگوی آنلاین — در پنل و وب‌سایت
- ایمیل — info@myshahoo.ir
- ایمیل API — api@myshahoo.ir
- ایمیل امنیت — security@myshahoo.ir
