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

ثبت نام و ورود

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

اگر قبلا ثبت نام کرده‌اید، می‌توانید با شماره تماس یا نام خود وارد محیط کاربری شوید.

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

 

الماس ها و امتیازها (واحد درون‌برنامه‌ای)

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

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

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

 

ردیف امکانات/مصرف منابع واحد مقدار
1 پل ارتباطی الماس 20
2 پایگاه داده الماس 30
3 هر 5 ستون در پایگاه داده الماس 5
4 هر محصول/مطلب الماس 1
5 پیام پرداخت محصول/مطلب الماس 2
6 حذف تبلیغات الماس 10
7 شرط الماس 2
8 درگاه پرداخت الماس 30
9 هر زیرفرآیند در فرآیند منوی ساده الماس 2
10 هر زیرفرآیند در فرآیند فرم دریافت اطلاعات الماس 3
11 هر زیرفرآیند در انتقال پست الماس 20
12 انتقال پست گروهی الماس 500
13 مدیر گروه الماس 30
14 هر گروه افزوده شده در مدیر گروه الماس 20
15 دسترسی به تنظیمات مدیر گروه از گروه الماس 20
16 استفاده Regex در مدیر گروه الماس 5
17 افزودن زیرفرآیند در مدیر گروه الماس 10
18 گرفتن خروجی اطلاعات الماس 40
19 هر زیرفرآیند در عملیات زماندار (کرون جاب) الماس 40
20 فرآیند وبلاگ/فروشگاه الماس 40
21 فرآیند پیشرفته الماس مطابق جدول زیر
22 کدنویسی سفارشی الماس توافقی (براساس امکانات درخواستی)
23 هر پلاگین الماس 2
24 پل ارتباطی بله (GetUpdates) الماس 50
25 پل ارتباطی تلگرام (GetUpdates) الماس 50
26 صهبات در بله الماس 40
27 صهبات در آیگپ الماس 40
28 صهبات در تلگرام الماس 40

 

برای فرآیند پیشرفته نیز هزینه بلوک‌های ایجاد شده به شکل زیر هستند:

 

ردیف امکانات/مصرف منابع واحد مقدار
1 عمومی الماس 1
2 نگهداری وضعیت دستور الماس 2
3 ذخیره چند فیلد در پایگاه داده الماس 2
4 دریافت رکورد پایگاه داده الماس 3
5 شمارش ورودی در پایگاه داده الماس 2
6 جستجو در اکسل الماس 5
7 تعداد رکوردهای اکسل الماس 4
8 اتصال به API الماس 20
9 اتصال به API تحریمی الماس 40
10 جستجو در JSON الماس 3
11 دریافت مطالب الماس 3
12 دریافت مجموعه‌ها الماس 3
13 دریافت تراکنش الماس 3
14 for الماس 8
15 for each الماس 8
16 continue, break الماس 4
17 repeat الماس 8
18 repeat ext الماس 8
19 while until الماس 8
20 سایر بلوک‌ها الماس 1

 

جدول مصرف امتیازها:

 

ردیف امکانات/مصرف منابع واحد مقدار
1 ارسال پیام امتیاز 1
2 دریافت پیام امتیاز 1
3 فایل ارسالی از پل (1 عدد) امتیاز 5
4 فایل (1 مگابایت) امتیاز 5
5 انجام عملیات زماندار (کرون جاب) امتیاز 3
6 هر ورودی پایگاه داده امتیاز 2
7 هر خروجی از پایگاه داده امتیاز 150
8 هر رمز یکبار مصرف امتیاز 300
9 ذخیره پیام (هر روز) امتیاز 4
10 بروزرسانی یک رکورد در نسخه متناظر امتیاز 1
11 بروزرسانی هر صد رکورد در صهبات براساس نسخه متناظر (طبق زمان‌بندی تعیین شده در تنظیمات نسخه متناظر) امتیاز 1
12 هر بار کارکرد API متصل شده امتیاز 2
13 هر بار کارکرد API تحریمی متصل شده امتیاز 3

 

محیط کاربری ربات‌ساز

