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

API سمت کاربر این امکان را به شما می دهد تا ابزارکی که برای کاربر نمایش داده می شود را مدیریت کنید. از آن می توانید برای مدیریت صفحه چت و همچنین ارسال اطلاعات کاربر به اپلیکیشن رایچت استفاده کنید . (برای مثال می توایند اطلاعات کاربری که به سایت شما لاگین کرده را به رایچت بفرستید تا در اپلیکیشن نمایش داده بشه تا بعداً در آرشیو بهش دسترسی داشته باشید).

نکته: تمامی توابع و رویداد هایی که در ادامه توضیح داده خواهند شد باید طبق دستورالعمل سمت راست (داخل رویداد raychat_ready) نوشته شوند.

window.addEventListener('raychat_ready', function (ets) {

   // function or event 

});

توابع

با استفاده از توابعی که در ادامه توضیح داده خواهد شد میتوانید با اطلاعات کاربران کار کنید یا ابزارک رو باز و بسته کنید . این قسمت همیشه در حال بروزرسانی هست و با توجه به نیاز کاربران امکانات و توابع جدیدی اضافه خواهد شد .










تابع setUser

با استفاده از این تابع می توانید اطلاعات کاربری که به وب سایت شما لاگین کرده را به رایچت ارسال کنید .

Field Type Description
email string ایمیل کاربر لاگین شده
name string نام کاربر لاگین شده
about string درباره ی کاربر لاگین شده
phone string تلفن کاربر لاگین شده
avatar string عکس کاربر لاگین شده
updateOnce boolean در هر بار فراخوانی این تابع اطلاعات کاربر به روز شود یا خیر
 window.Raychat.setUser({
   email: 'pm@raychat.io',
   name: 'Hamed Gholizadeh',
   about: 'about me :)',
   phone: '09123456789',
   avatar: 'http://app.raychat.io/hamed.png',
   updateOnce: true
  });
                

تابع getUser

با استفاده از این تابع می توانید اطلاعات بازدیدکننده ای که در حال حاضر در وب سایت هست را دریافت کنید.
مقادیر برگشتی :

key value Type Description
id string آیدی کاربر
name string نام کاربر
email string ایمیل
avatar string عکس کاربر
online string وضعیت کاربر
createdAt Date تاریخ ایجاد کاربر
history array تاریخچه ی فعالیت کاربر در صفحات مختلف سایت
browser Object اطلاعات مرورگر کاربر
phone string شماره تلفن کاربر
about string اطلاعات کاربر


var user = window.Raychat.getUser(); //example user object { id: '5992bc6d9e737c900e3058d3', name: 'Saman Baboli', email: 'cto@raychat.io', avatar: 'http://app.raychat.io/saman.png', online: true, createdAt: 2017-08-15T09:18:37.904Z, history : [ { "href" : "http://raychat.io/api/", "duration" : 27 } ], browser : { "name" : "Chrome", "ver" : "60.0.3112.90", "os" : "Windows", "mobile" : false }, phone: '09354140661', about: 'hello :)' }

تابع sendOfflineMessage

ارسال پیام از طریق ابزارک رایچت به کاربر

نکته : این پیام صرفا در سمت کاربر نمایش داده میشود و اپراتور قادر به دیدن این پیام نمی باشد و همچنین مکالمه محسوب نمیشود و با رفرش کردن صفحه پاک می شود.

window.Raychat.sendOfflineMessage('سلام وقت بخیر');
                




تابع open

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

window.Raychat.open();
                

تابع close

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

winow.Raychat.close();
                

تابع toggle

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

window.Raychat.toggle();
                

تابع animate

شخصی سازی حالت انیمیشن آیکون ابزارک چت . این کار باعث میشود که توجه کاربر بیشتر به ابزارک جلب شده و در نتیجه احتمال اینکه کاربر سر صحبت را باز کند بیشتر خواهد شد

Animations
bounce
wobble
tada
shake
rubberBand
swing
jello
rotateIn
window.Raychat.animate('tada');
                

تابع isWidgetOpen

با استفاده از این تابع میتوان تشخیص داد که ابزار چک باز است یا خیر

Result Des
true باز است
false بسته است
window.Raychat.isWidgetOpen();
                




رویداد ها

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

رویداد raychat_user_profile_updated

زمانی که اطلاعات کاربر بروز میشود این رویداد اجرا میشود به طور مثال زمانی که کاربر ایمیلش را در قسمت با خبرشو ثبت می کند.

Raychat.on('raychat_user_profile_updated', function (user) {

});
                

رویداد open

زمانی که کاربر ابزارک چت را باز کند این رویداد اجرا میشود .

Raychat.on('open', function (s) {

});
                

رویداد close

زمانی که کاربر ابزارک چت را ببندد این رویداد اجرا میشود .

Raychat.on('close', function (s) {

});