میراکل یک ربات پشتیبانی هوشمند است که روی سایت شما، به‌صورت یک ویجت گفتگوی کوچک در گوشه‌ی صفحه، نصب می‌شود و به سوالات بازدیدکننده‌های سایتتان جواب می‌دهد — دقیقاً بر اساس اطلاعاتی که خودتان در اختیارش گذاشته‌اید (محصولات، مقالات، قوانین و رویه‌های کسب‌وکارتان).

میراکل برای همه‌ی کسب‌وکارها یک حساب مشترک نیست؛ هر مشتری میراکل یک فضای کاملاً مجزا دارد که در آن داده‌ها، مکالمه‌ها و تنظیمات ربات، جدا از بقیه‌ی مشتری‌های میراکل نگهداری می‌شود.

چه چیزی میراکل را از یک چت‌بات معمولی متفاوت می‌کند؟

۱. فقط بر اساس اطلاعات شما جواب می‌دهد

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

۲. هرگز روی سرعت سایت شما اثر نمی‌گذارد

اسکریپت ویجت میراکل به‌صورت غیرهمزمان لود می‌شود و در یک محیط جدا و ایزوله اجرا می‌شود، یعنی نه سرعت سایتتان کند می‌شود و نه ظاهر و استایل ویجت با قالب سایت شما تداخل پیدا می‌کند.

۳. داده‌های شما با هیچ مشتری دیگری قاطی نمی‌شود

جداسازی داده‌ی هر مشتری هم در کد و هم در سطح دیتابیس اعمال شده — یعنی حتی در صورت خطای انسانی هم امکان دیده‌شدن داده‌ی شما توسط مشتری دیگر وجود ندارد.

۴. هرجا کاربر بخواهد، دست انسان را می‌بوسد

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

میراکل از چه بخش‌هایی تشکیل شده؟

اگر تازه ثبت‌نام کرده‌اید و می‌خواهید همین امروز اولین ربات‌تان را راه‌اندازی کنید، مقاله‌ی بعدی را ببینید — راه‌اندازی معمولاً کمتر از ۱۵ دقیقه طول می‌کشد.

این مقاله کوتاه‌ترین مسیر برای رساندن ربات میراکل به سایت شماست. کل فرآیند معمولاً بین ۱۰ تا ۱۵ دقیقه طول می‌کشد.

گام ۱ — ساخت حساب

در صفحه‌ی ثبت‌نام (/signup) این اطلاعات را وارد کنید:

• نام کسب‌وکار
• دامنه‌ی سایت (مثلاً example.com)
• نام و ایمیل مدیر حساب
• رمز عبور (حداقل ۸ کاراکتر)

بعد از ثبت‌نام، بلافاصله و بدون نیاز به ورود مجدد وارد داشبورد می‌شوید و مستقیم به صفحه‌ی «دانش ربات» هدایت می‌شوید — چون اولین و مهم‌ترین کار، آموزش دادن ربات با اطلاعات خودتان است.

گام ۲ — آموزش ربات با اطلاعات خودتان

در صفحه‌ی «دانش ربات»، فایل‌ها یا منابع اطلاعاتی کسب‌وکارتان را اضافه کنید: فایل PDF یا Word، صفحات سایت (با وارد کردن آدرس)، یا حتی متن ساده.

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

گام ۳ — انتخاب مدل هوش مصنوعی (اختیاری)

در بخش «تنظیمات → مدل هوش مصنوعی» می‌توانید مدل زبانی ربات را انتخاب کنید. پیش‌فرض میراکل مدل GPT-4o mini از OpenAI است، اما در صورت تمایل می‌توانید یکی از مدل‌های Gemini گوگل را هم انتخاب کنید.

گام ۴ — شخصی‌سازی ظاهر ویجت

در صفحه‌ی «تنظیمات ویجت» می‌توانید رنگ، پیام خوش‌آمدگویی و لحن ربات را متناسب با برند خودتان تنظیم کنید و همان‌جا، در یک پیش‌نمایش زنده، دقیقاً ببینید ربات چه شکلی خواهد بود.

گام ۵ — نصب روی سایت

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

گام ۶ — اولین گفتگو

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

اگر مقاله‌ی «شروع سریع» را خوانده‌اید و می‌خواهید این بار با جزئیات بیشتر ربات‌تان را بسازید، این مقاله برای شماست.

نقشه‌ی کلی داشبورد

بعد از ورود به داشبورد، منوی کناری این بخش‌ها را نشان می‌دهد و ترتیب طبیعی کار با آن‌ها تقریباً همین است:

1. آمار و آنالیز — نمای کلی از عملکرد ربات
2. گفتگوها — صندوق ورودی مکالمه‌هایی که به اپراتور تحویل داده شده‌اند
3. دانش ربات — جایی که فایل‌ها و اطلاعات ربات را مدیریت می‌کنید
4. سرنخ‌های جمع‌آوری‌شده — اطلاعات تماسی که ربات از کاربران گرفته
5. اپراتورها — مدیریت اعضای تیم پشتیبانی
6. یکپارچه‌سازی‌ها — اتصال به واتس‌اپ، تلگرام، ووکامرس
7. تنظیمات ویجت — ظاهر و شخصیت ربات
8. تنظیمات — پلن، کد نصب، دامنه‌های مجاز، سقف پیام

