رفتن به مطلب

Recommended Posts

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

دستور های معمولی :

{
	"keyboard": [
		[
			"1"
		],
		[
			"1",
			"2"
		]
	]
}

در نمونه بالا یک نمونه از دستور های کیبورد معمولی که در زیر گوشی قرار میگیرند رو مشاهده میکنید .
خوب با نمونه بالا شما میتونید یک کیبود که از دو ردیف تشکیل شده استفاده کنید . همینجور که میبینید در این کیبورد عدد ۱ در خط اول هستش و عدد ۱ و ۲ دوم در خط دوم قرار میگیرند شما میتونید به جای اعداد دستور مورد نظر رو قرار بدین .
در مورد دستور ها :
شما در منو دستور ها و کمه ها در پنل ربات یک دستور اصلی دارین به نام /start این دستور در اصل منو اصلی شما و شما میتونید اون رو ویرایش و تغییر بدین که در ادامه این آموزش تو ضیحاتی در مورد این کار خواهم داد . ولی فعلا در همین حد اطلاع داشته باشید که دستور /start دستور منو اصلی شماست و برای ایجاد منو اصلی که کاربر ها ازش استفاده می کنند باید این منو رو تغییر بدین .
چگونه یک دستور را حذف کنیم ؟
خوب برای اینکه در یک کیبورد یک دستور رو حذف کنیم ابتدا منو اصلی ربات رو قرار میدم ٫ شما وقتی ربات رو نصب میکنید به صورت پیشفرض این منو در ربات و در دستور /start و در بخش کیبورد وجود داره .

{
	"keyboard": [
		[
			"کوتاه کننده لینک",
			"ساخت تصویر"
		],
		[
			"محصولات",
			"تست محدودیت",
			"ثبت آدرس"
		],
		[
			"واریز مبلغ دلخواه"
		],
		[
			"اخبار ورزشی",
			"اخبار سیاسی",
			"اخبار تاپ امروز"
		],
		[
			"ارسال پیام",
			"نظر سنجی",
			"فال حافظ"
		],
		[
			"قیمت سکه",
			"امروز ؟",
			"قیمت ارز"
		]
	],
	"resize_keyboard": true
}

خوب همونجور که مشاهده میکنید ممکنه چنین منویی در بخش /start شما موجود باشه حالا چطور منو هایی که نیاز ندارین دو حذف کنید ؟
ببینید در مرود خط ها و تعداد دکمه در هر خط قبلا توضیح دادم برای مثلا برای حذف یک خط کامل به  صورت زیر عمل کنید  :

{
	"keyboard": [
		[
			"محصولات",
			"تست محدودیت",
			"ثبت آدرس"
		],
		[
			"واریز مبلغ دلخواه"
		],
		[
			"اخبار ورزشی",
			"اخبار سیاسی",
			"اخبار تاپ امروز"
		],
		[
			"ارسال پیام",
			"نظر سنجی",
			"فال حافظ"
		],
		[
			"قیمت سکه",
			"امروز ؟",
			"قیمت ارز"
		]
	],
	"resize_keyboard": true
}

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

{
	"keyboard": [
		[
			"کوتاه کننده لینک",
			"ساخت تصویر"
		],
		[
			"محصولات",
			"ثبت آدرس"
		],
		[
			"واریز مبلغ دلخواه"
		],
		[
			"اخبار ورزشی",
			"اخبار سیاسی",
			"اخبار تاپ امروز"
		],
		[
			"ارسال پیام",
			"نظر سنجی",
			"فال حافظ"
		],
		[
			"قیمت سکه",
			"امروز ؟",
			"قیمت ارز"
		]
	],
	"resize_keyboard": true
}

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

{
	"keyboard": [
		[
			"دستور نمونه"
		],
		[
			"آخرین اخبار سایت",
			"نظر سنجی"
		]
	]
}

در نمونه بالا سه دکمه یکی در خط اول و دوتا در خط دوم داریم . حالا من در مثال بعدی یک دکمه به خط اول اضافه میکنم :

{
	"keyboard": [
		[
			"دستور نمونه",
			"دکمه دوم در همین خط"
		],
		[
			"آخرین اخبار سایت",
			"نظر سنجی"
		]
	]
}

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

