إنشاء بوت تيليجرام خطوة بخطوة: من BotFather إلى الرد الآلي

إنشاء بوت تيليجرام يأخذ دقيقتين: افتح حساب @BotFather في تيليجرام، وأرسل له /newbot، ثم اكتب اسماً ظاهراً واسم مستخدم لاتينياً ينتهي بكلمة bot، فيعطيك رمزاً سرياً (token) هو مفتاح بوتك، أما أن يرد البوت على الناس فيحتاج خطوة ثانية: خدمة جاهزة تربطه بلا برمجة، أو ملف صغير على استضافتك يستقبل الرسائل ويرد عليها.

أغلب الشروح تقف عند الخطوة الأولى، فيبقى البوت حساباً صامتاً لا يفعل شيئاً، وفي هذا المقال ستكمل الطريق كاملاً من التوثيق الرسمي لتيليجرام: إعداد البوت ووصفه وأوامره، والرد الآلي بلا كود ثم بكود قصير، والفرق بين webhook وgetUpdates، وكيف تحمي الرمز، ومعك مختبر يكتب لك قائمة الأوامر جاهزة للصق في BotFather ويفحص اسم المستخدم قبل أن تحجزه.

لماذا يحتاج صاحب الموقع بوت تيليجرام؟

البوت في تيليجرام حساب آلي يتحكم به برنامجك عبر واجهة رسمية اسمها Bot API، ولا يحتاج رقم جوال، وصفحة مزايا البوتات في توثيق تيليجرام تعرض ما يستطيعه من أوامر وأزرار ولوحات مفاتيح وتطبيقات مصغرة، وهذه أكثر الاستعمالات نفعاً لصاحب موقع عربي.

• النشر في قناتك: كل مقال جديد يخرج إلى القناة وحده، والبوت مشرف فيها بصلاحية النشر
• تنبيهات لك أنت: رسالة خاصة عند طلب جديد أو نموذج تواصل أو تعليق ينتظر المراجعة
• رد على الأسئلة المتكررة: أوامر مثل /help و/contact ترد بنص ثابت في كل وقت
• اشتراك المهتمين: رابط بصيغة t.me/اسم_البوت?start=jobs يفتح البوت ويخبره من أين جاء الزائر

وفي مدونات الوظائف التي أبنيها يؤدي البوت الدور الأول تحديداً، فهو الذي ينشر الوظيفة في القناة لحظة نشرها في الموقع، وقد شرحت بناء هذه المواقع في إنشاء موقع وظائف سعودي على ووردبريس.

إنشاء بوت تيليجرام من BotFather خطوة بخطوة

BotFather هو البوت الرسمي الذي ينشئ البوتات ويديرها، وكل ما يلي من دليل BotFather الرسمي، وتأكد من كتابة الاسم @BotFather بحروفه تماماً، فبعض الحسابات تقلّد اسمه.

1- أنشئ البوت واحجز اسمه

أرسل /newbot، فيطلب منك اسماً ظاهراً تستطيع تغييره لاحقاً بالأمر /setname، ثم اسم مستخدم بين 5 و32 حرفاً من الحروف اللاتينية والأرقام والشرطة السفلية، ينتهي بـbot مثل madina_jobs_bot أو MadinaJobsBot، ولا يفرق بين الحروف الكبيرة والصغيرة، والأهم أنه لا يُغيَّر بعد إنشائه، فاختره كما تختار اسم نطاق.

خطأ شائع: حجز اسم عشوائي مثل test123_bot للتجربة ثم اعتماده لموقع حقيقي، فيبقى معك للأبد في روابطك ومشاركاتك، والأفضل أن تنشئ بوتاً للتجربة وآخر باسم موقعك للإنتاج، وهذا ما ينصح به التوثيق أيضاً حين يقترح بوتاً منفصلاً لاختبار الكود دون إزعاج المستخدمين.

2- احفظ الرمز في مكان آمن

يعطيك BotFather رمزاً بصيغة أرقام ثم نقطتين ثم حروف، والتوثيق صريح في أن من يملكه يتحكم ببوتك كاملاً، فاحفظه في مدير كلمات مرور، ولا تلصقه في مجموعة أو لقطة شاشة.

3- اكتب الوصف والنبذة والصورة

