عدد الكلمات: ٨٠٠ · مدة القراءة: ٤ دقائق

بوت تلغرام باستخدام بايثون

بناء بُوت تليجرام للتواصل مع العملاء باحترافية بلغة بايثون

ملاحظة: هذا المقال مستقلٌ تماماً ويمنحك خطواتٍ عمليةٍ لبناء مشروعك الخاص. ولكن إذا كنت مبتدئاً تماماً في عالم البرمجة، فنحن ننصحك بالبدء من المقال الأول في السلسلة:
لماذا يجب على كل فريلانسر يعمل في الويب تعلم بايثون في 2026؟ لتفهم الأساسيات بشكلٍ متدرج.

كم مرةً ضاع من وقتك الثمين ساعتان أو ثلاث ساعات في يوم واحد وأنت تجيب على نفس الأسئلة المتكررة من عملاء محتملين؟ “كم تكلفة تصميم موقع تعريفي؟”، “هل أنت متفرغٌ للعمل الآن؟”، “أين يمكنني رؤية معرض أعمالك؟”. هذه المحادثات، رغْم أهميتها لإغلاق الصفقات، تستهلك طاقةً كان من الممكن استثمارها في الإنتاج الفعلي والكتابة البرمجية التي تدر عليك دخلاً مباشراً.

في عام 2026، لم يعد مقبولاً أن تلعب دور السكرتير والمطور في آن واحد يدوياً. الحل يكمن في الأتمتة الذكية. من خلال بناء بُوت (روبوتٌ برمجي) بسيطٍ على منصات التواصل مثل تليجرام (Telegram) أو واتساب (WhatsApp)، يمكنك توفير مساعدٍ رقميٍ يعمل لصالحك على مدار 24 ساعة، يجيب على استفسارات العملاء، يعرض قائمة أسعارك، يرسل رابط معرض أعمالك، بل ويحسب تكلفة المشروع التقريبية للعميل قبل أن يتحدث معك حتى!

في هذا الدليل العملي من منصة ذي يزن، سنتعلم معاً كيفية بناء بُوت تليجرام ذكيٌ ومخصصٌ لإدارة عملائك باستخدام لغة بايثون. اخترنا منصة تليجرام نظراً لسهولة تطوير البوتات عليها مجانًا وبدون أيّ قيودٍ أو مصاريفٍ إضافيةٍ مقارنةً بواتساب الذي يتطلب موافقاتٍ وحسابات أعمالٍ مدفوعةٍ ومعقدةٍ للمبتدئين.

لماذا تليجرام وليس واتساب؟ (مقارنةٌ سريعةٌ للفريلانسر)

قبل أن نكتب سطراً برمجياً واحداً، دعنا نوضح لماذا نفضّل تليجرام في هذه المرحلة من رحلتك البرمجية كفريلانسر، وذلك عبر جدولٍ يوضح الفروق الجوهرية:

لذلك، وبناءً على الكفاءة والسرعة، سنعتمد تليجرام كمنصة أساسية لبناء مساعدنا الرقمي اليوم.

الخطوة 1: إنشاء البوت والحصول على الرمز التعريفي (التوكن)

لإنشاء بُوت على تليجرام، لن نحتاج إلى تعبئة استمارات. كل ما عليك فعله هو فتح تطبيق تليجرام والبحث عن الحساب الرسمي المسؤول عن توليد البوتات والمعروف باسم الأب الروحي للبوتات (BotFather).

1. افتح تليجرام وابحث عن المستخدم التالي: @BotFather (تأكد من وجود علامة التوثيق الزرقاء بجانب الاسم لتجنب الحسابات المزيفة).
2. اضغط على زر ابدأ (Start) ثم أرسل الأمر التالي: /newbot.
3. سيطلب منك الاسم المستعار للبوت (مثال: مساعد ذي يزن الرقمي).
4. سيطلب منك بعد ذلك تحديد اسم مستخدم (Username) ينتهي بكلمة bot إلزامًا (مثال: ZyYazanAssistant_bot).
5. بمجرد القبول، سيرسل لك رسالة تحتوي على الرمز التعريفي للواجهة البرمجية (API Token) وهو سلسلة طويلة من الحروف والأرقام. احتفظ بهذا الرمز سريًا تمامًا، فهو بمثابة الرقم السري للبوت الخاص بك.

الخطوة 2: تهيئة بيئة العمل وتثبيت المكتبات

الآن، ننتقل إلى جهاز الكمبيوتر الخاص بنا. لكي نجعل بايثون يتحدث مع خوادم تليجرام بسلاسة، سنستخدم مكتبة برمجية شهيرة وسهلة الاستخدام تُدعى pyTelegramBotAPI.

افتح نافذة موجه الأوامر (Terminal) في نظامك وقم بتنفيذ الأمر التالي لتثبيت المكتبة:

pip install pyTelegramBotAPI

الخطوة 3: كتابة السكريبت البرمجي للمساعد الرقمي