اولین بار که وارد داشبورد می‌شوید، یک راهنمای تعاملی همین مسیر را روی صفحه به شما نشان می‌دهد؛ می‌توانید هر وقت خواستید آن را ببندید و بعداً دوباره طی این بخش‌ها ادامه دهید.

قدم ۱ — تغذیه‌ی ربات با دانش واقعی کسب‌وکارتان

به بخش «دانش ربات» بروید و شروع کنید به آپلود فایل‌های PDF/Word، آدرس صفحات سایت، یا متن ساده. پیشنهاد می‌کنیم با پرتکرارترین سوالات مشتری‌هایتان شروع کنید، نه لزوماً با کل مستندات شرکت.

قدم ۲ — تنظیم رفتار و لحن ربات

از «تنظیمات ویجت»، می‌توانید مشخص کنید ربات با چه لحنی صحبت کند و چه پیام خوش‌آمدگویی‌ای نشان دهد. این تنظیمات روی شخصیت ربات اثر می‌گذارد، نه روی محتوای دانشش.

قدم ۳ — امتحان کردن قبل از انتشار

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

قدم ۴ — انتخاب مدل هوش مصنوعی

از «تنظیمات → مدل هوش مصنوعی» بین مدل‌های OpenAI (پیش‌فرض: GPT-4o mini) و مدل‌های Gemini گوگل انتخاب کنید. این انتخاب فقط روی نحوه‌ی نوشتن پاسخ نهایی اثر دارد؛ جست‌وجوی اطلاعات همیشه یکسان و بر همان داده‌های خودتان انجام می‌شود.

قدم ۵ — انتشار روی سایت

دامنه‌ی سایت خودتان را به فهرست «دامنه‌های مجاز» اضافه کنید و قطعه‌کد نصب را کپی کنید، یا افزونه‌ی وردپرس آماده را دانلود و نصب کنید.

قدم ۶ — سقف پیام و پلن را چک کنید

هر پلن یک سقف پیام ماهانه دارد که در «تنظیمات → پلن‌ها و اشتراک» قابل مشاهده است، به‌همراه تعداد روزهای باقی‌مانده تا پایان دوره.

چک‌لیست پایانی

• حداقل یک منبع دانش آپلود شده
• لحن و پیام خوش‌آمدگویی تنظیم شده
• چند سوال واقعی در پیش‌نمایش تست شده
• دامنه‌ی سایت به فهرست دامنه‌های مجاز اضافه شده
• کد ویجت روی سایت نصب شده

ربات میراکل هیچ دانش پیش‌فرضی درباره‌ی کسب‌وکار شما ندارد؛ هر چیزی که بلد است، از همین بخش «دانش ربات» می‌آید. سه راه برای اضافه کردن اطلاعات دارید:

۱. آپلود فایل

فرمت‌های پشتیبانی‌شده: PDF، Word (docx)، متن ساده (txt) و CSV. حجم هر فایل حداکثر ۲۰ مگابایت است.

اگر فایلتان فرمت دیگری دارد (مثلا Excel یا PowerPoint)، کافی است محتوایش را به یکی از فرمت‌های بالا تبدیل کنید یا مستقیم متنش را در تب «متن» کپی کنید.

۲. وارد کردن آدرس سایت (خزیدن خودکار)

آدرس سایت‌تان را وارد کنید تا میراکل صفحات آن را پیدا کند. این فرآیند یک مرحله‌ی بازبینی دارد:

1. بعد از وارد کردن آدرس، میراکل صفحات سایت شما را پیدا می‌کند (وضعیت: «در حال جست‌وجو»).
2. وقتی فهرست صفحات آماده شد، وضعیت به «منتظر بازبینی شماست» تغییر می‌کند.
3. شما فهرست صفحات پیدا‌شده را می‌بینید و می‌توانید هرکدام را که نمی‌خواهید وارد دانش ربات شود، از حالت انتخاب خارج کنید.
4. با زدن دکمه‌ی تایید، فقط صفحات انتخاب‌شده وارد پردازش می‌شوند.

این مرحله‌ی بازبینی عمداً وجود دارد تا کنترل کامل داشته باشید که چه چیزی وارد دانش ربات می‌شود — نه هر چیزی که در سایتتان هست.

در پلن‌های حرفه‌ای و سازمانی، صفحاتی که از این طریق اضافه کرده‌اید به‌صورت خودکار و دوره‌ای دوباره بررسی می‌شوند (حرفه‌ای: هفتگی، سازمانی: روزانه) تا اگر محتوای سایت تغییر کرد (مثلاً تغییر قیمت)، دانش ربات هم خودکار به‌روز شود — فقط برای صفحاتی که واقعاً تغییر کرده‌اند، بدون هزینه‌ی اضافه برای بقیه. این قابلیت فقط برای صفحات وبسایتی است، نه فایل‌های آپلودی. در پلن پایه، برای به‌روزرسانی باید صفحه را دوباره دستی اضافه کنید.

