ثبت نام و ورود

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

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

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

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

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

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

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

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

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

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

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

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

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

میز کار

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

ربات‌ها

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

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

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

اطلاعات ربات

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

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

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

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

فرآیندها

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

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

منوی ساده

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

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

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

انتقال پست

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

کد سفارشی

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

کرون جاب

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

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

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

پیشرفته

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

لیست و امکانات دقیق بلوک های فرآیند پیشرفته در انتهای مستندات اضافه شده اند.

برای مشاهده این قسمت، می توانید همین جا کلیک کنید.

مدیر گروه

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

مسیرساز

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

پلاگین‌ها

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

سلام <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 استفاده می شود. طبیعتا در حالتی که کاربر در چت شخصی به ربات پیام فرستاده است، اطلاعات گفتگو با اطلاعات فرستنده پیام، یکی است و پلاگین های peer و author یک خروجی را به شما خواهدداد.

در این پلاگین، این ویژگیها قابل استفاده هستند:

به عنوان مثال:

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

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

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

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

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

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

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

روز و ساعت: <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

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

<date><calendar>qamari</calendar>d M سال Y هجری قمری</date>

که به به عنوان مثال، این شکل دیده خواهدشد:

12 رمضان سال 1447 هجری قمری

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

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

ویژگی‌ها:

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

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

مشاهده اطلاعات ثبت شده در پایگاه داده (dbentry,dbentries)

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

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

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

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

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

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

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

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

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

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

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

همچنین در تگ dbentry می توانید به جای نام فیلدهای پرشده توسط کاربر (مثل name و phone در مثال ما) .ویژگی های سیستمی مربوط به رکورد را فراخوانی کنید. این ویژگی ها با علامت $ آغاز می شوند:

به عنوان مثال:

<dbentry><db>9876543</db>
{name} عزیز، شما در مدت زمان {$duration} به سؤالات ما پاسخ دادید.
کارشناسان ما با شما تماس خواهندگرفت.
کد رهگیری شما: {$id}
</dbentry>

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

محمد عزیز، شما در مدت زمان 2:17:54 به سؤالات ما پاسخ دادید.
کارشناسان ما با شما تماس خواهندگرفت.
کد رهگیری شما: 21436546573

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

به هنگام استفاده از پلاگین dbentries علاوه بر مقادیر اصلی رکوردها، مقادیر $count در تگ dbentries و $row در تگ dbentry قابل استفاده هستند. $count تعداد مجموع رکوردهای پیدا شده بر اساس query را نمایش می دهد و $row ردیف رکورد را به متن اضافه می کند.

مثلا برای نمایش نام 3 نفر از پایگاه داده customers می توانیم بنویسیم:

<dbentries><db>customers</db><limit>3</limit>
جمعا اطلاعات {$count} مشتری در سامانه ثبت شده است.
<entry>
{$row}. {name}
</entry>
</dbentries>

که خروجی آن به این صورت خواهدبود:

1. نام مشتری اول
2. نام مشتری دوم
3. نام مشتری سوم

متغیر سراسری

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

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

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

که خروجی آن به این صورت خواهدبود :

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

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

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

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

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

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

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

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

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

شروط (if,else)

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

قبل از استفاده از پلاگین if، شما باید شرط مد نظر خود را در منوی شروط ربات اضافه کنید. مثلا اگر می خواهیم در صورتی که کاربر عدد بزرگتر یا مساوی 10 ارسال کرد، متن مشخصی به پیام اضافه کنیم و در غیر این صورت، متن دیگری تنظیم کنیم، باید ابتدا این شرط را در منوی شروط اضافه کنیم:

حال می توانیم شناسه این شرط را در پلاگین استفاده کنیم:

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

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

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

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

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

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

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

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

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

نقل قول (quote)

برای این که بتوانید متن خاصی را به صورت دستی در یک JSON وارد کنید، نیاز دارید که کاراکترهای آن سازگاری لازم را پیدا کند و مثلا حاوی دابل کوتیشن (”) نباشد و یا اگر وجود داشت اصطلاحا escape شود و قبل از آن \ قرار بگیرد و … .