سنقوم الآن بكتابة سكريبت بايثون متكامل. هذا البوت سيقوم بالترحيب بالعميل وعرض قائمة أزرار تفاعلية تشمل: (خدماتنا وأسعارنا، معرض الأعمال، حساب تكلفة مشروع، وترك رسالة خاصة).

قم بإنشاء ملف جديد باسم client_bot.py واكتب فيه الكود التالي كاملاً، مع استبدال النص التجريبي برمز التوكن الخاص بك:

import telebot
from telebot import types

# ضع هنا الرمز التعريفي (Token) الذي حصلت عليه من BotFather
BOT_TOKEN = "YOUR_ACTUAL_TELEGRAM_BOT_TOKEN_HERE"

bot = telebot.TeleBot(BOT_TOKEN)

# دالة التعامل مع أمر البداية /start
@bot.message_handler(commands=['start', 'help'])
def send_welcome(message):
    welcome_text = (
        "مرحبًا بك في منصة ذي يزن للخدمات التقنية! 🚀\n\n"
        "أنا مساعدك الرقمي الآلي، متواجد هنا لمساعدتك وتوفير وقتك. "
        "من فضلك اختر الخدمة التي تبحث عنها من الأزرار أدناه:"
    )
    
    # إنشاء لوحة مفاتيح تفاعلية تظهر أسفل شاشة المحادثة
    markup = types.ReplyKeyboardMarkup(row_width=2, resize_keyboard=True)
    btn_services = types.KeyboardButton("💼 خدماتنا وأسعارنا")
    btn_portfolio = types.KeyboardButton("🌐 معرض الأعمال")
    btn_calculator = types.KeyboardButton("🧮 حاسبة المشاريع")
    btn_contact = types.KeyboardButton("📩 ترك رسالة مباشرة")
    
    markup.add(btn_services, btn_portfolio, btn_calculator, btn_contact)
    bot.reply_to(message, welcome_text, reply_markup=markup)

# التعامل مع الرسائل النصية والخيارات المدخلة
@bot.message_handler(func=lambda message: True)
def handle_messages(message):
    if message.text == "💼 خدماتنا وأسعارنا":
        services_text = (
            "✨ **خدماتنا المتاحة حاليًا:**\n\n"
            "1️⃣ **تطوير مواقع الويب الثابتة:** تبدأ من 300 دولار.\n"
            "2️⃣ **أتمتة العمليات وبناء البوتات ببايثون:** تبدأ من 200 دولار.\n"
            "3️⃣ **تطوير المواقع الديناميكية (فلاسك/ديجانجو):** تبدأ من 600 دولار.\n\n"
            "💡 جميع أعمالنا تسلم بجودة عالية مع دعم فني لمدة شهر مجانًا."
        )
        bot.reply_to(message, services_text, parse_mode="Markdown")
        
    elif message.text == "🌐 معرض الأعمال":
        portfolio_text = (
            "سعداء باطلاعك على قصص نجاحنا! 🎯\n\n"
            "يمكنك تصفح معرض أعمالنا البرمجية وتصاميمنا مباشرة عبر موقعنا الإلكتروني:\n"
            "🔗 https://zyyazan.synn"
            "إذا نال أحد المشاريع إعجابك، أخبرنا لنبدأ العمل على مشروعك فورًا!"
        )
        bot.reply_to(message, portfolio_text)
        
    elif message.text == "🧮 حاسبة المشاريع":
        # توجيه العميل لكيفية الاستفادة من ميزة الحساب الفوري
        calc_instruction = (
            "💡 **خدمة الحساب التقديري الذكي:**\n\n"
            "لمعرفة التكلفة التقريبية لمشروعك فورًا، أرسل رسالة تبدأ بكلمة 'احسب' "
            "متبوعة بنوع المشروع. مثال:\n"
            "`احسب موقع تعريفي`\n"
            "`احسب متجر إلكتروني`"
        )
        bot.reply_to(message, calc_instruction, parse_mode="Markdown")
        
    elif message.text == "📩 ترك رسالة مباشرة":
        contact_text = (
            "إن وقتك ثمين جدًا بالنسبة لنا. 🤝\n\n"
            "اكتب تفاصيل طلبك أو استفسارك في الرسالة القادمة مباشرة، "
            "وسيقوم المطور بمراجعتها والرد عليك شخصيًا خلال أقل من 4 ساعات."
        )
        bot.reply_to(message, contact_text)
        
    # آلية الذكاء البسيط: معالجة طلبات حساب التكلفة التلقائية
    elif message.text.startswith("احسب"):
        project_type = message.text.replace("احسب", "").strip()
        
        if "تعريفي" in project_type or "شخصي" in project_type:
            price_estimate = "💰 التكلفة التقريبية للموقع التعريفي هي 300 - 450 دولار. مدة التنفيذ: 5 أيام."
        elif "متجر" in project_type or "إلكتروني" in project_type:
            price_estimate = "💰 التكلفة التقريبية للمتجر الإلكتروني هي 800 - 1500 دولار. مدة التنفيذ: 14 يومًا."
        elif "بوت" in project_type or "أتمتة" in project_type:
            price_estimate = "💰 التكلفة التقريبية لأتمتة المهام وبناء البوتات هي 200 - 400 دولار. مدة التنفيذ: 3 أيام."
        else:
            price_estimate = "❓ لم أستطع تحديد نوع المشروع بدقة. لكن عمومًا، تبدأ أسعار خدماتنا البرمجية من 200 دولار. اترك رسالة وسيتواصل معك المطور لتحديد السعر الدقيق."
            
        bot.reply_to(message, price_estimate)
        
    else:
        # استجابة عامة لأي مدخلات أخرى تضمن عدم بقاء العميل معلقًا
        default_response = "تلقيت رسالتك بنجاح! سيتم تحويلها مباشرة إلى المطور، وإذا كنت تريد استخدام القائمة السريعة أرسل /start في أي وقت."
        bot.reply_to(message, default_response)