۳. متن ساده

اگر اطلاعاتی دارید که در هیچ فایل یا صفحه‌ای آماده نیست، از تب «متن» استفاده کنید و مستقیم تایپ یا پیست کنید.

چرا ساختار متن مهم است؟

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

• پاراگراف‌های کوتاه و مجزا برای هر موضوع بهتر از یک متن طولانی و یکپارچه بازیابی می‌شوند.
• عنوان و ساختار مشخص (مثلاً «شرایط ارسال»، «شرایط بازگشت») به ربات کمک می‌کند دقیق‌تر جواب بدهد.
• از اطلاعات متناقض در چند فایل مختلف پرهیز کنید — اگر دو منبع در مورد یک موضوع حرف‌های متفاوت بزنند، ربات ممکن است گیج شود.

دانشِ ربات (چیزی که می‌داند) از بخش «دانش ربات» می‌آید. اما شخصیت ربات (چطور حرف می‌زند) از بخش «تنظیمات ویجت» تنظیم می‌شود. این دو کاملاً مستقل از هم هستند — تغییر لحن هیچ‌وقت اطلاعات ربات را عوض نمی‌کند.

هویت ربات

• نام ربات — چه نامی به بازدیدکننده نشان داده شود
• آواتار و آیکون — تصویر یا نماد ربات در ویجت
• رنگ‌بندی — هماهنگ با برند سایت شما

پیام‌های اولیه

• پیام خوش‌آمدگویی اولیه — اولین چیزی که کاربر وقتی ویجت را باز می‌کند می‌بیند
• پیام پاپ‌آپ — پیام کوچکی که می‌تواند قبل از باز شدن ویجت، بازدیدکننده را به شروع گفتگو دعوت کند
• سوالات پیشنهادی سریع — چند سوال آماده که زیر پیام خوش‌آمدگویی نمایش داده می‌شوند

رفتار و محدودیت‌ها

• پرامپت پایه / دستورالعمل رفتاری — اینجا می‌توانید به زبان ساده بنویسید ربات چطور صحبت کند: رسمی یا صمیمی، مختصر یا با جزئیات.
• زمینه‌ی کسب‌وکار — چند خط درباره‌ی این‌که کسب‌وکارتان چیست، تا پاسخ‌ها زمینه‌ی درست‌تری داشته باشند.
• محدودیت‌ها و قوانین — مواردی که ربات هرگز نباید انجام دهد یا وعده دهد.

این تنظیمات روی سبک صحبت کردن ربات اثر می‌گذارند، نه روی محتوای دانشش. ربات هنوز فقط از منابعی که در «دانش ربات» آپلود کرده‌اید استفاده می‌کند.

پیام «پاسخ را نمی‌دانم»

وقتی ربات جواب سوالی را در دانش شما پیدا نکند، به‌جای حدس زدن، یک پیام صادقانه نشان می‌دهد. متن پیش‌فرض این پیام عمومی است، اما می‌توانید از همین‌جا آن را با متن اختصاصی خودتان جایگزین کنید — مثلاً یک فروشگاه لوازم آرایشی می‌تواند بنویسد: «متأسفم، چیزی درباره‌ی این سوال پیدا نکردم. اگر سوالی درباره‌ی محصولات آرایشی ما دارید، خوشحال می‌شوم کمک کنم.» اگر این فیلد را خالی بگذارید، همان پیام پیش‌فرض میراکل نمایش داده می‌شود.

پاسخ‌های دستی برای سوالات پرتکرار

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

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

این پیش‌نمایش یک محیط جدا یا داده‌های آزمایشی جعلی ندارد — دقیقاً همان ربات، با همان دانشی که در بخش «دانش ربات» آپلود کرده‌اید، پاسخ می‌دهد. هر چیزی که اینجا تست کنید، دقیقاً همان چیزی است که بازدیدکننده‌های واقعی سایتتان بعد از انتشار خواهند دید.

چطور از پیش‌نمایش استفاده کنیم

1. به «تنظیمات ویجت» بروید.
2. تنظیمات دلخواه (لحن، پیام خوش‌آمدگویی، رنگ) را اعمال کنید.
3. در پنجره‌ی پیش‌نمایش، چند سوال واقعی که مشتری‌هایتان معمولاً می‌پرسند را تایپ کنید.
4. برای هر سوال ببینید: آیا جواب درست و کامل است؟ آیا لحن مناسب است؟

اگر جایی پاسخ ناقص بود، لازم نیست تنظیمات فنی را عوض کنید — معمولاً کافی است به منابع دانش برگردید و اطلاعات مربوطه را کامل‌تر کنید.

یکی از بزرگ‌ترین نگرانی‌های هر کسب‌وکار درباره‌ی چت‌بات‌های هوش مصنوعی این است: «اگر ربات چیزی اشتباه یا از خودش ساخته به مشتری من بگوید چه؟» میراکل برای همین نگرانی، دو لایه‌ی محافظتی جدا دارد که کاملاً خودکار هستند — نیازی به تنظیم از طرف شما ندارند.