پلاگین quote این کار را برای شما انجام می دهد و با آسودگی خاطر می توانید مقادیر کوتیشن دار و فارسی و … را در داخل یک عبارت JSON اضافه کنید.

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

برای این کار داخل تگ quote، تگ jsonvalue را اضافه کنید و مقدار مورد نظر خود را در داخل این تگ وارد کنید. به عنوان مثال:

{"my_text":<quote><jsonvalue>متن "مهم" مورد نظر</jsonvalue></quote>}

فارسی سازی یا انگلیسی سازی اعداد (fanum,ennum)

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

عملیات ریاضی (math)

از این پلاگین می توانید برای انجام بعضی اعمال ریاضی (جمع، تفریق، ضرب، تقسیم، توان (با علامت ^) و بعضی عملیات های پیشرفته تر مثل abs برای قدر مطلق، log برای لگاریتم، sqrt برای مجذور، exp برای به توان رساندن عدد اویلر و توابع مثلثاتی sin، cos، tan و cot) استفاده کنید.

برای مدیریت اعداد اعشاری، توابع floor برای رند کردن عدد به عدد پایین، ceiling برای رند کردن عدد به بالا، round برای رند کردن عدد به نزدیکترین عدد غیراعشاری و truncate برای حذف بخش اعشاری عدد، قابل استفاده هستند.

همچنین تابع sign نیز قابل استفاده است که خروجی آن برای اعداد مثبت، 1، برای اعداد منفی، -1 و برای صفر، مقدار 0 است.

به عنوان مثال، برای نمایش 2 برابر سینوس عدد ارسالی کاربر:

<math>2*sin(<msg>text</msg>)</math>

یا برای نمایش نتیجه تقسیم عدد ارسالی کاربر به 27، بدون در نظر گرفتن بخش اعشاری:

<math>truncate(<msg>text</msg>/27)</math>

همچنین امکان استفاده از شرط نیز با استفاده از تابع if وجود دارد. برای تابع if(z,a,b) اگر شرط z محقق شود، مقدار a جاگذاری می شود و اگر محقق نشود، مقدار b جاگذاری می شود. به عنوان مثال نتیجه این متن، 20 خواهدشد:

<math>if((10>7 or 8<3) and 18/2=9, 15 ,10) + 5</math>

یک مثال در کنار استفاده از پلاگین dbentry در فرآیند فرم:

<math><dbentry>if(({score}>7 or 8<{age}) and {question02}/2=9, 15 ,10) + {question04}</dbentry></math>

فیلترها

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

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

<plugin>property|filter</plugin>

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

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

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

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

در هر فیلتر نیز امکان تعیین تنظیمات وجود دارد که بخش تنظیمات با :: از نام فیلتر جدا می شود و هر تنظیم نیز با ویرگول انگلیسی از بقیه جدا می شود. به عنوان مثال اگر می خواهیم تنظیماتی را برای filter1 اضافه کنیم:

<plugin>property|filter1::config1,config2,config3:value3,config4|filter2</plugin>

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

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

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

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

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

mohmmad1234

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

نام ثبت شده: mohammad1234

کاربران

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

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

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

شروط

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

سبد خرید

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

مدیران

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

مجموعه‌ها

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

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

مطالب

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

فایل‌ها

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

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

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

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

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

آمار

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

پرداخت

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

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

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

بلوک های فرآیند پیشرفته

قبل تر در بخش فرآیندهای ربات، با فرآیند پیشرفته آشنا شدیم.

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

همانطور که در تصویر می بینید، این بلوک ها دسته بندی شده اند و با انتخاب هر دسته، در سمت چپ، بلوک های مربوط به آن دسته نمایش داده می شوند:

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

در حال حاضر، این دسته بندی ها در بخش فرآیند پیشرفته وجود دارند:

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

دستورها و فرآیندها

این دسته شامل بلوک‌هایی برای کنترل جریان اجرای دستورها و فرآیندهای ربات است.

ورود با دریافت دستور

commands_start

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

انتقال به دستور

commands_gotocmd

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

تعیین دستور

commands_setcmd

دستور فعلی کاربر را بدون اجرا یا انتقال به دستور جدید، به یک دستور جدید تغییر می‌دهد.

اجرای دستور

commands_runcmd

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

انتقال به فرآیند