پس از ورود به ناحیه کاربری ربات‌ساز چهار گزینه اصلی پیش روی شما خواهند بود که عبارتند از:

  • میزکار
  • ربات‌ها
  • گفتگوها
  • درگاه‌های پرداخت

در ادامه به شرح این موارد خواهیم پرداخت.

میز کار

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

 

 

ربات‌ها

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

 

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

  • امتیاز
  • الماس
  • صفحه گفتگوی ربات

 

 

اطلاعات ربات

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

پل‌های ارتباطی

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

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

 

 

 

 

فرآیندها

یکی از مهم‌ترین بخش‌های ربات‌ساز که ساختار کلی عملکرد ربات در آن تنظیم می‌شود فرآیندها است. با ورود به فرآیندها دو گزینه اصلی ایجاد برچسب جدید (که برای تمایز فرآیندهای مختلف به کار می‌رود) و ایجاد فرآیند جدید مشاهده می‌شود.

 

 

برای عملکردهای مختلف ربات، انواع فرآیندها در نظر گرفته شده‌اند که به اختصار شرح داده می‌شوند:

منو ساده

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

 

 

فرم دریافت اطلاعات

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

 

 

انتقال پست

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

 
کد سفارشی

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

کرون جاب

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

وبلاگ/فروشگاه

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

 

 

پیشرفته

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

 

مدیر گروه

فرآیند مدیر گروه، یک دستیار هوشمند با بسیاری از امکانات مدیریتی است. تعدادی از دستورهای مهم که می‌توانید با نوشتن آن‌ها فرمان مدنظر را صادر کنید در جدول زیر ارائه شده اند:

 

علامت قبل از فرمان متن فرمان جزئیات فرمان واحد نحوه ارجاع عملکرد
! یا . پیکربندی - - پیام مستقل بروزرسانی اطلاعات مالک و مدیران
! یا . سکوت - ساعت ریپلای به پیام محدودیت ارسال پیام
! یا . اخراج (بن) - ساعت ریپلای به پیام محدودیت دسترسی کاربر مورد نظر
! یا . آزاد - - ریپلای به پیام پاک شدن همه بن‌ها، اخطارها و برداشته شدن محدودیت‌ها
! یا . ریست - - ریپلای به پیام فقط پاک شدن اخطارها
! یا . گروه آزاد/قفل - پیام مستقل آزاد یا قفل کردن گروه
! یا . اضافه به لیست سفید/لیست سیاه - ریپلای به پیام افزودن کاربر به لیست سفید یا سیاه
! یا . حذف از لیست سفید/لیست سیاه - ریپلای به پیام حذف کردن کاربر از لیست سفید یا سیاه
! یا . پاکسازی کل/از اینجا/x ساعت - متنوع پاکسازی پیام‌ها

 

 

مسیرساز

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

 

پلاگین‌ها

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

سلام <peer>title</peer> عزیز
زمان: <date></date>

در این صورت، به جای تگ peer که در متن اضافه کردیم، عنوان (نام) فرد که در پیامرسان برای خود تعیین کرده نمایش داده می شود و به جای تگ date، زمان نمایش داده می شود:

سلام محمد عزیز
زمان: 1403/12/06 12:17:23

در صورتی که قصد دارید تنها بخش مشخصی از تاریخ نشان داده شود می‌توانید داخل پلاگین date نمایش آن را محدود نمایید. مانند:

تاریخ امروز: <date>y/m/d</date>

که به صورت زیر نشان داده خواهد شد:

تاریخ امروز: 04/01/12

اگر می‌خواهید از ربات در گروه استفاده نمایید دیگر پلاگین peer برای نشان دادن نام کاربر به درستی عمل نخواهد کرد. پس باید از پلاگین author که فرستنده پیام را شناسایی می‌کند استفاده کرد. مانند پیام خوش‌آمد زیر:

سلام <author>title</author> عزیز! به گروه ما خوش اومدی

یا اگر می خواهیم از متن خود کاربر در متن رباتمان استفاده کنیم می توانیم از تگ msg استفاده کنیم:

متن ارسالی شما: <msg>text</msg>

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

