چگونه از مستندات رایچت api برای توسعه دهندگان استفاده کنیم؟

در مقاله‌های گذشته به معرفی وب‌سرویس رایچت پرداختیم. همچنین آخرین تغییرات این سیستم ارتباطی را بررسی کردیم. اکنون در این مقاله قصد داریم مستندات رایچت api برای توسعه دهندگان را بررسی کنیم. این راهنما به شما کمک می‌کند تا سایت خود را به این ابزار مجهز کنید. بنابراین فرایند پشتیبانی از مشتریان بسیار ساده‌تر خواهد شد. توسعه‌دهندگان می‌توانند از این مستندات برای هماهنگی بیشتر استفاده کنند. از این رو شما کنترل کاملی بر روی ابزارک گفتگو خواهید داشت. پس تا پایان این مقاله کاربردی همراه ما باشید.

🚀 مزیت‌های استفاده از مستندات رایچت

استفاده از مستندات رایچت مزایای فنی و تجاری زیادی دارد. در ادامه برخی از مهم‌ترین مزیت‌های این سیستم را نام می‌بریم:

🚀 یکپارچه‌سازی سریع: شما می‌توانید در زمان کوتاهی چت‌باکس را راه‌اندازی کنید. این امر هزینه‌های توسعه شما را به شدت کاهش می‌دهد.
👤 شناسایی کاربران: اطلاعات کاربران به صورت خودکار به اپلیکیشن رایچت متصل می‌شود. در نتیجه نیازی به پرسیدن نام کاربران ندارید.
📈 بهبود تجربه کاربری: ابزارک چت را بر اساس رفتار کاربر شخصی‌سازی کنید. این کار نرخ تبدیل سایت شما را افزایش می‌دهد.
🛠️ پایداری اطلاعات: مکالمات کاربران به صورت همیشگی در سیستم ذخیره می‌شوند. بنابراین تاریخچه گفتگوها هرگز از بین نخواهد رفت.

💼 کاربردهای اصلی وب‌سرویس رایچت

برنامه‌نویسان در پروژه‌های مختلفی از این API استفاده می‌کنند. برنامه‌نویسی اختصاصی امکانات زیادی را به شما می‌دهد. برخی از کاربردهای مهم شامل موارد زیر است:

🛒 سیستم‌های سایت‌ساز: ایجاد خودکار اکانت رایچت برای خریداران فروشگاه‌سازها. با این روش کاربران شما بلافاصله چت‌باکس را تحویل می‌گیرند.
💼 اتصال به CRM: انتقال داده‌های گفتگو به سیستم مدیریت مشتریان شما. این کار هماهنگی تیم فروش را بسیار بیشتر می‌کند.
📊 تحلیل آماری دقیق: ردیابی دقیق رفتارهای مخاطبان در هنگام چت. از این طریق می‌توانید نقاط ضعف سایت خود را بیابید.

⚙️ راهنمای فنی مستندات رایچت api برای توسعه دهندگان

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

توابع مدیریت کاربر در مستندات رایچت

تابع setUser: با استفاده از این تابع اطلاعات کاربر لاگین شده را می‌فرستید. این کار به اپراتورها کمک زیادی می‌کند. آن‌ها نام و ایمیل کاربر را بلافاصله می‌بینند.
تابع getUser: این متد اطلاعات بازدیدکننده فعلی سایت را به شما می‌دهد. شما می‌توانید از این اطلاعات برای شخصی‌سازی پیام‌ها استفاده کنید.
تابع loadUser: این تابع کاربران وارد شده به پنل را بارگذاری می‌کند. در نتیجه مکالمات آن‌ها به صورت پایدار حفظ می‌شود. زمانی که کاربر با موفقیت بارگذاری شد، رویداد raychat_new_user_loaded اجرا می‌گردد. حتماً شناسه کاربر را در دیتابیس خود ذخیره کنید. در غیر این صورت دسترسی به گفتگوهای قبلی غیرممکن می‌شود.
تابع unloadUser: این متد تمامی اطلاعات کاربر را از مرورگر حذف می‌کند. بنابراین در بازدید بعدی، کاربر جدیدی ایجاد می‌شود. پس از صدا زدن این تابع مرورگر را دوباره بارگذاری کنید. این کار برای اعمال تغییرات الزامی است.

توابع کنترل وضعیت ابزارک گفتگو

تابع sendOfflineMessage: شما می‌توانید پیامی آفلاین برای کاربر بفرستید. البته این پیام فقط در سمت کاربر نمایش داده می‌شود. اپراتور این پیام را دریافت نمی‌کند. همچنین با رفرش صفحه، پیام پاک خواهد شد.
تابع open: این متد ابزارک چت را به طور خودکار باز می‌کند. فرمت اجرای آن به صورت زیر است:

javascript

  window.Raychat.open();

تابع close: برای بستن سریع ابزارک گفتگو از این تابع استفاده کنید.
تابع toggle: این تابع وضعیت ابزارک را تغییر می‌دهد. اگر باز باشد، آن را می‌بندد و برعکس. کد آن به صورت زیر نوشته می‌شود:

javascript

  window.Raychat.toggle();

تابع animate: توجه کاربران را به ابزارک جلب کنید. این تابع انیمیشن آیکون گفتگو را تغییر می‌دهد. در نتیجه شانس شروع گفتگو افزایش می‌یابد.
تابع isWidgetOpen: به کمک این متد وضعیت باز یا بسته بودن پنجره گفتگو را بررسی کنید.

🔔 رویدادهای مهم در مستندات رایچت

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

رویداد raychat_user_profile_updated: این رویداد زمانی اجرا می‌شود که اطلاعات پروفایل کاربر به‌روزرسانی شود. به عنوان مثال، کاربر ایمیل خود را وارد می‌کند. سیستم بلافاصله این رویداد را شناسایی می‌کند. شما می‌توانید این تغییرات را به سرور خود بفرستید. بنابراین اطلاعات کاربران شما همیشه به‌روز باقی خواهد ماند.
رویداد open: زمانی که مخاطب ابزارک چت را باز می‌کند، این رویداد فراخوانی می‌شود. شما می‌توانید از این رویداد برای ردیابی رفتار کاربر استفاده کنید. نمونه کد آن به شکل زیر است:

javascript

  window.Raychat.on('open', function (s) {
      // کدهای شما در اینجا
  });

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

💻 مراحل ثبت‌نام و فعال‌سازی وب‌سرویس رایچت

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

🌐 ابتدا وارد پنل مدیریت در آدرس p.api.ir شوید.
🔑 یک حساب کاربری جدید برای خود بسازید.
💻 سپس یک اپلیکیشن اختصاصی تعریف کنید و کلید API را دریافت نمایید.

پاسخ‌های سیستم رایچت به صورت فرمت استاندارد JSON ارسال می‌شوند. در صورت موفقیت‌آمیز بودن ثبت‌نام، وضعیت دریافتی برابر عدد ۱ خواهد بود. در صورت بروز هرگونه مشکل، دلیل آن در متن پاسخ اعلام می‌گردد. بنابراین رفع اشکال کدهای شما بسیار ساده خواهد بود.

🎯 جمع‌بندی و نتیجه‌گیری

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