در مثال بعدی یک خط جدید در کد قرار میدم :

{
	"keyboard": [
		[
			"دستور نمونه"
		],
		[
			"نمونه در خط حدید"
		],
		[
			"آخرین اخبار سایت",
			"نظر سنجی"
		]
	]
}

به مثال بالا توجه کنید نمونه در خط جدید یک دکمه هست که در یک خط جدید ایجاد شده به همین صورت میتونید خط های دیگه قرار بدین و یا در هر خط طبق توضیحات بالا چند دکمه قرار بدین و باز هم تاکید میکنم به کاما ها دقت کنید :D

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

نقل قول
	"resize_keyboard": true

مثالی در این مورد :

{
	"keyboard": [
		[
			"دستور نمونه"
		],
		[
			"آخرین اخبار سایت",
			"نظر سنجی"
		]
	],
	"resize_keyboard": true
}

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

نقل قول
"one_time_keyboard": true

فرمت استفاده هم دقیقا مثل مثال بالا هستش و همچنین میتونید هر دو این دستور ها رو درکنار هم استفاده کنید برای مثال به صورت زیر :

{
	"keyboard": [
		[
			"دکمه"
		]
	],
	"one_time_keyboard": true,
	"resize_keyboard": true
}

خوب تا اینجا کامل با ویرایش بخش کیبورد های معمولی آشنا شدین حالا یه توضیح کوتاه در مورد این موضوع میدم که وقتی یک دکمه ایجاد کردین به چه صورت اون رو به یک دستور متصل کنید !

شما وقتی یک دکمه جدید ایجاد میکنید با زدن اون دکمه متن اون دکمه برای ربات ارسال میشه پس باید دقیقا هم نام اون دکمه یک دستور ایجاد کنید .
در ربات ساز گیسو انواع متفاوتی از دستور ها وجود داره مثل دستور اجرای نظر سنجی یا دستور ارسال یک پیام جدید و ....
در مورد دستور های ویژه مثل نظر سنجی و ... بعدا در آموز هاش بعدی بیشتر توضیح میدم ولی در مورد دستور هایی که بعد از زدنش یک متن ارسال بشه و یا یه زیر منو دیگه ارسال بشه همینجا توضیح کامل تری میدم خدمتتون .
بعد از این که دکمه ای با نام مثلا X در کیبوردتون ایجاد کردین از بخش دستور ها و دکمه ها روی افزودن دستور در بالای صفحه کلیک میکنید و فرم رو بر اساس نیازتون پر میکنید اول از همه در بخش دستور دقیقا نامی رو که روی دکمه قرار دادین رو وارد میکنید در این مثال من دکمه X رو ایجاد کرده بودم پس اینجا هم دستور رو باید X وارد کنم و بعد  در بخش متن متنی که میخواید با زدن دستور به کاربر نمایش داده بشه رو وارد میکنید و در صورتی که میخواین با زدن این دکمه منو جدیدی نمایش داده بشه همون جور که بالا توضیح دادم در بخش کیبورد کد کیبورد مورد نظر رو هم وارد میکنید و بعد حتما به این نکته توجه کنید ! نوع دستور رو روی کاربران قرار میدین در صورتی که این کارو نکنید دستور کار نمیکنه .
به همین صورت با زدن دکمه X دستوراتی که برای X وارد کرده بودین برای کاربر ارسال میشه .
یه نکته خیلی مهمه ممکنه بخواین بعد از زدن دکمه X چند پاسخ عکس یا ویدیو برای کاربر پشت سر هم ارسال بشه برای چنین کاری کافیه چند دستور ایجاد کنید و در بخش دستور همون نام X رو وارد کنید و ادامه فرم رو مثل قبل پر کنید .
به این صورت با زدن دکمه X چند دستور ی که پشت سر هم ایجاد کردین به صورت همزمان و پشت هم برای کاربر ارسال میشه ازاین امکان میتونید برای گالری تصویر و یا ویدیو استفاده کنید و یا به صورت همزمات تصویری ارسال کنید و بعدش توضیحات تصویر رو هم در ادامه ارسال کنید .

