چطور چت‌بات را روی سایت نصب کنیم؟ ویجت و API

ویجت یا API؟ کدام را انتخاب کنیم

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

پیش از نصب: ربات را آماده کنید

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

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

نصب ویجت با یک خط کد

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

<script src="https://YOUR-DOMAIN/widget.js"
        data-key="wk_xxxxxxxx" async></script>

ظاهر ویجت: رنگ، عنوان و جای دکمه

ظاهر را از همان بخش نصب تنظیم می‌کنید و پیش‌نمایش زنده می‌بینید.

• رنگ: رنگ اصلی برند را انتخاب کنید تا با سایت هماهنگ باشد.
• جای دکمه: گوشه‌ی شروع یا پایان صفحه؛ جایی را بگیرید که با دکمه‌های دیگر سایت تداخل نکند.
• عنوان: نام کسب‌وکار یا نام ربات.
• متن کنار دکمه: یک جمله‌ی کوتاه و اختیاری، مثل «سؤالی دارید؟»

بعد از نصب: تست واقعی

قبل از اینکه خبرش را به مشتری‌ها بدهید، چند دقیقه امتحان کنید.

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

اتصال با API برای توسعه‌دهنده‌ها

اگر می‌خواهید ربات را در اپ، پنل کاربری یا هر محصول دیگری بگذارید، از API استفاده کنید. برای هر کسب‌وکار یک کلید اختصاصی می‌سازید و درخواست‌ها را به این نشانی می‌فرستید: POST به مسیر /api/v1/public/v1/chat با هدر Authorization و مقدار Bearer و کلید.

بدنه‌ی درخواست JSON است و دو فیلد دارد: message که پیام کاربر است و user_id که شناسه‌ای از طرف شما برای تشخیص مشتری است. پاسخ شامل conversation_id و message است و داخل message دو چیز می‌بینید: متن جواب و فهرست منبع‌ها.

curl -X POST https://YOUR-DOMAIN/api/v1/public/v1/chat \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "message": "ارسال به شیراز چند روزه است؟",
    "user_id": "customer-42"
  }'

const res = await fetch('https://YOUR-DOMAIN/api/v1/public/v1/chat', {
  method: 'POST',
  headers: {
    Authorization: 'Bearer ' + process.env.RAVANO_API_KEY,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    message: 'ارسال به شیراز چند روزه است؟',
    user_id: 'customer-42',
  }),
})
const { conversation_id, message } = await res.json()
console.log(message.content, message.citations)

امنیت: کلید API را کجا نگه داریم؟

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

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

اگر ویجت دیده نشد: فهرست عیب‌یابی

• کد را قبل از بسته شدن تگ body گذاشته‌اید و در محل درستی ذخیره شده است؟
• دامنه‌ی سایت در فهرست سایت‌های مجاز پنل هست؟ حتی تفاوت www و بدون www می‌تواند مسئله بسازد.
• ویجت از پنل خریداری و فعال شده است و موجودی کیف پول کافی است؟
• کش سایت یا افزونه‌ی بهینه‌سازی قدیمی را پاک کنید و صفحه را دوباره باز کنید.
• در کنسول مرورگر خطایی دیده می‌شود؟ گاهی افزونه‌های مسدودکننده یا سیاست امنیتی صفحه، اسکریپت را نمی‌گذارند اجرا شود.
• ربات در پنل ساخته و تأیید شده است و در صفحه‌ی گفتگوی پنل درست جواب می‌دهد؟

یک نکته درباره‌ی حریم خصوصی

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

اگر آماده‌اید، رایگان شروع کنید، ربات را بسازید و بعد با ویجت یا API روی سایت‌تان بگذارید. برای ایده‌ی بیشتر، راهنمای ساخت چت‌بات برای وب‌سایت و ربات پشتیبان مشتری را هم ببینید.

پرسش‌های متداول