• /setdescription: الوصف حتى 512 حرفاً، ويراه المستخدم في أول محادثة تحت عنوان «ماذا يستطيع هذا البوت؟»
• /setabouttext: نبذة حتى 120 حرفاً تظهر في صفحة البوت وترافق رابطه حين يُشارك
• /setuserpic: صورة البوت، واجعلها شعار موقعك ليعرفه الناس في قائمة المحادثات

4- أضف الأوامر

بالأمر /setcommands تعطي البوت قائمة الأوامر التي تظهر للمستخدم حين يكتب / أو يضغط زر القائمة بجانب خانة الكتابة، وBotFather يطلبها سطراً لكل أمر بصيغة «الأمر – الوصف»، وهذه الصيغة يولّدها لك المختبر أدناه.

من أدوات أيمن · صدىبوتك ينشر مقالاتك في قناتك وحدهصدى يستعمل بوتك لإرسال كل مقال إلى قنوات تيليجرام بصورته وزر رابطه، ويرسل لواتساب أيضاًتعرّف على صدى

أوامر البوت: القواعد التي يرفض بها تيليجرام قائمتك

الأوامر أسهل طريق ليفهم الزائر ما يقدمه بوتك، وتوثيق BotCommand يضع لها حدوداً دقيقة: نص الأمر من 1 إلى 32 حرفاً، من الحروف الإنجليزية الصغيرة والأرقام والشرطة السفلية فقط، ووصفه من 1 إلى 256 حرفاً، والدالة setMyCommands تقبل 100 أمر على الأكثر.

الأمر	دوره بحسب توصية تيليجرام	مثال لموقع وظائف
/start	يبدأ التفاعل برسالة تعريف، ويستقبل معاملات الروابط العميقة	ترحيب ورابط القناة
/help	نص قصير عما يفعله البوت وقائمة أوامره	كيف تبحث وكيف تشترك
/settings	إعدادات المستخدم إن وُجدت	اختيار المدينة

والأوامر الثلاثة هي ما يطلب قسم الأوامر العامة من كل مطور أن يدعمه، والوصف يقبل العربية، أما الأمر نفسه فلاتيني دائماً، فلا تحاول /وظائف لأنها ستُرفض.

قائمة بلغتين لجمهور مختلط

إن كان جمهورك عرباً وغير عرب فالدالة setMyCommands تقبل رمز لغة من حرفين مثل ar أو en، فيرى كل مستخدم أوصاف الأوامر بلغة تطبيقه، ومن لا توجد لغته يرى القائمة العامة، وتقبل أيضاً نطاقاً يحدد لمن تظهر القائمة، كأن تظهر أوامر الإدارة لمشرفي المجموعة وحدهم.

روابط البوت العميقة: اعرف من أين جاء كل مشترك

لكل بوت رابط ثابت بصيغة https://t.me/اسم_البوت، وقسم الروابط العميقة في التوثيق يسمح بإضافة معامل إليه، فالرابط t.me/اسم_البوت?start=jobs يفتح البوت، وحين يضغط الزائر «ابدأ» يصل إلى بوتك الأمر /start jobs، وبهذا يعرف البوت من أي صفحة جاء.

• في نهاية المقال: ?start=article فتعرف كم مشتركاً جاء من المقالات
• في صفحة مدينة: ?start=madinah فيرحب البوت بالزائر بوظائف مدينته
• في مجموعة: الصيغة ?startgroup= تفتح نافذة لإضافة البوت إلى مجموعة مع معامل

وهذا قياس لا تعطيك إياه القناة وحدها، فعدد متابعي القناة لا يقول من أين جاؤوا، أما المعامل فيخبرك أي صفحة في موقعك تجلب المهتمين فعلاً، فتضع جهدك فيها، والمختبر أدناه يولّد لك هذه الروابط مع اسم بوتك.

مختبر بوت تيليجرام: جهّز الأوامر والروابط قبل BotFather

اكتب اسم البوت واسم المستخدم الذي تنوي حجزه، ثم أوامرك وأوصافها، فيفحص المختبر كل شيء بقواعد تيليجرام الرسمية، ويولّد نص /setcommands جاهزاً للنسخ، وروابط t.me لبوتك، ومعاينة لقائمة الأوامر كما ستظهر في المحادثة، والمختبر لا يطلب رمز البوت ولن يطلبه أبداً.

