NAV Navbar
javascript
  • مقدمه
  • ساخت اولین ربات
  • سوالات متداول
  • ضمیمه ها
  • مقدمه

    به بخش مستندات سرویس ربـــات یـــار خوش آمدید.

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

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

    معرفی سرویس ربات یار

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

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

    ثبت نام در سایت

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

    ورود به پنل کاربری

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

    منوی پنل کاربری

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

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

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

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

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

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

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

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

    از طریق این بخش می‌توانید کلمه عبور خود را تغییر دهید.

    از طریق این بخش، می‌توانید وارد ربات تلگرامیِ «باشگاه مشتریان ربات یار» شوید، و از طریق این ربات، پاسخ به سوالات متداول کاربران را مشاهده کنید، ویدیوهای آموزشی ما را از طریق تلگرام تماشا کنید، و با واحد پشتیبانی آنلاین ربات یار در ارتباط باشید.

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

    ساخت اولین ربات

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

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

    راهنمای شروع

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

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

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

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

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

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

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

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

    صفحه ساخت ربات

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

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

    معرفی بلوک‌ ها

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

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

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

    بلوک‌ های اصلی

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

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

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

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

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

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

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

    برای اینکه بعدا بتوانید از داده‌ای که دریافت می‌شود استفاده کنید، و یا آن را ذخیره نمایید، حتما باید در قسمت نام متغیر، یک نام با حروف انگلیسی برای ربات انتخاب کنید؛ مثل name.

    دقت کنید که نام متغیر نسبت به استفاده از حروف کوچک یا بزرگ حساس است. همچین در انتخاب نیم شما نباید از فاصله استفاده کنید.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

    ۱- اگر مساوی با (برای داده‌های عددی و رشته‌ای)

    ۲- اگر مخالف با (برای داده‌های عددی و رشته‌ای)

    ۳- اگر کوچک‌تر از (فقط برای داده‌های عددی)

    ۴- اگر کوچک‌تر یا مساوی با (فقط برای داده‌های عددی)

    ۵- اگر بزرگ‌تر از (فقط برای داده‌های عددی)

    ۶- اگر بزرگ‌تر یا مساوی با (فقط برای داده‌های عددی)

    ۷- اگر شامل (برای داده‌های عددی و رشته‌ای)

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

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

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

    افزونه ها

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

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

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

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

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

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

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

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

    متصل کردن بلوک‌ها به یکدیگر

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

    میانبرها

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

    ctrl+1: اضافه کردن بلوک دریافت ورودی

    ctrl+2: اضافه کردن بلوک نمایش خروجی

    ctrl+3: اضافه کردن بلوک ذخیره اظلاعات

    ctrl+4: اضافه کردن بلوک نمایش کیبورد

    ctrl+5: اضافه کردن بلوک استفاده از وب سرویس

    ctrl+6: اضافه کردن بلوک کدنویسی

    ctrl+7: اضافه کردن بلوک تصمیم گیری

    ctrl+8: اضافه کردن بلوک پایان

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

    اتصال ربات به تلگرام

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

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

    ثبت ربات در بات فادر

    به صورت کلی برای اینکه یک ربات تلگرامی بسازید، باید از طریق بات فادر اسم (name) و نام کاربری (username) مورد نظر خود را برای آن ربات ثبت کنید، و یک توکن مختص به آن ربات را دریافت نمایید.

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

    ربات توسعه و ربات اصلی

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

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

    ربات توسعه

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

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

    محدودیت‌های ربات توسعه:

    مزیت‌های استفاده از ربات توسعه:

    ربات اصلی

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

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

    سوالات متداول

    سوال ۱- ربات من نمی‌تواند در هر ساعت با بیشتر از ۳ کاربر در ارتباط باشد، چطور باید این محدودیت را برطرف کنم؟

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

    سوال ۲- نمی‌توانم بلوک‌ها را به یکدیگر متصل کنم، باید چه کار کنم؟

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

    سوال ۳- لینک دانلود فیلم یا عکسی که در بلوک نمایش خروجی می‌گذارم، کار نمی‌کند. چرا؟

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

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

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

    سوال ۴- فرق بین ربات توسعه و ربات اصلی چیست؟

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

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

    توجه داشته باشید که ربات توسعه در هر ۲۴ ساعت تنها می‌تواند با ۳ کاربر در ارتباط باشد. همچنین امکان ارسال پیام تکی، گروهی و یا همگانی برای کاربران ربات توسعه وجود ندارد، و داده‌هایی که در ربات توسعه ذخیره می‌شوند قابل مشاهده نیستند.

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

    سوال ۵- آیا من می‌توانم با استفاده از سرویس ربات‌ یار، اسامی کاربرانِ ربات را ببینم و به آن‌ها پیام بدهم؟

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

    سوال ۶- در بلوک کدنویسی باید از چه زبان برنامه نویسی‌ای استفاده کنم؟

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

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

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

    نام: {{contact.first_name}}

    نام خانوادگی: {{contact.last_name}}

    شماره تماس: {{contact.phone_number}}

    سوال ۸- آیا ربات می‌تواند داده‌هایی را که از کاربر می‌گیرد، برای یک حساب تلگرام دیگر ارسال کند؟

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

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

    سوال ۹- بعد از تمام شدن یک هفته اشتراک رایگان، چطور می‌توانم به صورت رایگان سرویس ربات یار را امتحان کنم؟

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

    ضمیمه ها

    آموزش استفاده از Cron Jobs

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

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

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

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

    * * * * * (Minute. Hour. Day. Month. Weekday.)

    Minute: نخستین عدد از سمت چپ، بیانگر دقیقه‌ اجرای دستور است، و می‌تواند عددی بین ۰ تا ۵۹ باشد.

    Hour: دومین عدد از سمت چپ، بیانگر ساعت اجرای دستور است، و می‌تواند عددی بین ۰ تا ۲۳ باشد.

    Day: سومین عدد، بیانگر این است که دستور در چندمین روز از ماه میلادی اجرا شود، و می‌تواند عددی بین ۱ تا ۳۱ باشد.

    Month: چهارمین عدد از سمت چپ، نمایانگر ماه میلادی است. این عدد می‌تواند مقداری بین ۱ تا ۱۲ داشته باشد.

    Weekday: آخرین عدد از سمت چپ هم بیانگر روزِ هفته است. این عدد باید بین ۰ تا ۶ باشد، که ۰ نماینده یکشنبه، ۱ نماینده دوشنبه، و ... ۶ نماینده شنبه است.

    مثال: 7 22 5 3 1

    این دستور، در روز دوشنبه (۱) پنجم (۵) ماه مارس (۳) راس ساعت ده (۲۲) و هفت (۷) دقیقه شب اجرا می‌شود.

    نکته ۱: خیلی از مواقع در این رشته ۵ تایی، به جای عدد از * (ستاره) استفاده می‌شود. ستاره به معنی تمام اعداد ممکنی است که می‌تواند به جای آن عدد قرار بگیرد. استفاده ازاین نکته دست شما را تا حد زیادی باز می‌گذارد تا زمان مورد نظر خود را تعیین کنید.

    برای درک بهتر موضوع، به مثال‌های زیر توجه کنید:

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

    * * * * *

    مثال ۲: این دستور، هر روز راس ساعت های ۰۰:۰۴ ، ۰۱:۰۴ ، ۰۲:۰۴ ، ... ۲۱:۰۴ ، ۲۲:۰۴ و ۲۳:۰۴ اجرا می‌شود.

    4 * * * *

    مثال ۳: این دستور، هر روز راس ساعت ۱۰:۳۰ صبح اجرا می‌شود.

    30 10 * * *

    مثال ۵: این دستور، هر جمعه راس ساعت ۹:۴۵ شب اجرا می‌شود.

    45 21 * * 5

    مثال ۶: این دستور در اولین روز از هر ماه میلادی، راس نیمه شب اجرا می‌شود.

    0 0 1 * *

    نکته ۲: شما می‌توانید با استفاده از کاما (,) برای هر متغیر به جای یک عدد، از چند عدد مختلف استفاده کنید.

    مثال: این دستور در هر ساعت سه مرتبه، در دقیقه‌های ۵، ۱۰ و ۱۵ اجرا می‌شود.

    5,10,15 * * * *

    نکته ۳: در این متغیرها از عملگر تقسیم هم می‌توانید استفاده کنید.

    در مثال زیر، دستور در هر ساعت ۱۲ مرتبه استفاده می‌شود(60/5=12).

    */5 * * * *

    نکته ۴: می‌توان در دستورات Corn Job ‌از خط تیره برای مشخص کردن یک بازه استفاده کرد.

    در مثال زیر، دستور هر روز بین ساعت‌های ۵ تا ۱۰ صبح، راس هر ساعت اجرا می‌شود.

    0 5-10 * * *