<dbentry>name</dbentry> عزیز
شماره موبایل <dbentry>mobile</dbentry> برای شما ثبت شد.
هم اکنون می توانید از امکانات ربات ما استفاده کنید.

یعنی اگر فرد در فرم ثبت نام، نام «محمد» و شماره موبایل «09111111111» را ثبت کرده باشد، پیام به این صورت برایش ارسال خواهدشد:

محمد عزیز
شماره موبایل 09111111111 برای شما ثبت شد.
هم اکنون می توانید از امکانات ربات ما استفاده کنید.

همانطور که مشخص است، در نحوه نوشته شدن تگ‌ها از قوانین عمومی که در html و xml وجود دارد پیروی می شود. یعنی هر تگ با علامتهای < و > ساخته می شود و از 2 بخش شروع و پایان تشکیل می شود. در بخش شروع، نام تگ اضافه  (مثلا <msg>) و در بخش پایانی، یک اسلش نیز قبل از نام تگ قرار می گیرد (مثل </msg>). متن ها و ویژگیهای بین این دو بخش، توسط پلاگینی که نام آن در تگ تعیین شده است تحلیل و در صورت نیاز، تغییر داده خواهندشد.

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

چند نکته درباره پلاگین ها وجود دارد:

1. امکان استفاده از چندین ویژگی یک پلاگین به طور همزمان داخل یک تگ وجود دارد. در این صورت، باید آنها را داخل {} بنویسیم

<dbentry>
{name} عزیز
شماره موبایل
{mobile}
برای شما ثبت شد.
هم اکنون می توانید از امکانات ربات ما استفاده کنید.
کد رهگیری شما:
{$id}
</dbentry>

یا به عنوان مثال برای تگ peer می توانیم بنویسیم:

<peer>
سلام {title} عزیز
نام کاربری شما @{username} است.
</peer>

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

مثلا اگر می خواهیم تاریخ را با کاراکترهای فارسی نمایش دهیم می توانیم آن را در تگ fanum قرار دهیم:

<fanum><date></date></fanum>

در این صورت ابتدا تاریخ توسط پلاگین date تولید می شود و سپس اعداد آن توسط پلاگین fanum به کاراکترهای فارسی تبدیل می شود.

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

حال که به طور اجمالی با نحوه استفاده از پلاگین‌ها آشنا شدیم، بهتر است ببینیم چه پلاگین‌هایی را می‌توانیم استفاده کنیم و هر پلاگین، چه ویژگی‌هایی دارد:

-اطلاعات حساب کاربری (peer,author)

برای استفاده از نام یا شناسه عددی و یا نام کاربری مخاطب ربات از پلاگین peer برای استفاده در گفتگوی خصوصی کاربر با ربات و از پلاگین author برای استفاده در گروه (مانند پیام خوش‌آمدگویی، اخطار و ...) استفاده می‌شود.

ویژگی عنوان
title نام نمایشی حساب کاربری فرد
username نام کاربری در پیام‌رسان
sys_id شناسه عددی در صهبات
id شناسه عددی در پیام‌رسان

 

-تاریخ و زمان (date)

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

پلاگین date، تاریخ جاری یا تاریخ تعیین شده توسط شما را با قالب دلخواه نمایش می‌دهد.

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

سال/ماه/روز ساعت:دقیقه:ثانیه

 

تگ داخلی عنوان
value تعیین تاریخ دلخواه
modify (مثلا افزودن یا کاستن زمان از تاریخ مورد نظر)مدیریت تاریخ مورد نظر
value-sec تعیین تاریخ به صورت عدد UNIX به صورت ثانیه‌های شمارش شده از سال 1970
value-milisec تعیین تاریخ به صورت عدد UNIX به صورت میلی ثانیه‌های شمارش شده از سال 1970
value-microsec تعیین تاریخ به صورت عدد UNIX به صورت میکرو ثانیه‌های شمارش شده از سال 1970

 