خوب تا الان اطلاعات کاملی در مورد دستور ها و دکمه ها دارین و میتونید کار خودتون رو شروع کنید ولی در ادامه به دو دکمه که شاید جایی به کارتون بیاد اشاره میکنم :
دکمه ارسال شماره تلفن :
مثال :

{
	"keyboard": [
		[
			{
				"text": "? ثبت شماره تلفن ?",
				"request_contact": true
			}
		]
	],
	"one_time_keyboard": true,
	"resize_keyboard": true
}

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

دکمه ارسال لوکیشن :
مثال :

{
	"keyboard": [
		[
			{
				"text": "ثبت لوکیشن",
				"request_location": true
			}
		]
	],
	"one_time_keyboard": true,
	"resize_keyboard": true
}

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

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

خوب تا حالا با کیبور های معمولی کاملا آشنا شدیم پس در ادامه شمارو با کیبورد های شیشه ای آشنا میکنم :

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

{
	"inline_keyboard": [
		[
			{
				"text": "نام نمایشی دکمه",
				"callback_data": "دستور مورد نظر"
			}
		]
	]
}

به همین صورت که در دستور بالا میبیند هر دکمه شیشه ای از دو بخش تشکیل شده text و callback_data که این امکان خیلی خوبی رو به شما میده که نام دکمه با دستوری که انجام میده متفاوت باشه و کاربر این مساله رو متوجه نشه !
برای مثال شما میتونید داخل بخش تکس مثلا وارد کنید در نظر سنجی شرکت کنید ! و در بخش کالبک دستور نظر سنجی رو وارد کنید به این صورت با اینکه نام دستور نظر سنجی مثلا X هست ولی شما میتونید در بخش تکس هر نامی که میخواید وارد کنید و با کالبک بگین که ربات دستور X رو اجرا کنه .
این امکان در خیلی جاهای دیگه هم ممکنه به درد شما بخوره پس خلاق باشید و ازش خیلی جاها استفاده کنید .

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

{
	"inline_keyboard": [
		[
			{
				"text": "گوگل",
				"url": "http://google.com"
			}
		]
	]
}

مثال بالا کاربر فقط دکمه ای با نام گوگل میبینه که بازدن دکمه وارد آدرسی که در بخش  url وارد کردین میشه در این نوع حتما دقت کنید که در ابتدای آدرس سایت حتما باید http:// یا https:// وارد کرده باشید در غیر این صورت دکمه کار نمیکنه .

خوب حالا در یک مثال من چند دکمه شیشه ای رو در کنار هم و زیر هم قرار میدم تا با چنینش این دکمه ها هم آشنا بشید :

{
	"inline_keyboard": [
		[
			{
				"text": "گوگل",
				"url": "http://google.com"
			},
			{
				"text": "X",
				"callback_data": "x"
			}
		],
		[
			{
				"text": "y",
				"callback_data": "y"
			}
		]
	]
}

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

خوب فکر میکنم در مورد همه چیز بخش ساخت کیبورد ها و دستور ها صحبت کردم و فقط موند دستور های سریع :
در گیسو ما یک سری دستور سریع ایجاد کردیم که لازم نباشه خیلی خودتون رو درگیر ساخت دکمه ها کنید به این دستور ها در زیر اشاره میکنم :
"بازگشت" : دستور بازگشت رو شما میتویند در هر کیبوردی استفاده کنید که کاربر در صورت زدن این دکمه به منو اصلی ربات برمیگرده .
"امروز ؟" :  دستور امروز ؟ اطلاعات در مورد تاریخ امروز و وقایع امروز به کاربر میده .
"سبد خرید" : این دستور سبد خرید کاربر رو بهش نشون میده .

دستور های دیگه ای هم هستند که به مرور در آموزش های بعدی به صورت اختصاصی در مورد اونها توضیح میدم .

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

موفق باشید و کمی خلاق .

به اشتراک گذاری این ارسال


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

×   شما در حال چسباندن محتوایی با قالب بندی هستید.   حذف قالب بندی

  حداکثر استفاده از ۷۵ شکلک مجاز می باشد.

×   لینک شما به صورت اتوماتیک جای گذاری شد.   نمایش به عنوان یک لینک به جای

×   محتوای قبلی شما بازگردانی شد.   پاک کردن محتوای ویرایشگر

×   You cannot paste images directly. Upload or insert images from URL.


×