commands_gotoprocess

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

تعیین فرآیند

commands_setprocess

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

اجرای فرآیند

commands_runprocess

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

وضعیت تعیین‌شده در کلید

commands_statekeyset

مقدار یا داده‌ای که از طریق یک کلید شیشه‌ای (Callback Query) به ربات ارسال شده را برمی‌گرداند.

نگهداری وضعیت دستور

commands_statekeep

وضعیت فعلی دستور را برای دریافت پیام بعدی از کاربر حفظ می‌کند.

وضعیت فعلی دستور

commands_statecurr

وضعیت یا داده ذخیره‌شده در یک دستور را برمی‌گرداند.

حذف وضعیت دستور

commands_statedelete

وضعیت ذخیره‌شده برای دستور فعلی کاربر را حذف می‌کند.

کاربر از چه طریقی وارد شده است؟

commands_enteredwith

بررسی می‌کند که کاربر از چه طریقی وارد فرآیند شده است. برای آشنایی بیشتر با نحوه ورود کاربر به فرآیند می توانید فیلدهای مربوط به بلوک «ورود با دریافت دستور» را مشاهده کنید.

پیام‌ها

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

ارسال پیام

msgs_sendmsg

یک یا چند پیام را به یک یا چند گیرنده ارسال می‌کند. با کلیک روی آیکن ⚙️ به صفحه تنظیمات پیام (تعیین متن پیام، فایل، کلیدها و …) رفته و پیامهای دلخواهتان را بسازید.

ویرایش پیام

msgs_editmsg

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

بازارسال (فوروارد) پیام

msgs_forwardmsg

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

نام

عنوان

نوع

ورودی‌ها

MSG

شناسه پیام برای بازارسال

String, Message

PEERS

گیرندگان

Peers, Peer

خروجی

خروجی

ندارد (فقط به بلوک بعدی متصل می‌شود)

حذف پیام

msgs_deletemsg

یک یا چند پیام مشخص را بر اساس شناسه‌ی آن ها حذف می‌کند.

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

ارسال یکباررمز

msgs_sendotp

یک کد یکبار مصرف (OTP) را از طریق پل ارتباطی مشخص شده به شماره همراه مقصد ارسال می‌کند.

اطلاعات پیام

msgs_msgdata

یکی از ویژگی‌های پیام انتخاب شده (که اکثرا پیام دریافتی از کاربر ربات است) را استخراج می‌کند.

نوع پیام

msgs_msgtype

یکی از انواع پیام‌های ممکن را برمی‌گرداند.

پیام جاری

msgs_msgcurr

پیام فعلی که باعث اجرای این فرآیند شده است را برمی‌گرداند.

پیام با شناسه

msgs_msg

یک پیام را بر اساس شناسه کامل آن (شامل شناسه پل، شناسه کاربر و شناسه پیام) بازیابی می‌کند.

فرستنده پیام جاری

peers_sendercurr

کاربری که پیام فعلی را ارسال کرده است، برمی‌گرداند.

ذخیره و فراخوانی داده‌ها

بلوک‌های این دسته برای کار با پایگاه داده، APIهای خارجی و فایل‌های Excel استفاده می‌شوند.

شناسه آخرین رکورد پایان یافته بین همه کاربران در پایگاه داده

database_lastentryidfromall

شناسه آخرین رکوردی که ویرایش آن برای کاربر مشخصی به اتمام رسیده است را برمی‌گرداند.

شناسه آخرین رکورد پایان یافته در پایگاه داده

database_lastentryid

شناسه آخرین رکوردی که ویرایش آن برای کاربر مشخصی به اتمام رسیده است را برمی‌گرداند.

شناسه رکورد در حال ویرایش در پایگاه داده

database_editingentryid

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

اتمام ویرایش رکورد جاری در پایگاه داده

database_finishentry

وضعیت ویرایش یک رکورد را برای کاربر مشخصی به حالت “پایان‌یافته” تغییر می‌دهد.

حذف رکورد از پایگاه داده

database_removeentries

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

اطلاعات رکورد

database_entrydata

یکی از ویژگی‌های رکورد دریافت شده از پایگاه داده را استخراج می‌کند.

دریافت رکورد پایگاه داده

database_entry

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

