يمكنك ربط Telegram مع n8n لتحويل الـWorkflow من عملية تعمل في الخلفية إلى نظام يرسل لك تنبيهًا فور حدوث شيء مهم: وصول Lead جديد، فشل عملية، اكتمال مهمة، أو تحقق شرط معين. في هذا الدليل سنبني الربط من الصفر بطريقة مناسبة للمبتدئين، ثم نحوله إلى مثال عملي قابل للتطوير.
ماذا سنبني؟
سننشئ Telegram Bot، نربطه بـn8n باستخدام Credentials، ثم نبني Workflow بسيطًا يرسل رسالة تلقائية. بعد ذلك نضيف شرطًا باستخدام IF حتى لا تصل الرسائل إلا عندما تتحقق حالة تستحق التنبيه.
قبل البدء
تحتاج حساب Telegram وبيئة n8n تعمل لديك. إذا كنت جديدًا تمامًا، ابدأ أولًا من دليل n8n للمبتدئين. وإذا كنت محتارًا بين الخدمة السحابية والاستضافة الذاتية، راجع مقارنة n8n Cloud وSelf-Hosted.
الخطوة 1: إنشاء Telegram Bot
افتح Telegram وابحث عن BotFather، ثم ابدأ محادثة جديدة واستخدم أمر إنشاء Bot. اختر اسمًا واضحًا واسم مستخدم ينتهي عادةً بـbot. سيعطيك BotFather رمز Token خاصًا بالبوت.
مهم: تعامل مع الـToken كبيانات اعتماد سرية. لا تضعه في مقال أو لقطة شاشة عامة ولا ترسله داخل Workflow منشور للآخرين.
الخطوة 2: إضافة Telegram Credentials داخل n8n
داخل n8n أنشئ Credential جديدًا خاصًا بـTelegram وأدخل Bot Token في الحقل المخصص. بهذه الطريقة لا تحتاج إلى كتابة السر داخل كل Node، ويسهل تغييره لاحقًا من مكان واحد.
الخطوة 3: الحصول على Chat ID
أرسل رسالة إلى البوت من حسابك أولًا. بعد ذلك يمكنك استخدام Telegram Trigger داخل n8n لالتقاط الرسالة ومعرفة Chat ID، أو قراءة بيانات التحديث الواردة من Telegram. احتفظ بالـChat ID لأنه يحدد المحادثة التي ستستقبل التنبيه.
الخطوة 4: إنشاء Workflow لإرسال رسالة
أنشئ Workflow جديدًا وأضف Trigger مناسبًا. للاختبار يمكنك استخدام Manual Trigger. بعده أضف Telegram Node واختر عملية إرسال رسالة، ثم حدد Credential والـChat ID واكتب نصًا مثل: «تم تنفيذ الـWorkflow بنجاح».
الخطوة 5: اجعل الرسالة ديناميكية
يمكنك تمرير اسم العميل أو رقم الطلب أو حالة العملية من Node سابقة باستخدام Expressions. راجع دليل Expressions وJSON في n8n.
الخطوة 6: أرسل التنبيه فقط عند تحقق شرط
ضع IF Node قبل Telegram وحدد الشرط الذي يستحق التنبيه. راجع دليل IF وSwitch في n8n.
مثال عملي: تنبيه عند فشل Workflow
عندما يفشل Workflow مهم، يمكن لمسار الخطأ أن يجمع اسم الـWorkflow ووقت الفشل ورسالة الخطأ ثم يرسلها إلى Telegram. استخدم أيضًا دليل التعامل مع أخطاء n8n وError Workflow.
ربط Telegram مع Webhook أو API
يمكن أن يبدأ الـWorkflow من Webhook ثم يرسل ملخصًا إلى Telegram. راجع شرح Webhook في n8n ودليل HTTP Request وربط APIs.
أخطاء شائعة
- البوت لا يرسل: تأكد أنك بدأت محادثة معه وأن Chat ID صحيح.
- Unauthorized: راجع Bot Token والـCredential.
- رسائل كثيرة: أضف IF أو Switch وحدد الحالات المهمة فقط.
- البيانات تظهر فارغة: افحص JSON الخارج من الـNode السابقة.
- كشف الـToken: غيّر الرمز فورًا إذا ظهر في مكان عام.
أفضل استخدامات Telegram مع n8n
- تنبيه عند وصول Lead أو طلب جديد.
- إشعار عند فشل Workflow مهم.
- ملخص يومي للعمليات.
- تنبيه عند تجاوز KPI حدًا معينًا.
- إرسال نتائج Workflow إلى فريق صغير.
متى تستخدم Telegram Trigger؟
إذا أردت أن يبدأ الـWorkflow برسالة يرسلها المستخدم إلى البوت، استخدم Telegram Trigger. أما إذا كان Telegram مجرد قناة إخراج للتنبيهات، فعادةً يكفي Telegram Node في نهاية المسار.
الخلاصة
الربط الأساسي بسيط: Bot Token + Credential + Chat ID + Telegram Node. لكن التصميم الجيد يعتمد على شروط واضحة، بيانات صحيحة، ومعالجة أخطاء تمنع الضوضاء.
أسئلة شائعة
هل أحتاج برمجة لربط Telegram مع n8n؟
لا في السيناريوهات الأساسية. معظم الربط يتم من خلال Nodes وCredentials وExpressions.
هل يمكن إرسال الرسائل إلى مجموعة Telegram؟
نعم، بشرط إضافة البوت إلى المجموعة ومنحه الصلاحيات المطلوبة واستخدام Chat ID الصحيح.
هل يمكن استخدام Telegram لمراقبة أخطاء n8n؟
نعم، وهو من الاستخدامات العملية جدًا عند دمجه مع Error Workflow.