إن ظهر أمر باللون الأحمر فاقرأ سبب رفضه تحته، والنسبة في بطاقة النتيجة تعني عدد الحقول السليمة من مجموعها، فلا تلصق القائمة في BotFather قبل أن تصل إلى 100، وانسخ رابط البدء بالمعامل لتضعه في موقعك فتعرف كم زائراً جاء منه.

الرد الآلي في تيليجرام بلا برمجة: ما الممكن فعلاً؟

الصراحة هنا مهمة، فصفحة أسئلة البوتات الشائعة تقول إن البوت العامل يحتاج قدراً من البرمجة، وإنه لا توجد طريقة جاهزة من تيليجرام لمن ليس مطوراً، فكل «رد آلي بلا كود» تجده يعني أن برنامج غيرك يستقبل رسائل بوتك ويرد عنك.

• منصات بناء البوتات: تلصق فيها الرمز وتبني الردود بالسحب والإفلات، وبوتك يعمل على خوادمها وتطّلع هي على رسائله
• خدمات الأتمتة: مثل IFTTT التي تربط تيليجرام بخدمات أخرى، وتفيد في التنبيهات أكثر من المحادثة
• إضافات ووردبريس: تستعمل بوتك للنشر في القناة أو لتنبيهك بالطلبات، دون أن تكتب سطراً

قبل أن تعطي رمز بوتك لأي منصة اسأل: هل تحتاج كل رسائل المستخدمين؟ وأين تُحفظ؟ فالرمز يمنحها التحكم الكامل، وشروط مطوري البوتات تحمّلك مسؤولية بيانات من يستعمل بوتك.

الرد الآلي بكود قصير على استضافتك

لبوتك طريقتان لاستلام الرسائل، وتوثيق استلام التحديثات يقول إنهما لا تجتمعان، وإن التحديثات تنتظر على خوادم تيليجرام حتى يستلمها البوت لكن لا أكثر من 24 ساعة.

البند	getUpdates	Webhook
كيف يعمل	برنامجك يسأل تيليجرام دورياً: هل من جديد؟	تيليجرام يرسل كل رسالة إلى رابطك فوراً
ما يحتاجه	برنامج يعمل باستمرار	رابط HTTPS على أحد المنافذ 443 أو 80 أو 88 أو 8443
يناسب	التجربة على جهازك	استضافة موقعك المشتركة
تنبيه	لا يعمل ما دام webhook مضبوطاً	أضف secret_token لتتأكد أن الطلب من تيليجرام

صاحب موقع ووردبريس يملك استضافة بشهادة أمان، فالـWebhook أنسب له، وهذا ملف PHP صغير يرد على /start و/help، ويرفض أي طلب لا يحمل الترويسة X-Telegram-Bot-Api-Secret-Token التي يرسلها تيليجرام حين تضبط secret_token.

<?php
$token  = getenv( 'TG_BOT_TOKEN' );      // ضعه في إعدادات الاستضافة لا في الملف
$secret = getenv( 'TG_HOOK_SECRET' );
if ( ( $_SERVER['HTTP_X_TELEGRAM_BOT_API_SECRET_TOKEN'] ?? '' ) !== $secret ) {
    http_response_code( 403 );
    exit;
}
$update = json_decode( file_get_contents( 'php://input' ), true );
$chat   = $update['message']['chat']['id'] ?? null;
$text   = trim( $update['message']['text'] ?? '' );
if ( ! $chat ) {
    exit;
}
$replies = array(
    '/start' => 'أهلاً بك، هنا تصلك أحدث المقالات. اكتب /help لترى الأوامر.',
    '/help'  => "/start البداية\n/latest أحدث مقال",
);
$command = strtok( $text, ' @' );
$answer  = $replies[ $command ] ?? 'لم أفهم الأمر، اكتب /help.';
file_get_contents( 'https://api.telegram.org/bot' . $token . '/sendMessage?' . http_build_query( array( 'chat_id' => $chat, 'text' => $answer ) ) );

ارفع الملف إلى استضافتك، وإن لم تعتد التعامل مع ملفات الاستضافة فابدأ بشرح تحديث ملفات php الخاصة باستضافة موقعك، ثم اضبط الرابط مرة واحدة بالدالة setWebhook ممرراً لها رابط الملف والقيمة السرية، والقيمة السرية من 1 إلى 256 حرفاً من الحروف اللاتينية والأرقام والشرطتين.