دریافت رکوردهای پایگاه داده

database_entries

رکوردهایی را از یک جدول پایگاه داده بر اساس کوئری جستجو، فیلتر و مرتب‌سازی می‌کند.

تعداد رکوردهای پایگاه داده

database_entriescount

تعداد رکوردهای یک جدول را که با کوئری جستجو مطابقت دارند، برمی‌گرداند.

ذخیره یک فیلد در پایگاه داده

database_savefield

مقدار یک فیلد خاص را در یک رکورد مشخص، ذخیره یا به‌روزرسانی می‌کند.

ذخیره چند فیلد در پایگاه داده

database_savefields

مقادیر چندین فیلد را به صورت یکجا در یک رکورد مشخص ذخیره می‌کند.

ایجاد رکورد جدید در پایگاه داده

database_insertnewrow

یک رکورد جدید در جدول مشخص شده ایجاد کرده و شناسه آن را برمی‌گرداند.

اتصال به API

database_connectiontoapi

یک درخواست HTTP به یک API خارجی ارسال کرده و پاسخ را در فرمت مشخص شده برمی‌گرداند.

اتصال به API تحریم‌شده

database_connectiontoapi_nosanc

مشابه “اتصال به API” است، اما برای سرویس‌هایی که ممکن است تحریم شده باشند، از سرور واسط استفاده می‌کند.

جستجو در اکسل

database_excel

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

تعداد رکوردهای اکسل

database_excelcount

تعداد ردیف‌هایی را که با کوئری جستجو در یک فایل اکسل مطابقت دارند، برمی‌گرداند.

کاربران

بلوک‌های این دسته برای مدیریت اطلاعات کاربران، گروه‌های کاربری و پل‌های ارتباطی به کار می‌روند.

نوع پل ارتباطی

peers_bridgetype

یکی از انواع پل‌های ارتباطی موجود را برمی‌گرداند.

عنوان گروه کاربری

peers_usergrouptitle

عنوان فارسی یک گروه کاربری را بر اساس شناسه آن برمی‌گرداند.

کاربر (گفتگوی) جاری

peers_peercurr

کاربر یا گفتگوی فعلی (که فرآیند برای او اجرا می‌شود) را برمی‌گرداند.

کاربر (گفتگو) با شناسه

peers_peer

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

کاربران

peers_peers

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

گروه های کاربری

peers_peersbyusergroup

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

تعیین گروه کاربر

peers_setusergroup

یک کاربر را به یک گروه کاربری اضافه می‌کند.

حذف از گروه های کاربر

peers_unsetusergroup

یک کاربر را از یک گروه کاربری مشخص حذف می‌کند.

اطلاعات کاربر

peers_peerdata

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

نوع کاربر(گفتگو)/فرستنده

peers_peertype

یکی از انواع گفتگو (کاربر، ربات، گروه، کانال) را برمی‌گرداند.

جستجو بین کاربران ربات

peers_peerssearch

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

فایل‌ها

بلوک‌های این دسته برای مدیریت فایل‌ها در سیستم (File, SFile, RawFile) استفاده می‌شوند.

فایل جاری

files_filecurr

فایلی که در پیام فعلی ارسال شده است را برمی‌گرداند.

فایل با توکن

files_file

یک فایل موقت (که هنوز در سیستم صهبات ذخیره دائمی نشده) را بر اساس توکن آن بازیابی می‌کند.

صهبات‌فایل با توکن

files_sfile

یک فایل ذخیره‌شده در صهبات (SFile) را بر اساس توکن آن بازیابی می‌کند.

فایل خام با توکن

files_rawfile

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

اطلاعات فایل

files_filedata

یکی از ویژگی‌های یک فایل (File) را استخراج می‌کند.

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

files_sfiledata

یکی از ویژگی‌های یک صهبات‌فایل (SFile) را استخراج می‌کند.

اطلاعات فایل خام

files_rawfiledata

یکی از ویژگی‌های یک فایل خام (RawFile) را استخراج می‌کند.

نوع فایل

files_filetype

یکی از انواع فایل (تصویر، ویدیو، …) را برمی‌گرداند.

ذخیره فایل در صهبات

files_filesave

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

ویرایش فایل

