خدمات مشتری
دکمههای ربات Telegram: کیبورد پاسخ، دکمههای اینلاین و گرفتن شماره تلفن یا موقعیت مکانی با یک لمس
ربات Telegram دو نوع دکمه دارد که کاملاً متفاوت کار میکنند. کیبورد پاسخ متن میفرستد و می‌تواند شماره تلفن یا موقعیت مکانی بخواهد؛ دکمههای اینلاین زیر یک پیام می‌نشینند و لینک باز میکنند یا کاری را اجرا میکنند. در این راهنما می‌بینید کدام را کی استفاده کنید و چطور در MonoChat تنظیمشان کنید.
تیم MonoChat به‌روزرسانی: 9 دقیقه مطالعه
در این صفحه
دکمه‌ها تعیین میکنند ربات Telegram شما شبیه یک فروشنده خوش‌برخورد باشد یا شبیه یک فرم طولانی. مشتری‌ای که می‌تواند «پیگیری سفارش» یا «ارسال شماره» را لمس کند، در یک ثانیه جواب می‌دهد؛ اما کسی که باید شماره سفارش، شماره تلفن با قالب درست یا نشانی کامل را تایپ کند، اغلب نیمه‌کاره رها میکند.
Telegram دو نوع دکمه بسیار متفاوت در اختیار ربات‌ها می‌گذارد و قاطی کردن این دو، رایج‌ترین دلیل کند و نامرتب شدن ربات است. این راهنما کیبورد پاسخ و دکمههای اینلاین را توضیح می‌دهد، نشان می‌دهد چطور با یک لمس شماره تلفن یا موقعیت مکانی بگیرید، و چطور همه این‌ها را در MonoChat بسازید. Telegram اعلام کرده بیش از ۱ میلیارد کاربر فعال دارد؛ برای بسیاری از کسب‌وکارهای فارسی‌زبان در دبی و استانبول که با مشتریان بین‌المللی کار میکنند، ربات اغلب اولین نقطه تماس مشتری است.
دو نوع دکمه در یک نگاه
| کیبورد پاسخ | کیبورد اینلاین | |
|---|---|---|
| کجا ظاهر میشود | به جای کیبورد مشتری، زیر کادر پیام | زیر یک پیام مشخص |
| با لمس چه میشود | متن دکمه مثل یک پیام تایپ‌شده در گفتگو فرستاده میشود | داده پنهان به ربات می‌رود یا لینک یا Mini App باز میشود؛ چیزی در گفتگو منتشر نمیشود |
| درخواست شماره یا موقعیت | بله (request_contact و request_location)، در گفتگوی خصوصی | خیر |
| بعد از لمس | می‌تواند پنهان شود (one_time_keyboard) | زیر پیام باقی می‌ماند |
| مناسب برای | پاسخ‌هایی که باید در گفتگو بمانند: منو، بله/خیر، اشتراک مخاطب یا موقعیت | کارهای مربوط به یک پیام: لینک، تأیید/لغو، انتخاب از یک کارت |
در Bot API اولی ReplyKeyboardMarkup با اشیای KeyboardButton و دومی InlineKeyboardMarkup با اشیای InlineKeyboardButton است. راهنمای ربات‌های Telegram تفاوت را ساده گفته است: برخلاف کیبورد پاسخ، فشردن دکمه اینلاین هیچ پیامی به گفتگو نمی‌فرستد.
کیبورد پاسخ: پاسخ‌هایی که انگار مشتری تایپ کرده
کیبورد پاسخ حروف کیبورد مشتری را با شبکه‌ای از دکمههای شما عوض میکند. وقتی مشتری «ساعت کاری» را لمس کند، همین عبارت از طرف او در گفتگو ظاهر میشود و ربات آن را مثل هر پیام دیگری می‌خواند. به همین دلیل برای منوها و پاسخهای کوتاه عالی است: تاریخچه گفتگو خوانا می‌ماند و همکاری که بعداً گفتگو را باز میکند دقیقاً می‌بیند مشتری چه انتخاب کرده است.
چند گزینه رفتار آن را تعیین میکند:
resize_keyboardارتفاع کیبورد را به اندازه دکمه‌ها کوچک میکند. بدون آن، حتی دو دکمه هم ارتفاع یک کیبورد کامل را می‌گیرند.one_time_keyboardکیبورد را بلافاصله بعد از استفاده پنهان میکند؛ با آیکونی در کادر نوشتن دوباره در دسترس است.input_field_placeholderراهنمایی ۱ تا ۶۴ کاراکتری در کادر پیام نشان می‌دهد، مثلاً «یک گزینه را انتخاب کنید».is_persistentدکمه‌ها را حتی وقتی کیبورد معمولی پنهان است نمایش می‌دهد.
چون لمس دکمه متن ساده میفرستد، نام دکمه همان کلید مسیردهی شماست. آن را کوتاه، یکتا و ثابت نگه دارید: اگر «پیگیری سفارش» را به «بسته‌ام کجاست؟» تغییر دادید، شرطی را که در جریان منتظر این متن است هم به‌روز کنید.
گرفتن شماره تلفن با «اشتراک‌گذاری مخاطب»
ربات Telegram هرگز خودبه‌خود شماره تلفن مشتری را نمی‌بیند. تنها راه این است که آن را بخواهید: یک دکمه کیبورد با request_contact برابر true. وقتی مشتری آن را لمس کند، Telegram شماره‌اش را به شکل مخاطب برای ربات میفرستد. Bot API تصریح میکند که این قابلیت فقط در گفتگوی خصوصی کار میکند.
این روش بسیار دقیق‌تر از «لطفاً شماره خود را وارد کنید» است: کد کشور جا نمی‌افتد، فاصله اضافه ندارد و شماره همان شماره‌ای است که حساب Telegram با آن ثبت شده. وقتی باید مشتری را به یک سفارش، رزرو یا رکورد CRM وصل کنید، این اولین قدم طبیعی است.
دو عادت مشتری را برای لمس دکمه راغب‌تر میکند:
- دلیل را بگویید. «شماره‌تان را به اشتراک بگذارید تا رزروتان را پیدا کنیم» خیلی بهتر از یک دکمه خالی جواب می‌دهد. شماره تلفن طبق قوانینی مثل PDPL امارات (فرمان قانون فدرال ۴۵/۲۰۲۱) یا KVKK ترکیه داده شخصی است و گفتن هدف، کار درستی است.
- راه دیگری هم بگذارید. بعضی‌ها شماره‌شان را به اشتراک نمی‌گذارند. کد رزرو یا ایمیل را هم بپذیرید یا گفتگو را به همکار انسانی بسپارید.
گرفتن موقعیت مکانی
request_location هم همین‌طور کار میکند: یک لمس، موقعیت فعلی مشتری را به صورت پیام موقعیت میفرستد. برای نشانی تحویل، نزدیک‌ترین شعبه، اعزام تکنسین یا بررسی اینکه نشانی در محدوده خدمات شما هست یا نه، مناسب است. این هم فقط در گفتگوی خصوصی کار میکند و تصمیم با مشتری است.
دکمههای اینلاین: کارهایی زیر یک پیام
دکمههای اینلاین متعلق به یک پیام‌اند و وقتی معنا دارند که انتخاب درباره همان پیام باشد: «تأیید» و «تغییر زمان» زیر خلاصه یک نوبت، «دیدن منو» زیر خوشامد یک رستوران، «پرداخت» زیر یک صورت‌حساب. سه نوع از همه پرکاربردترند:
- دکمههای callback تا ۶۴ بایت داده (
callback_data) برای ربات می‌فرستند. چیزی در گفتگو ظاهر نمیشود و قدم بعدی را ربات تعیین میکند. - دکمههای URL یک صفحه وب باز میکنند، مثل فهرست قیمت یا صفحه رهگیری مرسوله.
- دکمههای Web App یک Mini App را داخل Telegram باز میکنند، مثل فرم رزرو یا کاتالوگ.
یک جزئیات کوچک حس ربات را عوض میکند. بعد از لمس دکمه callback، Telegram تا وقتی ربات answerCallbackQuery را فراخوانی کند نشانگر پیشرفت نشان می‌دهد و از ربات‌ها می‌خواهد حتی اگر چیزی برای نمایش ندارند این کار را بکنند. رباتی که این مرحله را جا بیندازد دکمه را «در حال بارگذاری» رها میکند و مشتری بارها و بارها لمسش میکند.
نکته‌ای درباره حساب‌های Telegram Business. اگر رباتی را به یک حساب Telegram Business وصل کنید تا در گفتگوهای شخصی‌تان به جای شما پاسخ دهد، Telegram در پیام‌هایی که از طرف آن حساب فرستاده می‌شوند کیبورد پاسخ و دکمه Web App را پشتیبانی نمی‌کند. این‌ها در گفتگو با خود ربات کار میکنند؛ رباتی که مثل MonoChat با توکن BotFather وصل شده، دقیقاً در همین گفتگو با مشتری حرف می‌زند.
کدام را کی استفاده کنیم
| موقعیت | استفاده کنید از |
|---|---|
| منوی اصلی: «قیمت‌ها»، «ساعت کاری»، «گفتگو با همکار» | کیبورد پاسخ (پاسخ سریع) |
| بله/خیر، امتیازدهی، انتخاب زمان | کیبورد پاسخی که بعد از یک لمس پنهان شود |
| گرفتن شماره تلفن مشتری | دکمه اشتراک‌گذاری مخاطب |
| نشانی تحویل یا نزدیک‌ترین شعبه | دکمه ارسال موقعیت مکانی |
| تأیید یا لغو نوبتِ همین پیام | دکمههای اینلاین callback |
| باز کردن سایت، رهگیری یا صفحه پرداخت | دکمه اینلاین URL |
| فرم یا کاتالوگ داخل Telegram | دکمه اینلاین Web App |
قاعده ساده: اگر پاسخ باید در گفتگو دیده شود، کیبورد پاسخ. اگر دکمه روی یک پیام کار میکند یا به بیرون از Telegram می‌برد، دکمه اینلاین.
ساختن دکمههای Telegram در MonoChat
MonoChat ربات Telegram شما را با توکن BotFather وصل میکند (ببینید: ساخت ربات و گرفتن توکن). از نسخه 3.8.41 (۱ نوامبر ۲۰۲۶)، MonoChat پاسخهای سریع، درخواست‌های موقعیت مکانی و درخواست‌های اطلاعات تماس را به صورت دکمههای کیبورد پاسخ Telegram میفرستد، سرصفحه تصویر، ویدیو یا سند را در پیامهای دکمه‌دار نشان می‌دهد، به هر لمس پاسخ می‌دهد تا هیچ دکمهای در حال بارگذاری نماند، و می‌تواند نشانگر در حال نوشتن را نمایش دهد.
۱. پاسخهای سریع (کیبورد پاسخ). در یک جریان، گره ارسال پیام را اضافه کنید (یا یکی از پیامهای کوتاه را بسازید) و نوع متن را انتخاب کنید. متن را بنویسید، پاسخ سریع را روشن کنید و در بخش دکمه‌ها برای هر دکمه روی افزودن کلیک کنید. نوع را text بگذارید و نام دکمه را برای هر زبانی که پشتیبانی می‌کنید بنویسید. Telegram دکمه‌ها را زیر کادر پیام، دو تا در هر ردیف و در اندازه مناسب نشان می‌دهد. پیامهای تصویر، ویدیو و سند هم می‌توانند پاسخ سریع داشته باشند.
۲. شماره تلفن را بخواهید. نوع درخواست اطلاعات تماس را انتخاب کنید و پیام را بنویسید، مثلاً «برای پیدا کردن سفارشتان، لطفاً شماره تلفن خود را به اشتراک بگذارید.» Telegram دکمه اشتراک‌گذاری اطلاعات تماس را به زبان مشتری نشان می‌دهد. بعد از یک لمس پنهان میشود و شماره به صورت مخاطب در گفتگو می‌رسد. پاسخ سریع از نوع user-phone-number هم همین کار را داخل یک منو انجام می‌دهد.
۳. موقعیت مکانی را بخواهید. نوع درخواست موقعیت مکانی را انتخاب کنید. مشتری دکمه ارسال موقعیت مکانی را می‌بیند و موقعیتش به صورت پیام موقعیت می‌رسد.
۴. دکمههای اینلاین. نوع دکمه را انتخاب کنید. اگر بالای پیام تصویر، ویدیو یا سند می‌خواهید، نوع سرصفحه را انتخاب کنید، متن را بنویسید (تا ۱٬۰۲۴ کاراکتر) و دکمه‌ها را اضافه کنید: postback برای callback، web-url برای لینک و app-url برای Mini App. نام دکمه حداکثر ۲۰ کاراکتر است. لمس postback به صورت پاسخ دکمه در گفتگو می‌آید.
۵. بر اساس پاسخ مسیر بدهید. جریان ربات را با رویداد پیام جدید دریافت شد شروع کنید و ربات است؟ را روشن کنید. بعد از سؤال یک گره اگر بگذارید: برای پاسخهای سریع شرط متن پیام، و برای جدا کردن مخاطب یا موقعیت اشتراک‌گذاشته‌شده از متن تایپ‌شده شرط نوع پیام. مشتری‌ای که «گفتگو با همکار» را انتخاب میکند به گره تخصیص گفتگو می‌رود.
۶. نشان دهید در حال نوشتن هستید. در تنظیمات کانال فعال‌سازی نشانگر در حال نوشتن را روشن کنید. وقتی همکار در کادر پیام می‌نویسد و وقتی گره هوش مصنوعی در جریان پاسخ را آماده میکند، مشتری «در حال نوشتن…» می‌بیند؛ هنگام بارگذاری تصویر یا سند هم Telegram نشان می‌دهد که عکس یا فایلی در حال ارسال است.
هر گفتگو، هر لمس دکمه و هر مخاطب اشتراک‌گذاشته‌شده به همان صندوق ورودی تیم می‌رسد که گفتگوهای WhatsApp، Instagram و Messenger شما در آن است؛ پس همکاری که گفتگو را تحویل میگیرد می‌بیند مشتری چه چیزی را لمس کرده است.
نمونه: ربات هماهنگی یک کلینیک در دبی
مشتری: /start ربات: سلام، به کلینیک دندانپزشکی «آرامش» در دبی خوش آمدید. چطور می‌توانیم کمک کنیم؟ (دکمه‌ها: رزرو نوبت · ساعت کاری · گفتگو با هماهنگ‌کننده) مشتری: رزرو نوبت ربات: لطفاً شماره‌تان را به اشتراک بگذارید تا پرونده‌تان را پیدا کنیم. (دکمه: اشتراک‌گذاری اطلاعات تماس) مشتری: (مخاطب را به اشتراک می‌گذارد) ربات: متشکریم. اگر ترانسفر از هتل می‌خواهید، موقعیت خود را بفرستید. (دکمه: ارسال موقعیت مکانی) مشتری: (موقعیت را میفرستد) ربات: نوبت شما فردا ساعت ۱۱ صبح است. (دکمههای اینلاین: تأیید · تغییر زمان)
سه کیبورد پاسخ، جواب‌ها را در گفتگو ثبت میکنند و یک کیبورد اینلاین خلاصه را تأیید میکند. «گفتگو با هماهنگ‌کننده» مستقیم به یک انسان می‌رسد.
اشتباه‌هایی که باید از آن‌ها پرهیز کرد
- دکمههای زیاد. دو تا شش گزینه در هر کیبورد روی گوشی راحت خوانده میشود. منوهای طولانی را به Mini App یا مرحله بعد ببرید.
- خواستن شماره در اولین پیام. وقتی بخواهید که مشتری دلیلش را بداند.
- کیبوردی که هیچ‌وقت پنهان نمیشود. مشتری فکر میکند نمی‌تواند تایپ کند. برای سؤال‌های یک‌باره از کیبورد یک‌بارمصرف استفاده کنید.
- دکمههای بی‌جواب. هر لمس یک پاسخ لازم دارد، حتی «دریافت شد، لطفاً چند لحظه صبر کنید».
- نبودن راهی به انسان. گزینه «گفتگو با همکار» را همیشه نگه دارید. راهنمای Telegram برای کسب‌وکار ما انتقال گفتگو و ساعت کاری را توضیح می‌دهد.
اگر WhatsApp هم استفاده می‌کنید، همین ایده‌ها با محدودیت‌های دیگری صدق میکند: راهنمای پیامهای تعاملی WhatsApp را ببینید. برای افزودن پاسخهای هوش مصنوعی میان دکمه‌ها، ساخت ربات هوش مصنوعی Telegram را بخوانید.
رایگان در app.monochat.ai شروع کنید و ربات Telegram خود را در چند دقیقه وصل کنید.
منابع
- Telegram Bot API: ReplyKeyboardMarkup، KeyboardButton، InlineKeyboardButton، answerCallbackQuery، sendChatAction (Bot API 10.3) (بازدید در ۲ نوامبر ۲۰۲۶)
- Telegram: قابلیت‌های ربات، کیبوردها (بازدید در ۲ نوامبر ۲۰۲۶)
- پرسش‌های متداول Telegram: بیش از ۱ میلیارد کاربر فعال (بازدید در ۲ نوامبر ۲۰۲۶)
- مرکز راهنمای MonoChat: انواع پیام، پاسخهای سریع، درخواست‌ها و نشانگر در حال نوشتن در Telegram (بازدید در ۲ نوامبر ۲۰۲۶)
- تغییرات MonoChat نسخه 3.8.41 (بازدید در ۲ نوامبر ۲۰۲۶)
این را با MonoChat عملی کنید