عبارت داخل پلاگین عنوان و توضیح نمونه (بازه) خروجی
Y سال به صورت چهار رقمی 1404
y سال به صورت دو رقمی 04
m ماه به صورت دو رقمی 01-12
M ماه 1-12
d روز به صورت دو رقمی 01-31
j روز 1-31
W هفته از سال 1-52
w روز هفته با اعداد 0 تا 6 (صفر برای یکشنبه) 0-6
N روز هفته با اعداد 1 تا 7 (یک برای دوشنبه) 1-7
D روز از هفته به صورت سه حرفی پنج
l روز از هفته به صورت کامل پنجشنبه
H ساعت به صورت دو رقمی 24 ساعته 00-23
i دقیقه با رقم یکان و دهگان  00-59
s ثانیه با رقم یکان و دهگان 00-59

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

روز و ساعت: <date><value>1404/01/01 19:30:00</value>d/H</date>

روز و ساعت: 01/19

برای زمان به صورت UNIX نیز می‌توان از سه تگ ذکر شده در جدول فوق به صورت زیر استفاده نمود

تاریخ شروع ثبت نام: <date><value-sec>1738355400</value-sec>Y/m/d</date>

تاریخ شروع ثبت نام: 1403/11/11

در صورت نیاز به ویرایش تاریخ به انحا مختلف نیز از تگ modify استفاده می‌شود. در مثال زیر 3 روز به تاریخ حال اضافه و نمایش می‌دهد:

تاریخ اتمام گردش کار: <date><modify>+3 days</modify>Y/m/d</date>

اگر تاریخ امروز 1403/01/17 باشد متن نمایش داده شده به صورت زیر خواهد بود.

تاریخ اتمام گردش کار: 1404/01/20

-پیام کاربر (msg)

این پلاگین که با تگ msg تعیین می شود اطلاعات پیام دریافتی از کاربر (مثل متن، نوع پیام و ...) را در اختیار ما قرار می دهد.

ویژگی‌ها:

 

ویژگی عنوان واحد نمونه خروجی
type نوع پیام - image
text ورودی به صورت پیام متنی - سلام، من درخواست پشتیبانی خدمات دارم.
id شناسه پیام دریافتی - 123456789
file_token توکن ثبت شده برای فایل دریافتی - qwerty1234-uiop
file_unique_id شناسه یکتای ثبت شده برای فایل دریافتی - asdfg9876-hjkl
file_name نام فایل دریافتی - عکس کارت ملی
file_mime نوع دقیق فایل براساس محتوا - application/pdf
file_mime_general نوع عمومی فایل براساس محتوا - application
file_size حجم فایل دریافتی بایت 10000
file_duration طول زمان پخش فایل (فیلم و صوت) ثانیه 60
file_height ارتفاع قاب فایل (عکس و فیلم) پیکسل 1080
file_width پهنای قاب فایل (عکس و فیلم) پیکسل 1920
location_latitude عرض جغرافیایی (لوکیشن) درجه 35.67767765092822
location_longitude طول جغرافیایی (لوکیشن) درجه 51.36976853777408
contact_fname نام مخاطب (اشتراک گذاری مخاطب) - محمد
contact_lname نام و نام خانوادگی مخاطب (اشتراک گذاری مخاطب) - ایران‌نژاد
contact_nname نام مستعار مخاطب (اشتراک گذاری مخاطب) - ایرانی
contact_phone شماره تماس مخاطب (اشتراک گذاری مخاطب) - 09121111111
contact_email ایمیل مخاطب (اشتراک گذاری مخاطب) - mohammad@sahbaa.com

 

به عنوان مثال اگر می خواهید متن ارسالی کاربر را به خودش (یا به فرد یا کانال دیگری ...) ارسال کنید می توانید در متن پیام ارسالی بنویسید:

پیام ارسالی شما: <msg>text</msg>
-اطلاعات ثبت شده توسط کاربر (dbentry,dbentries)

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

تگ داخلی عنوان
db مشخص کردن شناسه دیتابیس مورد نظر جهت فراخوانی داده
entrypeer مشخص کردن شناسه کاربر در صهبات جهت فراخوانی داده
eid مشخص کردن شناسه عددی رکورد ثبت شده در پایگاه داده جهت فراخوانی داده
notfound مشخص کردن پیام ارسالی در صورت عدم وجود داده مورد نظر

 

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