files_fileedit

اطلاعات یک فایل موقت را ویرایش می‌کند.

ویرایش صهبات‌فایل

files_sfileedit

اطلاعات یک فایل ذخیره‌شده در صهبات را ویرایش می‌کند.

مطالب و مجموعه‌ها

این دسته برای کار با سیستم مدیریت محتوای داخلی (مطالب و مجموعه‌ها) طراحی شده است.

مطلب با شناسه

articles_article

یک مطلب خاص را بر اساس شناسه آن بازیابی می‌کند.

مجموعه با شناسه

articles_category

یک مجموعه خاص را بر اساس شناسه آن بازیابی می‌کند.

اطلاعات مطلب

articles_articledata

یکی از ویژگی‌های یک مطلب را استخراج می‌کند.

اطلاعات مجموعه

articles_categorydata

یکی از ویژگی‌های مربوط به مجموعه مورد نظر را استخراج می‌کند.

دریافت مطالب

articles_articles

لیستی از مطالب را بر اساس کوئری جستجو و فیلترهای دیگر بازیابی می‌کند.

دریافت مجموعه‌ها

articles_categories

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

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

articles_articlescount

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

نوع مطلب

articles_articletype

یکی از انواع مطلب را برمی‌گرداند.

وضعیت مطلب

articles_articlestatus

یکی از وضعیت‌های ممکن برای یک مطلب را برمی‌گرداند.

نوع مجموعه

articles_articlecategorytype

یکی از انواع مجموعه را برمی‌گرداند.

وضعیت مجموعه

articles_articlecategorystatus

یکی از وضعیت‌های ممکن برای یک مجموعه را برمی‌گرداند.

پرداخت و تراکنش‌ها

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

تراکنش با شناسه

payment_transaction

یک تراکنش مالی را بر اساس شناسه آن بازیابی می‌کند.

اطلاعات تراکنش

payment_transactiondata

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

ایجاد تراکنش

payment_transactionset

یک تراکنش جدید با مبلغ تعیین شده برای درگاه پرداخت مورد نظر شما ایجاد کرده و آن را برمی‌گرداند.

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

دریافت تراکنش‌ها

payment_transactions

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

نوع تراکنش

payment_transactiontype

یکی از انواع تراکنش‌های مالی را برمی‌گرداند.

وضعیت تراکنش

payment_transactionstate

یکی از وضعیت‌های ممکن برای یک تراکنش مالی را برمی‌گرداند.

ابزارها

این دسته شامل بلوک‌های کاربردی عمومی برای کار با تاریخ، اعداد، رشته‌ها و JSON است.

تولید کد تصادفی

tools_randomcode

یک کد تصادفی با طول و کاراکترهای مشخص تولید می‌کند.

زمان جاری

tools_datecurr

زمان و تاریخ فعلی سرور را برمی‌گرداند.

دریافت زمان

tools_dateget

یک رشته یا عدد (Unix Timestamp) را به یک شیء زمان تبدیل می‌کند.

فرمت زمان

tools_dateformat

یک شیء زمان را به رشته متنی با فرمت دلخواه تبدیل می‌کند.

زمان به UNIX

tools_datetounix

یک شیء زمان را به معادل Unix Timestamp (تعداد ثانیه‌های گذشته از مبدأ) تبدیل می‌کند.

تعداد فرزندان JSON

tools_jsonchildrencount

تعداد فرزندان (آیتم‌های آرایه یا کلیدهای شیء) یک شیء JSON را برمی‌گرداند.

تبدیل متن به عدد

tools_texttonumber

یک رشته متنی را به نوع عددی تبدیل می‌کند.

تبدیل عدد به متن

tools_numbertotext

یک عدد را به رشته متنی تبدیل می‌کند.

تبدیل JSON به متن

tools_jsontotext

یک شیء JSON را به نمایش رشته‌ای آن تبدیل می‌کند.

تبدیل به JSON

tools_anytojson

مقادیر مختلف را به یک JSON تبدیل می‌کند.

تبدیل به متن

tools_anytotext

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

JSON دریافت یک مقدار از

tools_jsonvalue

یک مقدار خاص را از داخل یک شیء JSON با استفاده از یک مسیر (Path) استخراج می‌کند.

