جلسه ۵ : ساخت منو در ربات تلگرام

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

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

در جلسه قبل ارسال انواع داده در ربات تلگرام را بررسی کردیم و دیدیم که چگونه می توان انواع داده زیر را در ربات تلگرام ارسال کرد:

ارسال پیام
ارسال عکس (تصویر)
ارسال فایل صوتی
ارسال فایل ویدئویی (کلیپ)
ارسال داکیومنت (فایل)
ارسال استیکر
ارسال موقعیت مکانی (نقشه)
ارسال اطلاعات تماس

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

ساخت منو در ربات تلگرام

ساخت منو در ربات تلگرام

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

<?php
$key1 = 'ارسال پیام';
$key2 = 'ارسال عکس';
$key3 = 'ارسال فایل صوتی';
$key4 = 'ارسال فایل ویدئویی';
$key5 = 'ارسال داکیومنت';
$key6 = 'ارسال استیکر';
$key7 = 'ارسال موقعیت مکانی';
$key8 = 'ارسال اطلاعات تماس';
$reply_keyboard = [
[$key1 , $key2] ,
[$key3 , $key4] ,
[$key5 , $key6] ,
[$key7 , $key8] ,
];
$reply_kb_options = [
'keyboard'          => $reply_keyboard ,
'resize_keyboard'   => true ,
'one_time_keyboard' => false ,
];
?>

<?php

$key1 = 'ارسال پیام';

$key2 = 'ارسال عکس';

$key3 = 'ارسال فایل صوتی';

$key4 = 'ارسال فایل ویدئویی';

$key5 = 'ارسال داکیومنت';

$key6 = 'ارسال استیکر';

$key7 = 'ارسال موقعیت مکانی';

$key8 = 'ارسال اطلاعات تماس';

$reply_keyboard = [

[$key1 , $key2] ,

[$key3 , $key4] ,

[$key5 , $key6] ,

[$key7 , $key8] ,

];

$reply_kb_options = [

'keyboard' => $reply_keyboard ,

'resize_keyboard' => true ,

'one_time_keyboard' => false ,

];

در خطوط ۳ تا ۱۰ دکمه های منو و عنوان آنها را مشخص کرده ایم. در خطوط ۱۲ تا ۱۷ نحوه چیدمان دکمه های منو مشخص شده است. دقیقا همین آرایشی که در کدهای فوق دیده می شود در مورد دکمه های منو برقرار است (چهار ردیف دکمه و در هر ردیف دو دکمه). برای توضیحات بیشتر می توانید به ویدئوی ضمیمه آموزش مراجعه کنید.

در خطوط ۱۹ تا ۲۳ تنظیمات مربوط به منو مشخص شده است. پارامتر اول نحوه چیدمان دکمه ها را مشخص می کند. پارامتر resize_keyboard باعث شکل و شمایل شکیل تر و کشیدگی دکمه های منو می شود. پارامتر one_time_keyboard نیز یکبار مصرف بودن/نبودن منو را مشخص می کند. چنانچه این پارامتر با مقدار false مقداردهی شود، منو بصورت ماندگار و همیشگی در مکان خود حضور خواهد داشت.

واکنش به فشرده شدن دکمه های منو

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

<?php
switch($text) {
case "/start" : show_menu();  break;
case $key1 : send_message();  break;
case $key2 : send_photo();    break;
case $key3 : send_audio();    break;
case $key4 : send_video();    break;
case $key5 : send_document(); break;
case $key6 : send_sticker();  break;
case $key7 : send_location(); break;
case $key8 : send_contact();  break;
}
?>

<?php

switch($text) {

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

case $key1 : send_message(); break;

case $key2 : send_photo(); break;

case $key3 : send_audio(); break;

case $key4 : send_video(); break;

case $key5 : send_document(); break;

case $key6 : send_sticker(); break;

case $key7 : send_location(); break;

case $key8 : send_contact(); break;

}

خط ۵ مربوط به نمایش منو به کاربر است. مناسب ترین زمان جهت نمایش منوی طراحی شده به کاربر، در زمان راه اندازی (start) ربات است. کدهای مربوط به نمایش منو در تابع ()show_menu (که در ادامه آموزش آورده شده) قرار گرفته است.

خطوط ۷ تا ۱۴ هر کدام مربوط به ارسال یکی از انواع داده در ربات تلگرام است (ارسال پیام، ارسال عکس، ارسال فایل صوتی و …). برای هر کدام از این حالت ها یک تابع نوشته شده است.

نمایش منو در ربات تلگرام

نمایش منو در ربات تلگرام توسط قطعه کد زیر انجام می شود (تابع ()show_menu) :

