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

با استفاده از از API های رایچت میتوانید سیستم یا وب سایت خود را بیشتر با رایچت هماهنگ کنید . در ادامه Api هایی که تا اکنون منتشر شده اند را مشاهده می کنید . رایچت همیشه در حال بروزرسانی هست پس منتظر API های جدید باشید :) .










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

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) {

});
                



ایجاد وب سایت

با استفاده از این API میتوانید در رایچت ثبت نام کنید. این قسمت بیشتر برای سیستم های سایت ساز و فروشگاه ساز که قصد دارند به صورت اتوماتیک برای هر کاربری که در سیستمشون ثبت نام میکنه یک اکانت رایچت ایجاد کنند و کد را نیز در سایت قرار دهند کاربرد دارد.
* برای استفاده از این قسمت ابتدا یک اپ از طریق این لینک ایجاد کنید و کلید API خود را دریافت کنید.

Route Method
https://app.raychat.io/api/site POST

مقادیر ارسالی

Field Type Description
apiKey String کلیدی که هنگام ایجاد اپلیکیشن در پنل دریافت کردید
site String آدرس سایتی که میخواهید در رایچت ثبت کنید
siteTitle String عنوان سایتی که میخواهید در رایچت ثبت کنید
email String ایمیل مدیر وب سایت
password String رمز عبور
name String نام مدیر وب سایت
phone String تلفن مدیر وب سایت

مقادیر برگشتی

Field Type Description
message String پیام برگشتی از سرور
status Int وضعیت
code String کد رایچت برای قرار دادن در وب سایت
user Object اطلاعات کاربر ایجاد شده
token string توکن کانال
url string آدرس پنل مدیریت رایچت
webAppUrl string آدرس اپلیکیشن تحت وب رایچت

* پاسخ بصورت JSON برگشت داده میشود.
* در صورت بروز خطا ، علت در پاسخ توضیح داده خواهد شد.
* وضعیت برابر 1 به معنی موفقیت آمیز بودن ثبت نام است.

// NodeJs Example
request.post({
url:'https://app.raychat.io/api/site',
form: {
        apiKey:'Your Api Key',
        site:'https://example.com',
        siteTitle:' Example Title',
        email:'test@example.com',
        password: 'Password',
        name:'Hamed Gholizadeh',
        phone:'09000000000'
      }
}, function(err,httpResponse,body){
    /* ... */
});