JSON جستجو در

tools_jsonsearch

یک یا چند مقدار را از داخل یک شیء JSON با استفاده از کوئری JSONPath جستجو می‌کند.

اسکِیپ متن

tools_escapetext

کاراکترهای خاص در یک رشته را برای استفاده امن در فرمت‌های مختلف (مانند JSON, URL) اِسکِیپ می‌کند.

تصاویر

این دسته برای ایجاد، ویرایش و پردازش تصاویر به کار می‌رود.

وارد کردن تصویر از فایل

image_import

یک فایل (File, SFile, RawFile) را به یک شیء تصویر قابل پردازش تبدیل می‌کند.

ایجاد تصویر خالی

image_blank

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

ایجاد تصویر از متن

image_fromtext

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

ترکیب دو تصویر

image_composite

یک تصویر را روی تصویر دیگر در موقعیت مشخصی قرار می‌دهد.

خروجی گرفتن از تصویر

image_export

یک شیء تصویر را به یک فایل خام (RawFile) قابل ذخیره‌سازی یا ارسال تبدیل می‌کند.

تغییر مقیاس تصویر

image_scale

اندازه یک تصویر را به عرض و ارتفاع جدید تغییر می‌دهد.

برش تصویر

image_crop

قسمتی از یک تصویر را بر اساس موقعیت و ابعاد مشخص برش می‌دهد.

عملگرها

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

اگر … آنگاه …

controls_if

یک یا چند شرط را بررسی کرده و در صورت درست بودن، کد مربوطه را اجرا می‌کند.

مقایسه

logic_compare

دو مقدار را با یکدیگر مقایسه می‌کند و نتیجه را به صورت درست/نادرست برمی‌گرداند.

عملیات منطقی

logic_operation

دو شرط بولی را با عملگر ‘و’ یا ‘یا’ ترکیب می‌کند.

نقیض

logic_negate

نتیجه یک شرط بولی را معکوس می‌کند (درست را به نادرست و بالعکس).

بولی

logic_boolean

یک مقدار ثابت درست یا نادرست را برمی‌گرداند.

پوچ

logic_null

مقدار پوچ (null) را برمی‌گرداند که نشان‌دهنده نبودِ مقدار است.

عملیات سه‌تایی

logic_ternary

یک شرط را بررسی می‌کند؛ اگر درست باشد مقدار اول و در غیر این صورت مقدار دوم را برمی‌گرداند.

حلقه‌ها

این دسته شامل بلوک‌های استاندارد برای ایجاد حلقه‌های تکرار است.

تکرار کن

controls_repeat_ext

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

تا زمانی که / تا وقتی که

controls_whileUntil

دستورات داخل خود را تا زمانی که یک شرط برقرار باشد (while) یا تا وقتی که یک شرط برقرار شود (until)، تکرار می‌کند.

شمارش با

controls_for

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

برای هر مورد در لیست

controls_forEach

به ازای هر یک از موارد موجود در یک لیست، دستورات داخل خود را یک بار اجرا می‌کند.

خروج از حلقه

controls_flow_statements

جریان اجرای یک حلقه را کنترل می‌کند. می‌تواند از حلقه خارج شود (break) یا به تکرار بعدی برود (continue).

عملیات ریاضی

این دسته شامل بلوک‌های استاندارد برای انجام عملیات ریاضی است.

عدد

math_number

یک مقدار عددی ثابت را نمایش می‌دهد.

عملیات حسابی

math_arithmetic

یکی از عملیات اصلی ریاضی (جمع، تفریق، ضرب، تقسیم، توان) را روی دو عدد انجام می‌دهد.

توابع ریاضی (یک ورودی)

math_single

یک تابع ریاضی پیشرفته (مانند جذر، قدر مطلق، لگاریتم) را روی یک عدد اجرا می‌کند.

توابع مثلثاتی

math_trig

یکی از توابع مثلثاتی (سینوس، کسینوس، تانژانت و معکوس آن‌ها) را روی یک زاویه (بر حسب درجه) محاسبه می‌کند.

ثابت‌های ریاضی

math_constant

یکی از ثابت‌های معروف ریاضی را برمی‌گرداند.

ویژگی عدد

math_number_property