لایه‌ی اول: جست‌وجوی ترکیبی

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

• جست‌وجوی معنایی (Vector Search) — پیدا کردن متن‌هایی که از نظر مفهوم به سوال نزدیک هستند، حتی اگر کلمات دقیقاً یکسان نباشند.
• جست‌وجوی کلمه‌کلیدی — پیدا کردن تطابق دقیق، مخصوصاً برای مواردی مثل کد محصول یا شماره مدل.

این ترکیب باعث می‌شود چه سوال با کلمات دقیق پرسیده شود چه با مفهومی مشابه، ربات بتواند مرتبط‌ترین اطلاعات را پیدا کند.

لایه‌ی دوم: بازبینی خودکار پاسخ قبل از ارسال

بعد از این‌که ربات پاسخ را می‌نویسد، پیش از نمایش به کاربر، یک بررسی داخلی جداگانه انجام می‌شود: آیا هر ادعای موجود در پاسخ واقعاً در متن‌هایی که بازیابی شده وجود دارد؟

اگر پاسخ تایید نشود، میراکل آن را پس می‌گیرد و به‌جایش این پیام صادقانه را نشان می‌دهد:

«متأسفم، اطلاعات دقیقی در این مورد ندارم. اگر سوالی درباره‌ی خدمات یا محصولات ما دارید، خوشحال می‌شوم راهنمایی‌تان کنم.»

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

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

چرا این مهم است

این یعنی هیچ‌وقت لازم نیست به ربات اعتماد کورکورانه داشته باشید یا نگران باشید که یک روز چیزی نادرست به مشتری‌تان بگوید و متوجه نشوید. تنها کاری که از شما خواسته می‌شود، تکمیل و به‌روز نگه داشتن منابع دانش است؛ بقیه‌اش خودکار انجام می‌شود.

بعد از این‌که ربات را آموزش دادید و ظاهرش را پسندیدید، نوبت انتشار روی سایت واقعی‌تان است. از «تنظیمات → نصب ویجت روی سایت» شروع کنید.

سه روش لود شدن ویجت

میراکل سه نوع کد نصب به شما می‌دهد؛ هر سه، کلید API اختصاصی شما را از قبل داخلشان دارند — کافی است کپی کنید:

1. عادی (پیشنهادی) — ویجت بعد از لود کامل شدن سایت شما و به‌صورت غیرهمزمان (async) لود می‌شود. بهترین گزینه برای اکثر سایت‌ها؛ هیچ تاثیری روی سرعت لود اولیه‌ی سایت ندارد.
2. تعاملی — ویجت فقط وقتی لود می‌شود که بازدیدکننده اولین کلیک، اسکرول، حرکت ماوس یا لمس صفحه را انجام دهد.
3. مستقیم — یک تگ <script> ساده و همزمان، برای مواقعی که کنترل دستی‌تر لازم است.

در هر سه حالت، کد را دقیقاً قبل از بسته شدن تگ </body> در سایتتان قرار دهید.

محدود کردن دامنه‌های مجاز (مهم برای امنیت)

از همان صفحه، در بخش «دامنه‌های مجاز»، آدرس سایت خودتان را اضافه کنید.

نکته‌ی امنیتی: تا وقتی هیچ دامنه‌ای در این فهرست اضافه نکرده باشید، ویجت روی هر سایتی که کلید API شما را داشته باشد کار می‌کند — بدون محدودیت. بعد از اضافه کردن حداقل یک دامنه، فقط همان دامنه (و زیردامنه‌هایش) اجازه‌ی استفاده از ویجت شما را دارند.

نصب روی سایت وردپرسی

اگر سایت شما با وردپرس ساخته شده، لازم نیست کد را دستی وارد کنید. از همان بخش «نصب ویجت»، دکمه‌ی دانلود افزونه‌ی میراکل را بزنید — یک فایل zip دانلود می‌شود که کلید API شما از قبل داخلش تنظیم شده. کافی است این افزونه را از پنل مدیریت وردپرس نصب و فعال کنید.

بعد از نصب

بعد از قرار دادن کد، سایت خودتان را در یک تب جدید باز کنید و مطمئن شوید ویجت در گوشه‌ی صفحه ظاهر می‌شود.

از «تنظیمات ویجت → تب ظاهر» می‌توانید رنگ و تصاویر ویجت را متناسب با برند سایتتان تنظیم کنید. این تب جدا از تب «هوش مصنوعی» (لحن و رفتار) و تب «محتوا» (پیام‌ها) است.

رنگ‌ها

• رنگ حباب ربات — رنگ دکمه‌ی شناور و حباب‌های پیام ربات
• رنگ چت — رنگ حباب پیام‌های کاربر
• رنگ اصلی — فقط در حالت تمام‌صفحه‌ی موبایل، برای پس‌زمینه‌ی هدر استفاده می‌شود