<dbentry>
اطلاعات شما ثبت شد {name} عزیز!
شماره تماس ثبت نامی شما: {phone}
</dbentry>

که به صورت زیر به کاربر ارسال خواهد شد:

اطلاعات شما ثبت شد محمد عزیز!

شماره تماس ثبت نامی شما: 09111111111

یا در مثال زیر اگر کاربر خارج از فرآیند فرم با پایگاه داده مدنظر شماست، می‌توانید با تگ <db> شناسه پایگاه داده خود را مشخص و داده مورد نظر را فراخوانی کنید.

<dbentry><db>9876543</db>
از خرید شما متشکریم {name} عزیز
</dbentry>

پیام به این صورت ظاهر خواهد شد:

از خرید شما متشکریم محمد عزیز

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

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

تگ داخلی عنوان
db مشخص کردن شناسه دیتابیس مورد نظر جهت فراخوانی داده‌ها
entry برای نمایش اطلاعات داخل هر رکورد استفاده می‌شود. عملکرد و نحوه نمایش آن دقیقا مثل تگ dbentry می‌باشد و به تعداد رکوردهای تکرار شده پشت سر هم تکرار خواهد شد
noentries مشخص کردن پیام ارسالی در صورت عدم وجود داده‌های مورد نظر
limit تعداد رکوردهای خروجی (حداکثر 20 مورد و امکان تعیین شروع رکوردها از این بخش نیز وجود دارد (offset))
lastrows فقط در صفحه آخر رکوردها دیده می‌شود
nonlastrows غیر از صفحه آخر رکوردها دیده می‌شود
query کوئری جستجو
jsonoutput برای دریافت خروجی به صورت JSON

 

متغیر سراسری

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

در این مثال اگر شماره تماس و اطلاعات دیگر ادمین به عنوان یک متغیر با عنوان دلخواه contact تنظیم شده باشد، می‌توان آن را به این شکل فراخوانی کرد:

شماره تماس ما: <gvar>contact</gvar>

شماره تماس ما: 09111111111

آدرس: تهران - میدان ولیعصر

روزهای کاری: شنبه تا پنجشنبه 8 تا 16

متغیر فرآیند پیشرفته

با این پلاگین که با تگ var تعریف می شود می توانید مقدار متغیری که در فرآیند پیشرفته تعیین کرده اید را در متن خود استفاده کنید. بنابراین این پلاگین فقط در آیتمهایی قابل استفاده است که در فرآیند پیشرفته اضافه شده اند. مهمترین استفاده آن در بلوک ارسال پیام در فرآیند پیشرفته است. فرض کنید کاربر نمره درس را فرستاده و قرار است شما بگویید این نمره، خوب است، متوسط است یا ضعیف. می توانید بر اساس عملگرهای فرآیند پیشرفته، در متغیری به نام range، خوب، متوسط یا ضعیف بودن نمره را تعیین کنید:

سپس با بلوک ارسال پیام، این متن را به کاربر بفرستید:

سطح نمره شما <var>range</var> می باشد.

اگر نمره متوسط باشد، متن نهایی به این صورت به کاربر فرستاده خواهدشد:

سطح نمره شما متوسط می باشد.

-شروط (if,else)

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

در مثال زیر اگر شرط با شناسه مشخص محقق شود (بررسی نمره) پیام متنی مورد نظر ارسال و اگر محقق نشود پیام متفاوتی  ارسال خواهد شد. فرض کنید:

شما در این درس <if cid="82444263097366">قبول<else>مردود</if> شده اید.

اگر نمره ارسالی کاربر بالای 10 بوده باشد پیغام زیر ارسال خواهد شد:

شما در این درس قبول شده اید.

-اطلاعات پل ارتباطی مورد استفاده (bridge)

امکان استخراج اطلاعات و وضعیت پل ارتباطی با پلاگین‌های مربوط به آن وجود دارد.