یک ویژگی خاص یک عدد را بررسی می‌کند (مانند زوج، فرد، اول، صحیح، مثبت، منفی، قابل تقسیم بر…).

گرد کردن

math_round

یک عدد اعشاری را به نزدیک‌ترین عدد صحیح گرد می‌کند.

عملیات روی لیست

math_on_list

یک عملیات آماری (مانند جمع، میانگین، میانه، انحراف معیار) را روی تمام اعداد یک لیست انجام می‌دهد.

باقیمانده

math_modulo

باقیمانده تقسیم عدد اول بر عدد دوم را محاسبه می‌کند.

محدود کردن عدد

math_constrain

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

عدد صحیح تصادفی

math_random_int

یک عدد صحیح تصادفی در یک محدوده مشخص (شامل ابتدا و انتها) تولید می‌کند.

عدد اعشاری تصادفی

math_random_float

یک عدد اعشاری تصادفی بین ۰.۰ (شامل) و ۱.۰ (شامل نمی‌شود) تولید می‌کند.

Atan2

math_atan2

آرک‌تانژانت نقطه (X, Y) را بر حسب درجه از ۱۸۰- تا ۱۸۰ محاسبه می‌کند.

متن (رشته ها)

این دسته شامل بلوک‌های استاندارد برای کار با رشته‌های متنی است.

متن

text

یک رشته متنی ثابت را ایجاد می‌کند.

متن چندخطی

text_multiline

یک رشته متنی ثابت چندخطی ایجاد می‌کند.

الحاق متن

text_join

چندین رشته متنی را به یکدیگر متصل می‌کند.

افزودن به متن

text_append

یک رشته متنی را به انتهای یک متغیر متنی اضافه می‌کند.

طول متن

text_length

تعداد کاراکترهای یک رشته متنی را برمی‌گرداند.

متن خالی است؟

text_isEmpty

بررسی می‌کند که آیا یک رشته متنی خالی است یا خیر.

یافتن در متن

text_indexOf

موقعیت (اندیس) اولین یا آخرین رخداد یک زیررشته را در یک متن پیدا می‌کند.

گرفتن حرف در متن

text_charAt

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

گرفتن زیررشته

text_getSubstring

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

تغییر حالت حروف

text_changeCase

تمام حروف یک رشته متنی را به حروف بزرگ، کوچک یا عنوان (ابتدای هر کلمه بزرگ) تبدیل می‌کند.

تغییر کاراکترهای عددی در متن

text_numberformat

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

حذف فاصله‌ها

text_trim

فاصله‌های خالی (space) را از ابتدا، انتها یا هر دو طرف یک رشته متنی حذف می‌کند.

شمارش

text_count

تعداد دفعاتی که یک زیررشته در یک متن تکرار شده است را می‌شمارد.

جایگزینی

text_replace

تمام رخدادهای یک زیررشته را با یک رشته دیگر در متن جایگزین می‌کند.

معکوس کردن

text_reverse

ترتیب کاراکترهای یک رشته متنی را معکوس می‌کند.

لیست ها

این دسته شامل بلوک‌های استاندارد برای ایجاد و کار با لیست‌ها (آرایه‌ها) است.

تبدیل به لیست عادی

lists_convert_from

لیست‌های با نوع خاص (مانند Peer[], Article[]) را به لیست‌های عمومی Blockly تبدیل می‌کند تا بتوان در حلقه‌ها و عملیات لیست استاندارد از آن‌ها استفاده کرد.

بررسی وجود یک آیتم در لیست

lists_contains

این بلوک بررسی می کند که آیا یک مورد (آیتم) در لیست مورد نظر وجود دارد یا خیر.

به عنوان مثال، می توانید برای بررسی عضویت یک کاربر در یک گروه کاربری در صهبات:

1. ابتدا با بلوک دریافت اطلاعات کاربر نام انگلیسی گروه‌های کاربری که کاربر در آن‌ها عضو است را استخراج کنید.
2. سپس با بلوک تبدیل به لیست عادی لیست گروه‌ها را به لیست عادی تبدیل کنید.
3. سپس با بلوک بررسی وجود یک آیتم در لیست ببینید گروه مورد نظر شما (مثلا registered) در بین آیتم‌های این لیست وجود دارد یا خیر.