# تشغيل البوت بشكل مستمر لمراقبة الرسائل القادمة
if __name__ == "__main__":
    print("🤖 البوت يعمل الآن بنجاح ومستعد لاستقبال رسائل العملاء...")
    bot.infinity_polling()

شرح المنطق البرمجي للكود (كيف يعمل البوت؟)

إذا قمت بقراءة الكود، ستجد أنه مبني على مفهوم هندسي يسمى مستمعات الأحداث (Event Handlers). دعنا نلخص عمل الأجزاء الحيوية بأسلوب مبسط:

• الديكوريتور @bot.message_handler: هذا السطر يخبر بايثون بأن الدالة التي تلي هذا الأمر مباشرة يجب أن تشتعل وتنفذ فقط إذا كانت الرسالة القادمة من العميل تطابق الشروط المحددة (مثل إرسال كلمة /start).
• الكلاس types.ReplyKeyboardMarkup: هو المسؤول عن بناء الأزرار التي تظهر للمستخدم أسفل صندوق المحادثة. قمنا بتفعيل خاصية resize_keyboard=True لضمان أن تظهر الأزرار بحجم مناسب وأنيق على شاشات الهواتف المحمولة الذكية وأجهزة الحاسوب المحمول دون تمدد مشوه.
• خاصية bot.infinity_polling(): هذه الدالة تجعل السكريبت يدخل في حلقة تكرارية لا نهائية تقوم بفحص خوادم تليجرام كل جزء من الثانية لجلب أي رسالة جديدة فور إرسالها من قبل العميل، مما يحقق ميزة الرد الفوري المباشر.

الخطوة 4: تشغيل البوت وتجربته محليًا

لتجربة السكريبت على جهازك، قم بتشغيل الملف عبر موجه الأوامر:

python client_bot.py

سترى جملة “البوت يعمل الآن بنجاح…”. توجه فورًا إلى تطبيق تليجرام، افتح المحادثة الخاصة بالبوت الذي أنشأته، واضغط على Start. تهانينا! المساعد الرقمي الخاص بك يستجيب لك الآن بلمح البصر ويعرض قائمتك الاحترافية.

الخطوة 5: كيف تجعل البوت يعمل 24 ساعة دون انقطاع؟

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

لتحقيق ذلك، نحتاج إلى رفع الملف البرمجي إلى خادم سحابي دائم الاتصال بالإنترنت (VPS) أو استخدام منصات استضافة برمجية متخصصة تدعم لغة بايثون مجانًا. من أفضل الخيارات المتاحة للمطورين المستقلين:

1. منصة بايثون إني وير (PythonAnywhere): تمنحك حسابًا مجانيًا بالكامل يتيح لك رفع ملف البوت وتشغيله كمهام خلفية مستمرة (Always-on tasks) بضغطة زر واحدة ودون تعقيدات في إدارة السيرفرات.
2. منصة ريندير (Render) أو هيروكو (Heroku): وهي منصات سحابية ممتازة لرفع السكريبتات وتوفر خططًا مجانية أو منخفضة التكلفة مناسبة تمامًا لبداياتك كفريلانسر.

نصيحة ذهبية لتطوير مشروعك القادم كفريلانسر

ما قمنا ببنائه اليوم هو نموذج أولي قوي، ولكن يمكنك تحويله إلى نظام إدارة عملاء متكامل (CRM). على سبيل المثال، يمكنك ربط هذا البوت بقاعدة بيانات بسيطة (مثلما سنتعلم في المقالات القادمة) لحفظ أسماء العملاء الذين تواصلوا معك، أو جعله يقوم بإرسال إشعار فوري إلى حسابك الشخصي على تليجرام يحتوي على نص الرسالة التي تركها العميل لك لتقوم بالرد عليه مباشرة دون تضييع ثانية واحدة.

الخطوة التالية الموصى بها:

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

المراجع والمصادر:

1. التوثيق الرسمي لمكتبة pyTelegramBotAPI على منصة جيت هاب: pyTelegramBotAPI GitHub Repository
2. دليل مقدمة واجهة برمجة تطبيقات بوتات تليجرام الرسمي: Telegram Bots API Documentation