ویژگی عنوان
sys_id شناسه عددی پل ارتباطی در صهبات
id شناسه عددی پل ارتباطی در پیام‌رسان
type نام پیام‌رسان
username شناسه ربات در پیام‌رسان
title نام پل ارتباطی در صهبات
webhook_status وضعیت اتصال پل ارتباطی

به عنوان مثال اگر متن پیام به این صورت باشد:

<bridge>
شناسه عددی پل ارتباطی در پیام‌رسان {id} و وضعیت پل {webhook_status} است.
</bridge>

به این شکل نمایش داده خواهد شد

شناسه عددی پل ارتباطی در پیام‌رسان 987654 و وضعیت پل active است.

نقل قول (quote)

پلاگین نقل قول، می‌تواند مقادیر مختلف مانند JSON را در میان "" ارسال نماید.

فیلترها

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

قالب کلی پلاگین‌ها به همراه فیلترها به شکل زیر است:

<plugin>property|filter</plugin>


یا در صورت استفاده تجمیعی از پلاگین‌ها:

<plugin> ....
... {property1|filter} ...
... {property2|filter} ...
... </plugin>


همچنین امکان استفاده از چندین فیلتر روی یک ویژگی مشخص وجود دارد. مانند:

<plugin>property|filter1|filter2</plugin>

در جدول زیر فهرست فیلترهای مختلف ارائه گردیده است:

فیلتر عنوان نمونه خروجی
num عدد را از سمت راست سه رقم سه رقم با ویرگول جدا می‌کند 123,456,789
date تبدیل UNIX (تعداد ثانیه‌های شمارش شده از ابتدای 1970 پیش تاکنون) به تاریخ عادی 1403/12/06 12:20:36
fanum کلیه اعداد، فارسی نمایش داده شوند mohammad1234
ennum کلیه اعداد، انگلیسی نمایش داده شوند mohammad1234
q ویژگی/محتوای مشخص شده در بین "" نمایش داده شود. ممکن است از مقادیر json نیز استفاده گردد که در ادامه توضیح داده می‌شود "mohammad"

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

در بخش پلاگین‌ها، با پلاگین fanum مثال‌هایی آورده شده بود. فیلتر fanum نیز دقیقا همان کارایی را دارد اما طرز اعمال فیلتر و نوشتار متفاوت است مانند:

نام ثبت شده:<dbentry>name|fanum</dbentry>

در این مثال، فیلد name ثبت شده در پایگاه داده برای کاربر نمایش، و اعداد آن به صورت فارسی خواهند بود. اگر نام ثبت شده

mohmmad1234

بوده باشد به صورت زیر نمایش داده می‌شود:

نام ثبت شده: mohammad1234

کاربران

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

پایگاه‌های داده

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

 

شروط

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

سبد خرید

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

مدیران

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

مجموعه‌ها

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

 

در ستون عملیات می‌توانید مجموعه را به صورت سریع یا با جزئیات ویرایش نمایید.

مطالب

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

 

 

فایل‌ها

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

 

 

صهباتفایل‌ها

امکان بارگذاری انواع فایل در این بخش وجود دارد. می‌توانید فایل‌ها را در فرآیندهای مختلف فراخوانی کنید و در کانال، گروه و برای کاربران ارسال نمایید.

 

 

متغیرهای سراسری

اگر متغیری عمومی (شناسه کاربر) برای ربات خود مدنظر دارید، در بخش متغیرهای سراسری تعیین می‌کنید که مثلا متغیر id به هنگام فراخوانی همواره معادل مقدار خاصی باشد. و دیگر نیازی نیست برای هر فرآیند خود مقدار نوشته شود.

آمار

آمار مصرف منابع و امتیاز ربات به صورت نموداری در این بخش نمایش داده می‌شود.

پرداخت

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

 

 

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

 

 

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

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

Related Articles

درباره ما

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

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

تماس با ما

شماره تماس:
04133221753
02144896158

ربات ساز صهبات:
در بله، تلگرام و ایتا

گروه های پرسش و پاسخ:
در بله، تلگرام و ایتا

کانال آموزش و اطلاع رسانی:
در بله، تلگرام و ایتا