إنتقل إلى المحتوى الرئيسي

🤖 بوت Telegram

يتصل PulseHub بـ Telegram عبر Bot API. عندما يرسل المستخدمون رسائل إلى بوت Telegram الخاص بك، تظهر الرسائل في PulseHub.

المتطلبات الأساسية​

حساب Telegram والوصول إلى @BotFather لإنشاء بوت.

خطوات الإعداد​

1. إنشاء بوت باستخدام BotFather​

  1. افتح Telegram وابحث عن @BotFather
  2. أرسل /newbot
  3. اختر اسم العرض (مثال: "دعم Acme")
  4. اختر اسم مستخدم ينتهي بـ bot (مثال: acmesupport_bot)
  5. يرد BotFather بـ Bot Token الخاص بك

2. إضافة القناة في PulseHub​

  1. انتقل إلى Channels → Add Channel
  2. اختر Telegram
  3. الصق Bot Token الخاص بك
  4. انقر على Save Channel
  5. انسخ رابط Webhook

3. تسجيل Webhook في Telegram​

افتح هذا الرابط في متصفحك:

https://api.telegram.org/bot{YOUR_BOT_TOKEN}/setWebhook?url={YOUR_PULSEHUB_WEBHOOK_URL}

يستجيب Telegram بـ: {"ok": true, "result": true, "description": "Webhook was set"}

4. الاختبار​

افتح البوت في Telegram وأرسل رسالة. يجب أن تظهر في PulseHub خلال ثوانٍ.

متطلبات Webhook في Telegram​

  • يجب أن يستخدم رابط webhook بروتوكول HTTPS مع شهادة SSL صالحة
  • يتوقع Telegram استجابة 200 خلال 60 ثانية

المشاكل الشائعة​

العرضالسبب المحتمل
لم يتم تعيين Webhookيجب أن يكون الرابط HTTPS مع شهادة صالحة
البوت لا يستجيبتحقق من أن telegram_chat_id موجود في contacts.external_ids
إعادة تسليم الرسائل القديمةأمر طبيعي عند إعادة تسجيل webhook