مستندات استفاده

هر خرید = یک سیستم هوش مصنوعی مستقل. برخلاف چت‌بات‌های اشتراکی، برای هر سفارش یک سرویس ایزوله ساخته می‌شود که فقط دانش و قوانین کسب‌وکار شما را دارد. داده‌های شما با هیچ مشتری دیگری مخلوط نمی‌شود.

دانش از سایت شما می‌آید. موقع خرید، سایتتان خزیده و ایندکس می‌شود؛ هنگام هر پاسخ، مرتبط‌ترین بخش‌های محتوای سایت بازیابی و به هوش مصنوعی داده می‌شود تا بر اساس واقعیت جواب بدهد. بعد از تغییر سایت، از دکمه «به‌روزرسانی دانش از سایت» استفاده کنید.

قوانین دست شماست. لحن، قوانین پاسخگویی و دانش را قبل از پرداخت بازبینی و ویرایش می‌کنید و سرویس دقیقاً همان‌طور رفتار می‌کند.

توکن API = کلید سرویس شما. فقط یک بار نمایش داده می‌شود و سرور فقط هش آن را نگه می‌دارد. لو رفت؟ از پنل توکن جدید صادر کنید — قبلی فوراً باطل می‌شود و سرویس بدون قطعی با کلید جدید ادامه می‌دهد.

یک مغز، چند کانال. همان سرویس را می‌توانید هم‌زمان به ویجت سایت، تلگرام، اینستاگرام، تلفن و API خودتان وصل کنید — همه با یک دانش و یک لحن پاسخ می‌دهند و مصرفشان یکجا شمرده می‌شود.

1. از صفحه اصلی سرویس را انتخاب و آدرس سایتتان را وارد کنید — تحلیل خودکار انجام می‌شود.
2. پروفایل پیشنهادی (لحن/قوانین/دانش) را بازبینی و در صورت نیاز ویرایش کنید.
3. پرداخت کنید؛ سرویس در چند ثانیه ساخته می‌شود.
4. در صفحه سرویس، «صدور توکن API» را بزنید و توکن را جای امن ذخیره کنید.
5. راهنمای بالای همان صفحه («چطور از این سرویس استفاده کنم؟») را دنبال کنید — برای هر سرویس فرق دارد.

برای چی؟ پاسخ فوری به بازدیدکننده‌های سایت و سوال‌های پرتکرار، ۲۴ ساعته.

نصب ویجت: یک خط قبل از </body>:

<script src="ADDRESS/widget.js" data-token="agt_..." defer></script>

تنظیمات اختیاری: data-title (عنوان)، data-color (رنگ)، data-position (چپ/راست)، data-greeting (پیام خوش‌آمد). گفتگو در تب کاربر ادامه‌دار می‌ماند و رندر آن در برابر XSS امن است.

سیستم تیکتینگ: از API چت استفاده کنید (بخش مرجع API) — تاریخچه گفتگو را خودتان می‌فرستید.

1. در تلگرام به @BotFather پیام بدهید؛ با /newbot ربات بسازید.
2. توکن را در بخش «ربات تلگرام» صفحه سرویس وارد کنید — اعتبارسنجی زنده انجام می‌شود.
3. آدرس ربات را منتشر کنید. تمام!

ربات پیام متنی و پیام صوتی را می‌فهمد؛ اگر صوت فعال باشد به ویس با ویس جواب می‌دهد (متن کامل در کپشن). هر چت حافظه جدا دارد و /start گفتگو را از نو شروع می‌کند. قطع/تعویض ربات هر لحظه از پنل ممکن است و توکن API شما تغییری نمی‌کند.

اتصال از مسیر رسمی متا انجام می‌شود (بدون ریسک مسدودی اکانت): اکانتتان باید Professional باشد، توکن دسترسی پیام‌رسانی می‌گیرید (تیم پشتیبانی همراهی می‌کند) و در بخش «دایرکت اینستاگرام» وارد می‌کنید. از آن لحظه دایرکت‌ها خودکار پاسخ می‌گیرند؛ هر اکانت فقط به یک سرویس وصل می‌شود.

منطق: گفتار مشتری → متن → پاسخ هوشمند → گفتار فارسی. سه کانال آماده:

• ویجت سایت: دکمه 🎤 (گفتن به‌جای نوشتن) و 🔊 (شنیدن پاسخ‌ها) خودکار اضافه می‌شود.
• تلگرام: ربات را وصل کنید؛ ویسِ مشتری با ویس جواب می‌گیرد.
• اپ خودتان: endpoint صوتی /v1/voice — صدا می‌فرستید، متن + پاسخ + صدای جواب می‌گیرید.

کیفیت را از بخش «تست صوتی» صفحه سرویس بسنجید — دقیقاً همان مسیر واقعی است.

منشی هوشمند روی خط تلفن: تماس‌گیرنده صحبت می‌کند، هوش مصنوعی با دانش کسب‌وکار شما جواب صوتی می‌دهد و کل تماس را به خاطر می‌سپارد. نیازها: یک ترانک SIP از اپراتور VoIP + توکن API سرویس. مشخصات را به پشتیبانی بدهید تا خط را وصل کنیم. قبل از اتصال، از «تست صوتی» صفحه سرویس کیفیت را امتحان کنید.

سایتتان هر هفته خودکار تحلیل می‌شود: عنوان‌ها، توضیح‌های متا، H1، متن جایگزین تصاویر، viewport موبایل، حجم محتوا، سرعت، HTTPS و عنوان تکراری — با امتیاز ۰ تا ۱۰۰، پیشنهادهای اولویت‌بندی‌شده و کلیدواژه‌های پیشنهادی هوش مصنوعی.

روش کار: مشکلات «مهم» را اول رفع کنید، پیشنهادها را اعمال کنید، دوباره تحلیل بگیرید و روند امتیاز را دنبال کنید. تحلیل دستی هر لحظه با دکمه «تحلیل دوباره سایت».

در «استودیوی محتوا»: نوع (پست آماده / تقویم دوهفته‌ای / ایده‌ها)، پلتفرم (اینستاگرام/تلگرام/وبلاگ/لینکدین) و موضوع را انتخاب کنید. خروجی با لحن برند و بر پایه دانش سایت شما تولید و آرشیو می‌شود. برای اتوماسیون، /v1/content را با توکن صدا بزنید.

همه درخواست‌ها با هدر Authorization: Bearer agt_... به آدرس سرویس شما.

چت — POST /v1/chat:

{"message": "سلام", "history": [{"role": "user", "content": "..."},
             {"role": "assistant", "content": "..."}]}
→ {"reply": "...", "tenant_id": "...", "provider": "..."}

صوت — POST /v1/voice (multipart: audio ≤5MB، voice_reply=1 برای پاسخ صوتی):

curl -X POST ADDRESS/v1/voice -H "Authorization: Bearer agt_..." \
  -F "audio=@voice.ogg" -F "voice_reply=1"
→ {"transcript": "...", "reply": "...", "audio_base64": "...", "audio_mime": "audio/mpeg"}

محتوا — POST /v1/content:

{"kind": "post|calendar|ideas", "platform": "instagram|telegram|website|linkedin",
 "topic": "...", "count": 3, "notes": "..."} → {"body": "..."}

محدودیت نرخ: پیش‌فرض ۶۰ پیام/دقیقه کل سرویس و ۲۰ پیام/دقیقه هر IP؛ پاسخ ۴۲۹ با هدر Retry-After. API بدون حافظه است — تاریخچه را خودتان بفرستید.

• «۴۰۱»: توکن اشتباه یا باطل‌شده — از پنل توکن جدید صادر کنید.
• «۴۲۹»: عبور از محدودیت نرخ — به اندازه Retry-After صبر کنید.
• جواب‌ها ربطی به کسب‌وکارم ندارد: «به‌روزرسانی دانش از سایت» را بزنید و بخش دانش پیکربندی را بازبینی کنید.
• تست صوتی می‌گوید فعال نیست: دکمه «راه‌اندازی مجدد سرویس» را بزنید تا آخرین تنظیمات سرور را بگیرد.
• ربات تلگرام جواب نمی‌دهد: اتصال را قطع و با همان توکن دوباره وصل کنید؛ توکن BotFather را با /revoke عوض نکرده باشید.
• سرویس «متوقف/لغو» است: توسط مدیریت انجام شده — با پشتیبانی تماس بگیرید.

حل نشد؟ از داشبورد وضعیت سرویس را ببینید یا با پشتیبانی در تماس باشید.