<?php
function show_menu() {
$json_kb = json_encode($GLOBALS['reply_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

function show_menu() {

$json_kb = json_encode($GLOBALS['reply_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);

}

قطعه کد بالا مشابه کد ارسال پیام در ربات تلگرام است. تنها دو تغییر جدید وجود دارد. اولین تغییر مربوط به خط ۵ است که تنظیمات مربوط به منوی طراحی شده (reply_kb_options$) بصورت json شده درون متغیر json_kb$ قرار گرفته است. دومین تغییر نیز در خط ۸ دیده می شود که باعث نمایش منوی طراحی شده در ربات می شود (پارامتر سوم ، reply_markup’ => $json_kb’).

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

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

نمایش منو در ربات تلگرام

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

جهت واکنش به فشرده شدن دکمه های منو، ۸ تابع در دستور switch دیدیم که در ادامه قطعه کد مربوط به پیاده سازی آنها را می بینیم:

<?php
// ارسال پیام
function send_message() {
$reply = "salam";
$url = $GLOBALS['bot_url'] . "/sendMessage";
$post_params = [ 'chat_id' =>  $GLOBALS['chat_id'] , 'text' => $reply ];
send_reply($url, $post_params);
}
//-------------------------------------
// ارسال عکس - تصویر
function send_photo() {
$url = $GLOBALS['bot_url'] . "/sendPhoto";
$post_params = [ 
'chat_id' => $GLOBALS['chat_id'] , 
'photo'   => new CURLFILE(realpath("image_file.png")) ,  
'caption' => "توضیحات عکس" ,  // optional
];
send_reply($url, $post_params);
}
//-------------------------------------
// ارسال فایل صوتی
function send_audio() {
$url = $GLOBALS['bot_url'] . "/sendAudio";
$post_params = [ 
'chat_id'   => $GLOBALS['chat_id'] , 
'audio'     => new CURLFILE(realpath("audio_file.mp3")) ,  
'caption'   => "توضیحات فایل صوتی" ,  // optional
'title'     => "عنوان آزمایشی" ,      // optional
'performer' => "test person" ,        // optional
];
send_reply($url, $post_params);
}
//-------------------------------------
// ارسال فایل ویدئویی
function send_video() {
$url = $GLOBALS['bot_url'] . "/sendVideo";
$post_params = [ 
'chat_id'   => $GLOBALS['chat_id'] , 
'video'     => new CURLFILE(realpath("video_file.mp4")) ,  
'caption'   => "توضیحات فایل ویدئویی" ,  // optional
];
send_reply($url, $post_params);
}
//-------------------------------------
// ارسال داکیومنت - فایل
function send_document() {
$url = $GLOBALS['bot_url'] . "/sendDocument";
$post_params = [ 
'chat_id'  => $GLOBALS['chat_id'] , 
'document' => new CURLFILE(realpath("document.pdf")) ,  
'caption'  => "توضیحات داکیومنت " ,  // optional
];
send_reply($url, $post_params);
}
//-------------------------------------
// ارسال استیکر
function send_sticker() {
$url = $GLOBALS['bot_url'] . "/sendSticker";
$post_params = [ 
'chat_id' => $GLOBALS['chat_id'] , 
'sticker' => new CURLFILE(realpath("sticker.webp")) ,  
];
send_reply($url, $post_params);
}
//-------------------------------------
// ارسال موقعیت مکانی - نقشه
function send_location() {
$url = $GLOBALS['bot_url'] . "/sendLocation";
$post_params = [ 
'chat_id'   => $GLOBALS['chat_id'] , 
'latitude'  => 32.657269 ,  
'longitude' => 51.677568 , 
];
send_reply($url, $post_params);
}
//-------------------------------------
// ارسال اطلاعات تماس
function send_contact() {
$url = $GLOBALS['bot_url'] . "/sendContact";
$post_params = [ 
'chat_id'      => $GLOBALS['chat_id'] , 
'phone_number' => "09131234567" ,  
'first_name'   => "mzsoftware.ir" , 
'last_name'    => "website" , // optional
];
send_reply($url, $post_params);
}
?>

100

101

102

103

104

105

106

107

108

109

110

111

112

<?php

// ارسال پیام

function send_message() {

$reply = "salam";

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

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

send_reply($url, $post_params);

}

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

// ارسال عکس - تصویر

function send_photo() {

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

$post_params = [

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

'photo' => new CURLFILE(realpath("image_file.png")) ,

'caption' => "توضیحات عکس" , // optional

];

send_reply($url, $post_params);

}

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

// ارسال فایل صوتی

function send_audio() {

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

$post_params = [

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

'audio' => new CURLFILE(realpath("audio_file.mp3")) ,

'caption' => "توضیحات فایل صوتی" , // optional

'title' => "عنوان آزمایشی" , // optional

'performer' => "test person" , // optional

];

send_reply($url, $post_params);

}

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

// ارسال فایل ویدئویی

function send_video() {

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

$post_params = [

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

'video' => new CURLFILE(realpath("video_file.mp4")) ,

'caption' => "توضیحات فایل ویدئویی" , // optional

];

send_reply($url, $post_params);

}

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

// ارسال داکیومنت - فایل

function send_document() {

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

$post_params = [

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

'document' => new CURLFILE(realpath("document.pdf")) ,

'caption' => "توضیحات داکیومنت " , // optional

];

send_reply($url, $post_params);

}

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

// ارسال استیکر

function send_sticker() {

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

$post_params = [

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

'sticker' => new CURLFILE(realpath("sticker.webp")) ,

];

send_reply($url, $post_params);

}

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

// ارسال موقعیت مکانی - نقشه

function send_location() {

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

$post_params = [

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

'latitude' => 32.657269 ,

'longitude' => 51.677568 ,

];

send_reply($url, $post_params);

}

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

// ارسال اطلاعات تماس

function send_contact() {

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

$post_params = [

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

'phone_number' => "09131234567" ,

'first_name' => "mzsoftware.ir" ,

'last_name' => "website" , // optional

];

send_reply($url, $post_params);

}

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

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

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

نمایش فایل ویدئویی در ربات تلگرام

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

نمایش موقعیت مکانی در ربات تلگرام

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

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

در قالب فایل ZIP

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

با کیفیت HD

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

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

عناوین جلسات

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

آموزش ها

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

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

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

مهدی

۲۴ بهمن ۱۴۰۰ ۱:۲۰ ق.ظ

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

جلسه ۵ : ساخت منو در ربات تلگرام

ساخت منو در ربات تلگرام

واکنش به فشرده شدن دکمه های منو

نمایش منو در ربات تلگرام

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

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

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

عناوین جلسات

آموزش ها

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

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

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

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

مهدی زعفری

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

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

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

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

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

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

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

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

تماس با من

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

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