خطأ شائع: ضبط الـWebhook بفتح رابط فيه الرمز في المتصفح ثم نسيانه، فالرابط يبقى في سجل المتصفح وقد يُزامَن مع أجهزة أخرى، والأسلم أن تنفذه من سطر الأوامر في الاستضافة أو تمسح السجل بعده، وللتأكد من أن رمزك يعمل يذكر الدرس الرسمي الدالة getMe التي تعيد بيانات البوت فقط.

أمان البوت: الرمز سر، وهذه حدود الإرسال

1. رمز مكشوف؟ أرسل /token في BotFather فيُولَّد رمز جديد ويتوقف القديم، ثم حدّثه في كل مكان يستعمله
2. لا رمز في المتصفح: أي كود JavaScript في صفحة عامة يراه كل زائر، فالرمز مكانه الخادم وحده
3. وضع الخصوصية في المجموعات: البوت لا يرى افتراضياً إلا الأوامر الموجهة إليه والردود عليه، إلا إن جعلته مشرفاً، فلا تعطله إلا لحاجة حقيقية
4. سياسة خصوصية: شروط المطورين تطبق سياسة تيليجرام القياسية للبوتات افتراضياً، فإن جمعت بيانات أكثر منها فاضبط سياستك في BotFather
5. حدود الإرسال: الأسئلة الشائعة تنصح بألا تتجاوز رسالة في الثانية للمحادثة الواحدة، و20 رسالة في الدقيقة للمجموعة، ونحو 30 رسالة في الثانية للإرسال الجماعي، وتجاوزها يعيد الخطأ 429

وإن كان هدفك من البوت جمهوراً يتابعك فلا تكتفِ به، فالقناة والمجموعة تكملانه كما في بناء مجتمعات رقمية قوية لمدونتك، وإن كان جمهورك على واتساب أيضاً فاقرأ النشر التلقائي في قناة واتساب لأن قواعده تختلف عن تيليجرام اختلافاً كبيراً.

من أدوات أيمن · سايروبوت ينشر يحتاج ما ينشرهسايرو تكتب لموقعك مقالات عربية أصيلة من مصادرك كل يوم، فيجد بوتك وقناتك جديداً دائماًتعرّف على سايرو

الأسئلة الشائعة

كيف أنشئ بوت تيليجرام مجاناً؟

افتح @BotFather وأرسل /newbot، واختر اسماً واسم مستخدم ينتهي بـbot، فيُنشأ البوت ويصلك رمزه فوراً، والإنشاء مجاني، أما تشغيله فيحتاج استضافة أو خدمة تستقبل رسائله.

ما هو بوت فاذر في تيليجرام؟

BotFather هو البوت الرسمي من تيليجرام لإنشاء البوتات وإدارتها، ومنه تغير الاسم والوصف والصورة والأوامر، وتولّد رمزاً جديداً إن تسرّب القديم، وتحذف البوت إن شئت.

كيف أعمل رد تلقائي في تيليجرام؟

بربط بوتك بملف على استضافتك عبر Webhook يقرأ الرسالة ويرد بالدالة sendMessage، أو بمنصة بناء بوتات تعطيها الرمز وتبني الردود فيها، مع الانتباه إلى أنها تطّلع على رسائل بوتك.

هل يمكن تغيير اسم مستخدم البوت بعد إنشائه؟

لا، فتوثيق BotFather ينص على أن اسم المستخدم لا يُغيَّر لاحقاً بخلاف الاسم الظاهر، فاختره بعناية، والحل الوحيد بوت جديد باسم جديد.

هل يمكن إنشاء بوت تلجرام بايثون بدل PHP؟

نعم، فالواجهة طلبات HTTPS عادية تعمل من أي لغة، واختر اللغة التي تدعمها استضافتك، وPHP متاح في أغلب استضافات ووردبريس المشتركة.

لماذا لا يرد بوتي في المجموعة؟

غالباً بسبب وضع الخصوصية، فالبوت لا يرى إلا الأوامر الموجهة إليه بصيغة /command@اسم_البوت والردود على رسائله، فاجعله مشرفاً أو اكتب الأمر موجهاً إليه.

مصادر الصور: Thomas Quine عبر commons.wikimedia.org (CC BY 2.0، بتعديل)، W.carter عبر commons.wikimedia.org (CC BY-SA 4.0، بتعديل)، Mercado Viagens عبر commons.wikimedia.org (CC BY 2.0، بتعديل).