کنار هر رنگ یک دکمه‌ی «بازنشانی به پیش‌فرض» هست که فقط همان یک رنگ را به حالت اولیه برمی‌گرداند.

تصاویر

عکس پروفایل و آیکون چت — فایل PNG یا JPG، حداکثر ۲ مگابایت. اگر چیزی آپلود نکنید، آیکون پیش‌فرض میراکل نمایش داده می‌شود.

برندینگ میراکل

به‌صورت پیش‌فرض، یک خط کوچک «پشتیبانی شده توسط میراکل» در پایین ویجت نمایش داده می‌شود. این مورد در تنظیمات ویجت قابل تغییر نیست — فقط در پلن سازمانی به‌صورت خودکار از ویجت حذف می‌شود.

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

برخلاف واتس‌اپ (که در آن فقط اپراتور انسانی پاسخ می‌دهد)، روی تلگرام همان دستیار هوشمند میراکل مستقیماً و خودکار به پیام‌های کاربران جواب می‌دهد — دقیقاً بر اساس همان دانشی که در بخش «دانش ربات» آپلود کرده‌اید. اگر ربات جوابی نداشته باشد یا کاربر درخواست کند، مکالمه به همان شکلی که در «تحویل مکالمه به اپراتور» توضیح دادیم، به صف اپراتور منتقل می‌شود.

چطور وصل کنم؟

1. در تلگرام به ربات رسمی @BotFather پیام بدهید و دستور /newbot را بزنید.
2. یک نام و یک نام‌کاربری (باید به bot ختم شود، مثلاً mystore_support_bot) برای ربات خودتان انتخاب کنید.
3. BotFather یک «توکن» به شما می‌دهد — این توکن را کپی کنید.
4. در داشبورد میراکل، از بخش «تلگرام»، همین توکن را در کادر مربوطه وارد کنید و روی «اتصال به تلگرام» بزنید.

همین! از این لحظه، هر کسی که به همان ربات تلگرامی پیام بدهد، پاسخش را از دستیار هوشمند میراکل می‌گیرد.

قطع اتصال

هر زمان بخواهید، از همان صفحه‌ی «تلگرام» می‌توانید اتصال را قطع کنید.

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

چطور وصل کنم؟

1. در پیشخوان مدیریت وردپرس، به مسیر «ووکامرس ← تنظیمات ← پیشرفته ← REST API» بروید.
2. یک کلید API جدید بسازید و سطح دسترسی آن را روی «فقط خواندن» (Read) بگذارید.
3. Consumer Key و Consumer Secret را که وردپرس نمایش می‌دهد، کپی کنید.
4. در داشبورد میراکل، از بخش «ووکامرس»، آدرس فروشگاه و همین دو کلید را وارد کنید و روی «اتصال به ووکامرس» بزنید.

بعد از اتصال، همگام‌سازی اولیه شروع می‌شود؛ وضعیت به «در حال همگام‌سازی» و بعد به «متصل است» تغییر می‌کند.

همگام‌سازی مجدد

اگر محصولات زیادی اضافه یا تغییر داده‌اید و می‌خواهید فوری به‌روزرسانی شود، از همان صفحه دکمه‌ی «همگام‌سازی مجدد» را بزنید.

قطع اتصال

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

میراکل می‌تواند پیام‌های واتس‌اپ کسب‌وکار شما را هم مستقیماً در پنل اپراتور نشان دهد، در کنار مکالمه‌های وب‌سایت.

نکته‌ی مهم پیش از اتصال

روی واتس‌اپ، هوش مصنوعی هرگز جواب نمی‌دهد — این یک تصمیم عمدی است، نه محدودیت فنی. هر پیامی که از طریق واتس‌اپ برسد، مستقیماً به صف اپراتورهای انسانی شما می‌رود. دلیلش این است که خودکارسازی پیام‌ها روی واتس‌اپ (بدون استفاده از API رسمی کسب‌وکار متا) ریسک مسدود شدن شماره توسط واتس‌اپ را افزایش می‌دهد.

اگر می‌خواهید ربات هوشمند مستقیماً و خودکار به پیام‌ها جواب بدهد، «اتصال به تلگرام» دقیقاً همین قابلیت را دارد — چون تلگرام یک API رسمی و امن برای ربات‌ها دارد و این ریسک را ندارد.

چطور وصل کنم؟

1. به بخش «واتس‌اپ» در داشبورد بروید و روی «اتصال به واتس‌اپ» بزنید.
2. یک کد QR روی صفحه نمایش داده می‌شود.
3. گوشی‌ای که واتس‌اپ کسب‌وکارتان روی آن نصب است را بردارید، به «واتس‌اپ ← دستگاه‌های متصل ← اتصال دستگاه جدید» بروید و همین کد QR را اسکن کنید.
4. بعد از چند لحظه، وضعیت به «متصل» تغییر می‌کند و شماره‌ی متصل‌شده نمایش داده می‌شود.

نکاتی که باید بدانید

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

مکالمه در دو حالت مشخص، به‌صورت خودکار از ربات به یکی از اپراتورهای شما تحویل داده می‌شود:

۱. کاربر صراحتاً بخواهد

