آشنایی با InputContactMessageContent در API ربات تلگرام
سلام! امروز می‌خواهیم در مورد یکی از مفاهیم جالب در API ربات تلگرام صحبت کنیم. نام این مفهوم InputContactMessageContent است. این قابلیت به ربات‌ها این امکان را می‌دهد که اطلاعات مربوط به یک تماس را ارسال کنند. به طور کلی، اگر شما یک ربات تلگرام دارید و می‌خواهید یک تماس را به کاربرانتان معرفی کنید، این قابلیت بسیار کاربردی خواهد بود.
تصور کنید شما یک ربات خدمات مشتری دارید و می‌خواهید شماره تماس خود را به کاربران نشان دهید. به جای اینکه کاربران شماره را به صورت متنی وارد کنند، می‌توانید از InputContactMessageContent استفاده کنید تا یک تماس به صورت مناسب و با تمام اطلاعات ضروری را ارسال کنید. این کار به کاربر احساس راحتی بیشتری می‌دهد و همچنین از اشتباهات جلوگیری می‌کند.
استفاده از این قابلیت نسبتاً آسان است. شما باید اطلاعات تماس مانند نام، شماره تلفن و ... را در یک ساختار خاص تنظیم کنید. سپس این اطلاعات را به ربات خود بفرستید تا در قالب یک پیام ارسال شود. به این ترتیب، هر زمان که کاربر روی دکمه تماس کلیک کند، مستقیماً می‌تواند با آن شماره تماس بگیرد. این قابلیت به ویژه برای ربات‌های تجاری و خدماتی بسیار مفید است.
در ادامه، نمونه کدی که چطور می‌توان از InputContactMessageContent استفاده کرد را بررسی خواهیم کرد. این کد شامل یک نمونه پیام است که اطلاعات تماس را به کاربر ارسال می‌کند. در کد زیر، تمام مراحل لازم برای ساخت و ارسال این پیام را مشاهده خواهید کرد.
نمونه کد
{
"chat_id": "@my_channel",
"reply_markup": {
"inline_keyboard": [[
{
"text": "تماس با ما",
"callback_data": "contact"
}
]]
},
"text": "ما را در تلگرام پیگیری کنید",
"reply_to_message_id": 123,
"content": {
"type": "contact",
"first_name": "Ali",
"last_name": "Mohammadi",
"phone_number": "09121234567"
}
}توضیحات کد
کد JSON بالا یک ساختار پیام برای ربات تلگرام است
این کد شامل اطلاعات تماس و دکمه‌ای برای برقراری تماس است.
"chat_id": "@my_channel";
این خط مشخص می‌کند که پیام به کدام کانال یا چت ارسال شود.
"reply_markup": { "inline_keyboard": ... }
در اینجا یک دکمه برای ارسال پیام تعریف شده است.
"text": "ما را در تلگرام پیگیری کنید";
متن پیام که به کاربر نمایش داده می‌شود.
"content": { "type": "contact", ... }
این بخش شامل جزئیات تماس است که می‌خواهیم ارسال کنیم.
"first_name": "Ali";
این خط نام افراد را نشان می‌دهد.
"phone_number": "09121234567";
و در نهایت شماره تلفن که کاربر می‌تواند با آن تماس بگیرد.