كيفية إنشاء بوت Telegram وإرسال الرسائل باستخدام Laravel 11

في هذه المدونة، سنكتشف كيفية إنشاء بوت Telegram ودمجه بسلاسة مع Laravel 11 في هذا الدليل الشامل. تعرّف على التعليمات خطوة بخطوة للحصول على رمز API الخاص بك، إعداد مكتبة irazasyed/telegram-bot-sdk، وإرسال الرسائل مباشرةً إلى البوت الخاص بك. سواء كنت مبتدئًا أو مطورًا ذو خبرة، يوفر هذا البرنامج التعليمي كل المعلومات الأساسية التي تحتاجها لتعزيز تطبيقاتك بقدرات المراسلة الخاصة بـ Telegram. ابدأ في بناء تجارب تفاعلية وجذابة لمستخدميك اليوم!

الخطوة 1: إنشاء بوت Telegram الخاص بك

افتح Telegram: قم بتشغيل تطبيق Telegram على جهازك أو الوصول إلى الإصدار الويب.
ابحث عن BotFather: في شريط البحث، اكتب @BotFather واختر البوت الرسمي لـ BotFather. هذا البوت مسؤول عن إنشاء وإدارة البوتات الأخرى.
ابدأ محادثة: اضغط على زر "بدء" أو اكتب /start لبدء المحادثة مع BotFather.
إنشاء بوت جديد: استخدم الأمر /newbot لإنشاء بوت جديد. سيطلب منك BotFather اختيار اسم واسم مستخدم للبوت الخاص بك:
- الاسم: هذا هو الاسم الذي سيظهر للبوت (مثل "بوتي الرائع").
- اسم المستخدم: يجب أن يكون فريدًا وينتهي بكلمة "bot" (مثل "myawesome_bot").
احصل على رمز API الخاص بك: بعد إنشاء البوت، سيقدم لك BotFather رمز API. سيبدو كالتالي:
مثال:
```
123456789:ABCdefGhIJKlmNoPQRstUvWxYz1234567890
```
احفظ هذا الرمز حيث ستحتاجه للاتصال بين تطبيق Laravel والبوت الخاص بك.

الخطوة 2: إعداد Laravel 11

2.1 إنشاء مشروع Laravel جديد

قم بإنشاء مشروع جديد من خلال تشغيل الأمر التالي:

composer create-project laravel/laravel laravel-telegram-bot

2.2 تثبيت مكتبة Telegram Bot SDK

بعد ذلك، قم بتثبيت مكتبة irazasyed/telegram-bot-sdk باستخدام Composer:

composer require irazasyed/telegram-bot-sdk

2.3 إعداد المكتبة

بعد تثبيت المكتبة، قم بنشر ملف التكوين باستخدام الأمر:

php artisan vendor:publish --tag="telegram-config"

سيتم إنشاء ملف تكوين جديد في المسار config/telegram.php.

2.4 إضافة رمز البوت في ملف `.env`

افتح ملف .env الخاص بك وأضف رمز البوت الخاص بك:

TELEGRAM_BOT_TOKEN=123456789:ABCdefGhIJKlmNoPQRstUvWxYz1234567890

الخطوة 3: إرسال رسالة إلى البوت الخاص بك

الآن وبعد أن تم إعداد البوت وتكوينه، دعنا ننشئ مسارًا لإرسال الرسائل إلى البوت.

3.1 إنشاء مسار

افتح ملف routes/web.php وأضف المسار التالي:

use Telegram\Bot\Laravel\Facades\Telegram;

Route::get('/send-message', function () {
    $chatId = 'YOUR_CHAT_ID'; // Replace with your chat ID
    $message = 'Hello, this is a message from Laravel!';

    Telegram::sendMessage([
        'chat_id' => $chatId,
        'text' => $message,
    ]);

    return 'Message sent to Telegram!';
});

3.2 الحصول على معرف الدردشة الخاص بك

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

أضف مسارًا آخر إلى ملف routes/web.php:

Route::get("/get-updates", function () {
  $updates = Telegram::getUpdates();
  return $updates;
});

3.3 اختبار إرسال الرسالة

الآن قم بزيارة الرابط http://127.0.0.1:8000/send-message في متصفحك، واستبدل 127.0.0.1:8000 بعنوان URL الفعلي لتطبيقك. يجب أن ترى رسالة تقول "تم إرسال الرسالة إلى Telegram!" وتستلم الرسالة في دردشة Telegram الخاصة بك.

الخاتمة

لقد قمت بإنشاء بوت Telegram بنجاح، وحصلت على رمز API، ودمجته في تطبيق Laravel 11 باستخدام مكتبة irazasyed/telegram-bot-sdk. الآن يمكنك بناء تفاعلات أكثر تعقيدًا مع البوت الخاص بك أو توسيع قدراته.

للمزيد من الاستكشاف، يمكنك إضافة ميزات مثل معالجة الرسائل الواردة، إعداد معالجات الأوامر، أو التكامل مع خدمات أخرى. الفرص مع بوتات Telegram لا تنتهي!