اگر بازدیدکننده در پیامش کلماتی مثل «اپراتور»، «کارشناس»، «صحبت با انسان» یا «operator»، «human»، «talk to a person» به‌کار ببرد، ربات بدون تلاش برای پاسخ‌گویی، مستقیم مکالمه را به صف اپراتور می‌فرستد و پیام «شما به یک کارشناس انسانی وصل شدید...» را نشان می‌دهد.

توجه: خود ربات، به‌خاطر «ندانستن جواب یک سوال»، دیگر به‌صورت خودکار مکالمه را به اپراتور وصل نمی‌کند — فقط وقتی جواب را نداند، صادقانه می‌گوید نمی‌داند. واگذاری خودکار فقط برای دو مورد همین صفحه اتفاق می‌افتد.

۲. پیام خارج از ساعت کاری تنظیم‌شده برسد

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

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

اطلاع‌رسانی به اپراتور

میراکل می‌تواند هروقت یک مکالمه به اپراتور واگذار شد، بلافاصله یک پیام تلگرامی هم برایتان بفرستد:

1. حساب تلگرام کسب‌وکارتان را از بخش «تلگرام» در داشبورد وصل کنید.
2. از این به بعد، هر بار مکالمه‌ای واگذار شود، پیام هشدار به همان چت تلگرام ارسال می‌شود.

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

هر مکالمه‌ای که واگذار شود (یا از واتس‌اپ برسد؛ واتس‌اپ همیشه مستقیم به اینجا می‌آید، نه از طریق ربات)، در پنل اپراتور به‌صورت زنده نمایش داده می‌شود.

اضافه کردن اعضای تیم

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

می‌توانید هر زمان یک اپراتور را حذف کنید؛ مکالمه‌هایی که او در دست داشت، خودکار به صف عمومی (و در دسترس ربات) برمی‌گردند.

تعداد اعضایی که می‌توانید دعوت کنید به پلن‌تان بستگی دارد: پلن پایه تا ۲ اپراتور، حرفه‌ای تا ۱۰ اپراتور، و سازمانی نامحدود. وقتی ظرفیت پلن‌تان پر شود، دکمه‌ی دعوت با راهنمای ارتقای پلن جایگزین می‌شود.

کار با یک مکالمه

• پیام‌های جدید کاربر بی‌درنگ (بدون نیاز به رفرش صفحه) نمایش داده می‌شوند.
• اپراتور می‌تواند مستقیم تایپ کرده و جواب بدهد.
• یک دکمه‌ی «توقف AI و کنترل توسط اپراتور» وجود دارد — با فعال کردنش، ربات دیگر به این مکالمه‌ی خاص پاسخ نمی‌دهد تا وقتی همان اپراتور دوباره کنترل را به «بازگشت به AI» تغییر دهد. این دکمه برای مکالمه‌های واتس‌اپ نمایش داده نمی‌شود، چون آن‌جا اصلاً ربات وارد عمل نمی‌شود.
• با دکمه‌ی «پایان گفتگو»، مکالمه بسته می‌شود.

اگر بیش از یک سایت یا برند دارید، لازم نیست برای هرکدام یک ایمیل و حساب جدا بسازید. میراکل مفهومی به اسم «ورک‌اسپیس» دارد: یک حساب کاربری (ایمیل و رمز عبور) می‌تواند به چند ورک‌اسپیس مجزا وصل باشد.

هر ورک‌اسپیس یعنی چه؟

هر ورک‌اسپیس یک تنانت کاملاً مستقل است:

• دانش، مکالمه‌ها و تنظیمات ویجت خودش را دارد — کاملاً جدا از بقیه‌ی ورک‌اسپیس‌ها
• کلید API اختصاصی خودش را دارد
• پلن و صورتحساب جداگانه دارد — اگر ورک‌اسپیس اول روی پلن «حرفه‌ای» باشد، ورک‌اسپیس دوم می‌تواند همچنان روی پلن «پایه» بماند؛ هزینه‌ها مشترک نیستند.

ساخت یک ورک‌اسپیس جدید

از داخل داشبورد، روی سوییچر ورک‌اسپیس (بالای صفحه) کلیک کنید و «ساخت فضای کاری جدید» را بزنید. کافی است نام و دامنه‌ی برند جدید را وارد کنید — نیازی به ایمیل یا رمز عبور جدید نیست.

جابه‌جایی بین ورک‌اسپیس‌ها

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

از بخش «آمار و آنالیز» در داشبورد، عملکرد ربات را در سه تب می‌بینید.

تب «چت‌ها»

• نمودار روند — تعداد مکالمه‌ها به‌صورت روزانه/هفتگی/ماهانه
• چهار کارت وضعیت — نرخ پاسخ‌گویی موفق، نرخ «نمی‌دانم»، نرخ واگذاری به اپراتور، رضایت کاربران (👍/👎)
• جدول مکالمه‌ها — فهرست تک‌تک مکالمه‌ها با وضعیت و یک ستون «نتیجه»

نکته‌ی مهم درباره‌ی «نتیجه» (outcome)

