جلسه ۶ : ساخت دکمه های شیشه ای در ربات تلگرام

۲۲ مهر ۱۳۹۷ساخت ربات تلگرام31

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

در حال بارگذاری ویدئو ...

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

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

دکمه های شیشه ای در ربات تلگرام

ساخت دکمه های شیشه ای در ربات تلگرام

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

<?php
$inline_keyboard = [
// 1
[
[ 'text' => "Open Google" , 'url' => "www.google.com" ] ,
[ 'text' => "Open Bing"   , 'url' => "www.bing.com" ]
] ,
// 2
[
[ 'text' => "I Agree" , 'callback_data' => "agree" ]
] ,
// 3
[
[ 'text' => "Send Link To Friends" , 'switch_inline_query' => "پیام آزمایشی ۱" ]
] ,
// 4
[
[ 'text' => "Copy Link in Input Area" , 'switch_inline_query_current_chat' => "پیام آزمایشی ۲" ]
] ,
];
$inline_kb_options = [
'inline_keyboard' => $inline_keyboard
];
?>

<?php

$inline_keyboard = [

// 1

[

[ 'text' => "Open Google" , 'url' => "www.google.com" ] ,

[ 'text' => "Open Bing" , 'url' => "www.bing.com" ]

] ,

// 2

[

[ 'text' => "I Agree" , 'callback_data' => "agree" ]

] ,

// 3

[

[ 'text' => "Send Link To Friends" , 'switch_inline_query' => "پیام آزمایشی ۱" ]

] ,

// 4

[

[ 'text' => "Copy Link in Input Area" , 'switch_inline_query_current_chat' => "پیام آزمایشی ۲" ]

] ,

];

$inline_kb_options = [

'inline_keyboard' => $inline_keyboard

];

در خطوط ۳ تا ۲۵ عناوین دکمه های شیشه ای، عملکرد و نحوه چیدمان آنها مشخص شده است. برای مثال براکت های قرار گرفته در خطوط ۵ و ۸ یک سطر از چیدمان دکمه های شیشه ای را مشخص می کنند (در قطعه کد فوق چهار سطر از دکمه های شیشه ای وجود دارد). درون این جفت براکت ها در هر خط (خطوط ۶ و ۷) یک دکمه شیشه ای تعریف شده است. پارامتر اول (text) عنوان نمایش داده شده بر روی دکمه شیشه ای و پارامتر دوم (url) نحوه عملکرد آن را مشخص می کند. در قطعه کد فوق دو دکمه جهت باز کردن دو سایت گوگل و بینگ تعریف شده است.

باز کردن آدرس وب توسط دکمه های شیشه ای

در خطوط ۱۲ ، ۱۷ و ۲۲ سه نوع دیگر از دکمه های شیشه ای تعریف شده است. نوع اول (خط ۱۲ – callback_data) مربوط به زمانی است که کاربر بر روی یک دکمه شیشه ای کلیک کرده و در پس پرده پیامی برای ربات ارسال می شود. ربات می بایست این پیام را پردازش کرده و واکنش مناسب را انجام دهد. نوع دوم (خط ۱۷ – switch_inline_query) و نوع سوم (خط ۲۲ – switch_inline_query_current_chat) کاربردهای خاصی دارند و در ربات های خاصی که قابلیت inline mode را دارند، استفاده می شوند. قابلیت inline mode در آینده آموزش داده خواهد شد. برای توضیحات بیشتر می توانید به ویدئوی ضمیمه آموزش مراجعه کنید.

خطوط ۲۷ تا ۲۹ نیز تنظیمات مربوط به دکمه های شیشه ای است که تنها یک گزینه دارد. این تنظیمات درون آرایه inline_kb_options$ ذخیره شده که در آینده برای نمایش دکمه های شیشه ای از آن استفاده خواهیم کرد.

نمایش دکمه های شیشه ای در ربات تلگرام

برای نمایش دکمه های شیشه ای از قطعه کدی مشابه جلسه قبل استفاده می کنیم (تابع ()show_menu و وابسته کردن آن به دستور start/).

تنها یک تغییر کوچک لازم است و آن هم قرار دادن متغیر inline_kb_options در مکان مورد نظر (خط ۱۲ در قطعه کد زیر). این همان آرایه ای است که در قطعه کد قبل جهت ذخیره تنظیمات مربوط به دکمه های شیشه ای تعریف شد.

<?php
switch($text) {
case "/start" : show_menu();  break;
}
//--------------------
function show_menu() {
$json_kb = json_encode($GLOBALS['inline_kb_options']);
$reply = "یکی از گزینه های زیر را انتخاب کنید";
$url = $GLOBALS['bot_url'] . "/sendMessage";
$post_params = [ 'chat_id' =>  $GLOBALS['chat_id'] , 'text' => $reply , 'reply_markup' => $json_kb ];
send_reply($url, $post_params);
}
?>

<?php

switch($text) {

case "/start" : show_menu(); break;

}

//--------------------

function show_menu() {

$json_kb = json_encode($GLOBALS['inline_kb_options']);

$reply = "یکی از گزینه های زیر را انتخاب کنید";

$url = $GLOBALS['bot_url'] . "/sendMessage";

$post_params = [ 'chat_id' => $GLOBALS['chat_id'] , 'text' => $reply , 'reply_markup' => $json_kb ];

send_reply($url, $post_params);

}

خروجی قطعه کد بالا بصورت زیر است :

نمایش دکمه های شیشه ای در ربات تلگرام

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

جهت واکنش به فشرده شدن دکمه های شیشه ای نوع دوم (callback_data) می بایست کدهای زیر را اضافه کنیم:

<?php
if( isset($update_array["callback_query"]) ) {
$data              = $update_array["callback_query"]["data"];
$callback_query_id = $update_array["callback_query"]["id"];
$chat_id           = $update_array["callback_query"]["message"]["chat"]["id"];
detect_callback_received_and_reply();
}
else if( isset($update_array["message"]) ) {
$text    = $update_array["message"]["text"];
$chat_id = $update_array["message"]["chat"]["id"];
}
?>

<?php

if( isset($update_array["callback_query"]) ) {

$data = $update_array["callback_query"]["data"];

$callback_query_id = $update_array["callback_query"]["id"];

$chat_id = $update_array["callback_query"]["message"]["chat"]["id"];

detect_callback_received_and_reply();

}

else if( isset($update_array["message"]) ) {

$text = $update_array["message"]["text"];

$chat_id = $update_array["message"]["chat"]["id"];

}

ابتدا می بایست تغییری در کدهای نوشته شده جهت پردازش اطلاعات دریافتی توسط ربات ایجاد کرد. تا پیش از این تنها منتظر ارسال پیام به ربات تلگرام بودیم ولی حالا غیر از پیام، ممکن است data هم برای ربات ارسال شود. ارسال data یعنی فشرده شدن یک دکمه شیشه ای. خطوط ۳ تا ۱۰ اطلاعات لازم پس از فشرده شدن یک دکمه شیشه ای را استخراج می کند.

جهت پردازش اطلاعات دریافتی توسط ربات و انجام واکنش مناسب به آن از تابع ()detect_callback_received_and_reply استفاده کرده ایم. این تابع در ادامه شرح داده شده است.

شرح کدهای تابع detect_callback_received_and_reply

<?php
function detect_callback_received_and_reply() {
$callback_data = $GLOBALS['data'];
if($callback_data == "agree") {
// ثبت نظر در دیتابیس
$reply = "با تشکر - نظر شما ثبت شد";
$url = $GLOBALS['bot_url'] . "/sendMessage";
$post_params = [ 'chat_id' =>  $GLOBALS['chat_id'] , 'text' => $reply ];
send_reply($url, $post_params);
//------------------------------
$reply = "با تشکر - نظر شما ثبت شد";
$url = $GLOBALS['bot_url'] . "/answerCallbackQuery";
$post_params = [ 
'callback_query_id' => $GLOBALS['callback_query_id'] , 
'text'              => $reply ,
'show_alert'        => true
];
send_reply($url, $post_params);
}
}
?>

<?php

function detect_callback_received_and_reply() {

$callback_data = $GLOBALS['data'];

if($callback_data == "agree") {

// ثبت نظر در دیتابیس

$reply = "با تشکر - نظر شما ثبت شد";

$url = $GLOBALS['bot_url'] . "/sendMessage";

$post_params = [ 'chat_id' => $GLOBALS['chat_id'] , 'text' => $reply ];

send_reply($url, $post_params);

//------------------------------

$reply = "با تشکر - نظر شما ثبت شد";

$url = $GLOBALS['bot_url'] . "/answerCallbackQuery";

$post_params = [

'callback_query_id' => $GLOBALS['callback_query_id'] ,

'text' => $reply ,

'show_alert' => true

];

send_reply($url, $post_params);

}

در خط ۷ ابتدا بررسی کرده ایم که داده دریافتی توسط ربات عبارت agree باشد. سناریوی ما به این صورت است که دکمه ای با عنوان «I Agree» به کاربر نمایش داده شده و کاربر با کلیک بر روی آن موافقت خود را با یک مسئله خاص اعلام می کند. در زمان کلیک بر روی این دکمه عبارت agree به ربات ارسال می شود (طبق کدهای نوشته شده).

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

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

نمایش پیام در پاسخ به فشردن دکمه شیشه ای

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

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

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

دانلود سورس کد آموزش

در قالب فایل ZIP

دانلود آموزش ویدئویی

با کیفیت HD

دوستان عزیز سوالات و نظرات خود را در مورد این جلسه آموزشی در بخش نظرات (دیدگاه ها) مطرح نمایید.

اشتراک گذاری این مطلب در شبکه های اجتماعی

عناوین جلسات

دوره آموزشی ساخت ربات تلگرام

آموزش ها

مشاهده لیست دوره های آموزشی

دیدگاه کاربران

31 دیدگاه. ارسال دیدگاه جدید

رضا کفشگر

۱۸ اسفند ۱۴۰۰ ۴:۲۴ ب.ظ

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

جلسه ۶ : ساخت دکمه های شیشه ای در ربات تلگرام

ساخت دکمه های شیشه ای در ربات تلگرام

نمایش دکمه های شیشه ای در ربات تلگرام

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

شرح کدهای تابع detect_callback_received_and_reply

دانلود سورس کد آموزش

دانلود آموزش ویدئویی

عناوین جلسات

آموزش ها

دیدگاه کاربران

31 دیدگاه. ارسال دیدگاه جدید

پاسخی بگذارید لغو پاسخ

پیشنهادات شگفت انگیز دیجی کالا

مهدی زعفری

برخی از پروژه های انجام شده

اپلیکیشن اندروید مدیریت چک های بانکی (مدیر چک)

اپلیکیشن شهر سنگ (اندروید + آی او اس)

اپلیکیشن اندروید مدیریت اقساط وام (مدیر وام)

ربات تلگرام اتوسرویس

اپلیکیشن اندروید پرسیس آرت (Persis Art)

اپلیکیشن اندروید کی وود (kiwood)

دوره های آموزشی

تماس با من

لینک شبکه های اجتماعی

جدیدترین آموزش ها