ایجاد لیست با

lists_create_with

یک لیست جدید با موارد مشخص شده ایجاد می‌کند.

ایجاد لیست با تکرار

lists_repeat

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

طول لیست

lists_length

تعداد موارد موجود در یک لیست را برمی‌گرداند.

لیست خالی است؟

lists_isEmpty

بررسی می‌کند که آیا یک لیست هیچ موردی ندارد یا خیر.

یافتن در لیست

lists_indexOf

موقعیت (اندیس) اولین یا آخرین رخداد یک مورد را در یک لیست پیدا می‌کند.

گرفتن مورد از لیست

lists_getIndex

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

تنظیم مورد در لیست

lists_setIndex

مقدار یک مورد را در یک موقعیت مشخص از لیست تنظیم (جایگزین) یا درج می‌کند.

گرفتن زیرلیست

lists_getSublist

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

تبدیل متن به لیست و بالعکس

lists_split

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

مرتب‌سازی لیست

lists_sort

موارد یک لیست را بر اساس نوع (عددی، متنی) و جهت (صعودی، نزولی) مرتب می‌کند.

معکوس کردن لیست

lists_reverse

ترتیب موارد یک لیست را معکوس می‌کند.

رنگ‌ها

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

انتخابگر رنگ

colour_picker

یک رنگ را از یک پالت رنگی انتخاب می‌کند.

رنگ تصادفی

colour_random

یک رنگ تصادفی تولید می‌کند.

بدون رنگ

colour_transparent

یک مقدار شفاف (بدون رنگ) را برمی‌گرداند.

رنگ با RGB

colour_rgb

یک رنگ را بر اساس مقادیر قرمز (R)، سبز (G) و آبی (B) می‌سازد.

رنگ با RGBA

colour_rgba

یک رنگ را بر اساس مقادیر قرمز (R)، سبز (G)، آبی (B) و شفافیت (Alpha) می‌سازد.

ترکیب رنگ‌ها

colour_blend

دو رنگ را با یک نسبت مشخص با یکدیگر ترکیب می‌کند.

متغیرها

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

تنظیم متغیر

variables_set

مقدار یک متغیر را تنظیم یا به روز رسانی می‌کند.

خواندن متغیر

variables_get

مقدار فعلی ذخیره شده در یک متغیر را برمی‌گرداند.

متغیرها (با تعیین نوع)

این دسته مشابه دسته “متغیرها” است، اما به شما اجازه می‌دهد متغیرهایی با نوع داده مشخص (مانند Number, String, Peer) ایجاد کنید. این کار به جلوگیری از خطاها کمک کرده و سازگاری داده‌ها را تضمین می‌کند.

تنظیم متغیر (با نوع)

variables_set

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

خواندن متغیر (با نوع)

variables_get

مقدار فعلی یک متغیر با نوع مشخص را برمی‌گرداند.

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

این دسته برای تعریف و استفاده از متغیرهایی است که در تمام فرآیندها و برای تمام کاربران به صورت مشترک قابل دسترسی هستند.

تعیین [متغیر سراسری]

globalvars_setglobalvar

مقدار یک متغیر سراسری را تنظیم می‌کند.

مقدار متغیر سراسری

globalvars_getglobalvar

مقدار یک متغیر سراسری را بر اساس نام آن بازیابی می‌کند.

حذف متغیر سراسری

globalvars_deleteglobalvar

یک یا چند متغیر سراسری را بر اساس نام آن‌ها حذف می‌کند.

توابع

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

تعریف تابع (بدون خروجی)

procedures_defnoreturn

یک تابع جدید تعریف می‌کند که مجموعه‌ای از دستورات را اجرا می‌کند اما مقداری را برنمی‌گرداند.

تعریف تابع (با خروجی)

procedures_defreturn

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

فراخوانی تابع (بدون خروجی)

procedures_callnoreturn

یک تابع تعریف شده (که خروجی ندارد) را اجرا می‌کند.

فراخوانی تابع (با خروجی)

procedures_callreturn

یک تابع تعریف شده (که خروجی دارد) را اجرا کرده و مقدار بازگشتی آن را برمی‌گرداند.

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