ستون نتیجه (خرید/ثبت‌نام/تیکت/بدون نتیجه) خودکار تشخیص داده نمی‌شود — این مقدار را باید اپراتور بعد از هر مکالمه، دستی از پنل اپراتور ثبت کند. اگر می‌خواهید نرخ تبدیل دقیقی داشته باشید، عادت بدهید اعضای تیمتان بعد از هر مکالمه‌ی مهم، نتیجه‌اش را علامت بزنند.

تب «موضوعات»

• پرتکرار — سوالاتی که کاربران بیشتر از همه می‌پرسند
• بی‌پاسخ — سوالاتی که ربات نتوانست جواب بدهد
• داغ هفته — موضوعاتی که در ۷ روز اخیر بیشتر پرسیده شده‌اند

فهرست «بی‌پاسخ» را مرتب چک کنید — این دقیق‌ترین راه برای فهمیدن این است که دانش ربات کجا ناقص است.

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

تب «اپراتورها»

برای هر عضو تیم: زمان فعالیت، تعداد مکالمه‌های پذیرفته‌شده، میانگین زمان پاسخ‌گویی و تعداد پیام‌های ارسالی.

اگر فرم سرنخ (Lead Form) برایتان فعال باشد، ربات در میانه‌ی گفتگو از بازدیدکننده می‌خواهد اطلاعات تماسش (نام، شماره، ایمیل) را وارد کند. همه‌ی این اطلاعات در بخش «سرنخ‌ها»ی داشبورد جمع می‌شود.

چه چیزی می‌بینید؟

• آمار کلی — تعداد کل سرنخ‌ها، نرخ تبدیل، پرمراجعه‌ترین صفحه‌ی ورودی سایتتان
• فیلتر بر اساس کانال (وب‌سایت / تلگرام) و بازه‌ی زمانی
• برای هر سرنخ، با یک کلیک کل مکالمه‌ای که آن سرنخ از دلش درآمده را می‌بینید
• دکمه‌ی خروجی CSV برای دانلود فهرست سرنخ‌ها

طراحی فرم سرنخ

فرم سرنخ از «تنظیمات ویجت» قابل طراحی است — می‌توانید:

• عنوان و توضیح فرم را بنویسید
• مشخص کنید فرم بعد از چند پیام از کاربر نمایش داده شود
• برای هر فیلد (نام، تلفن، ایمیل) مشخص کنید فعال باشد یا نه، و اجباری باشد یا اختیاری
• متن دکمه‌ی ارسال را شخصی‌سازی کنید

می‌توانید بیش از یک فرم بسازید — مثلاً یک فرم برای بازدیدکننده‌های عمومی و یک فرم متفاوت برای صفحات محصول خاص.

هر ورک‌اسپیس (برند) در میراکل، پلن و صورتحساب مستقل خودش را دارد. جزئیاتش را از «تنظیمات → پلن‌ها و اشتراک» می‌بینید.

پلن‌های موجود

اگر دوره‌ی سالیانه را انتخاب کنید، ۲۰٪ تخفیف روی هر سه پلن اعمال می‌شود (پرداخت یک‌جا برای ۳۶۵ روز).

چه چیزی فقط در پلن‌های بالاتر است؟

مکالمه‌های قدیمی‌تر از سقف آرشیو پلن‌تان به‌صورت خودکار پاک می‌شوند تا حجم دیتابیس کنترل‌شده بماند. سرنخ‌های ثبت‌شده (اسم/ایمیل/تلفن بازدیدکننده) همیشه باقی می‌مانند، حتی بعد از پاک شدن خود مکالمه.

ارتقای پلن

روی دکمه‌ی ارتقا در همان صفحه بزنید و دوره‌ی ماهیانه یا سالیانه را انتخاب کنید — به درگاه پرداخت زرین‌پال منتقل می‌شوید، پرداخت را انجام می‌دهید و خودکار به داشبورد برمی‌گردید. بلافاصله بعد از پرداخت موفق، پلن و سقف پیام جدید برای ۳۰ روز (یا ۳۶۵ روز برای دوره‌ی سالیانه) فعال می‌شود.

اگر سقف پیام ماهانه تمام شود چه اتفاقی می‌افتد؟

فقط موتور هوش مصنوعی متوقف می‌شود — نه کل پشتیبانی. وقتی سقف پیام یک ورک‌اسپیس در یک ماه تمام شود:

• ربات دیگر پاسخ تولید نمی‌کند؛ به‌جایش پیامی نشان داده می‌شود که می‌گوید ربات موقتاً در دسترس نیست.
• پیام کاربر گم نمی‌شود و مکالمه خودکار برای یکی از اپراتورهای شما علامت‌گذاری می‌شود.
• اپراتورها همچنان و بدون هیچ محدودیتی می‌توانند به همه‌ی مکالمه‌ها پاسخ بدهند — سقف پیام فقط مصرف API هوش مصنوعی را کنترل می‌کند، نه توانایی تیم شما برای پاسخ‌گویی دستی.

این محدودیت تا شروع دوره‌ی بعد یا تا زمانی که پلن را ارتقا دهید، ادامه دارد.

پیشنهاد می‌کنیم قبل از رسیدن به سقف، از همان صفحه‌ی «پلن‌ها و اشتراک» وضعیت مصرف را چک کنید تا غافلگیر نشوید — مخصوصاً اگر انتظار افزایش ناگهانی ترافیک سایت را دارید.

یکی از رایج‌ترین نگرانی‌ها درباره‌ی هر سرویس چند-مستأجری این است: «آیا داده‌ی من ممکن است دست مشتری دیگری بیفتد؟» در میراکل، جواب این نگرانی فقط یک قول نیست؛ دو لایه‌ی مستقل از هم آن را تضمین می‌کنند.

لایه‌ی اول: فیلتر در کد برنامه

هر درخواستی که به سرور می‌رسد، بر اساس کلید API یا حساب کاربری، مشخص می‌شود مربوط به کدام مشتری است، و کوئری‌های دیتابیس همیشه با شناسه‌ی همان مشتری فیلتر می‌شوند. این لایه‌ی معمول و رایج در اکثر سرویس‌هاست.

لایه‌ی دوم (که کمتر سرویسی دارد): امنیت در سطح خود دیتابیس

اینجاست که میراکل فراتر می‌رود. حتی اگر بخشی از کد برنامه یک روز اشتباهی داشته باشد و فراموش کند فیلتر مشتری را اعمال کند، خودِ پایگاه‌داده اجازه نمی‌دهد یک ردیف داده متعلق به مشتری دیگر خوانده یا نوشته شود. این قابلیت با تکنولوژی «Row-Level Security» پیاده‌سازی شده:

• روی تمام جدول‌های حساس (کاربران، اسناد، تکه‌متن‌های دانش، مکالمه‌ها، پیام‌ها، رویدادهای آنالیتیکس، پرداخت‌ها، اتصال‌های تلگرام/واتس‌اپ/ووکامرس و...) یک قانون دیتابیسی فعال است که فقط ردیف‌های مربوط به همان مشتری را قابل مشاهده می‌کند.
• برنامه‌ی میراکل با یک حساب کاربری دیتابیسی محدود (نه یک حساب مدیر کل) به پایگاه‌داده وصل می‌شود — یعنی حتی برنامه هم اجازه‌ی دور زدن این قانون را ندارد.
• شناسه‌ی مشتری فعلی، فقط برای مدت همان یک درخواست نگه داشته می‌شود و هرگز بین درخواست‌های مختلف قاطی نمی‌شود.

محافظت در برابر خزیدن مخرب سایت

وقتی آدرس یک سایت برای خزیدن وارد می‌کنید، میراکل قبل از باز کردن هر آدرس، بررسی می‌کند که آن آدرس به یک سرور داخلی/خصوصی اشاره نداشته باشد — این از یک نوع حمله‌ی امنیتی معروف به نام SSRF جلوگیری می‌کند که در آن یک آدرس مخرب می‌تواند سرور را وادار کند اطلاعات داخلی و محرمانه را برگرداند.

کلید API چیست؟

وقتی ثبت‌نام می‌کنید، میراکل یک کلید API طولانی و تصادفی (۶۴ کاراکتر) مخصوص همان ورک‌اسپیس شما می‌سازد. این کلید همان چیزی است که ویجت روی سایتتان از آن استفاده می‌کند تا خودش را به سرور میراکل معرفی کند.

کلید شما را می‌توانید در «تنظیمات → نصب ویجت» یا داخل کد نصب/افزونه‌ی وردپرسی که دانلود می‌کنید، پیدا کنید — همیشه از قبل داخل کد قرار داده شده.

نکته: در حال حاضر امکان ساخت مجدد (Regenerate) کلید API از داخل داشبورد وجود ندارد. اگر نگران درز کردن کلیدتان هستید، مهم‌ترین کاری که همین حالا می‌توانید انجام دهید این است که در بخش «دامنه‌های مجاز» فقط دامنه‌ی واقعی سایتتان را ثبت کنید — این‌طور حتی اگر کلید جایی دیده شود، فقط روی سایت خودتان قابل استفاده است.

ورود به داشبورد (حساب کاربری)

ورود شما و همکارهایتان به داشبورد، جدا از کلید API ویجت است و با ایمیل/رمز عبور و یک نشانه‌ی امنیتی که به مدت ۲۴ ساعت معتبر است انجام می‌شود. نقش هرکسی (مدیر یا اپراتور) داخل همین نشانه ثبت می‌شود.

رمزنگاری اطلاعات حساس یکپارچه‌سازی‌ها

توکن‌های حساسی که برای اتصال به سرویس‌های دیگر وارد می‌کنید — مثل توکن ربات تلگرام یا کلیدهای ووکامرس — هرگز به‌صورت متن ساده در دیتابیس ذخیره نمی‌شوند؛ قبل از ذخیره رمزنگاری می‌شوند و فقط در لحظه‌ی نیاز واقعی، رمزگشایی و استفاده می‌شوند.