n8n · n8n.io

اربط تيليجرام بـ n8n

أضف Entergram كمصدر بيانات MCP في n8n وأتمت حساب تيليجرام الحقيقي — علّم الرسائل التي فاتتك، وطارد العملاء المحتملين الذين فتروا، ووجّه ملاحظات العملاء إلى حيث يجب أن تذهب.

عنوان خادم MCP https://mcp.entergram.com/mcp

ابدأ مجانًا عرض جميع الموصّلات

يأتي n8n مزودًا بعقدة MCP تتصل بخوادم MCP الخارجية. يتيح Entergram حساب تيليجرام الشخصي كخادم MCP مُستضاف، فيبني n8n أتمتة مرئية على محادثاتك الفعلية بأمان OAuth كامل — بلا حساب بوت وبلا كود مخصص.

إعداد جاهز للّصق

n8n → MCP node → Server URL

https://mcp.entergram.com/mcp

أتمتة تستحق البناء

بحسابك الشخصي مرتبطًا، يستطيع n8n مراقبة محادثاتك والتصرف بناءً عليها. على سبيل المثال:

كل صباح، انشر ملخصًا بالرسائل التي فاتتك وبالعملاء الذين ما زالوا ينتظرون ردًا.
علّم العملاء المحتملين الذين راسلوا مرتين دون رد وأنشئ مهمة متابعة.
حين يرسل عميل ملاحظة، وسِمها وسجّلها في الـ CRM أو في جدول بيانات.
اكتشف الأسئلة التي بقيت مقروءة دون رد لمدة 24 ساعة وأرسل لنفسك تذكيرًا.
احسب الفرص الضائعة أسبوعيًا وادفع الرقم إلى Slack.

اربط n8n في 3 خطوات

يعمل مع عقدة MCP في n8n.

01
انسخ عنوان MCP الخاص بك في Entergram
في Entergram، افتح Settings → Workspace → Connectors → MCP وانسخ عنوان خادم MCP الخاص بك.
02
أضف عقدة MCP في n8n
في سير عمل n8n لديك، أضف عقدة MCP ووجّهها إلى عنوان MCP الخاص بـ Entergram: https://mcp.entergram.com/mcp.
03
امنح الإذن وابنِ
انقر Connect، وسجّل الدخول بحساب Entergram الخاص بك، وانقر Allow access، ثم اربط مُطلقات تيليجرام وإجراءاته داخل سيناريوهات n8n لديك.

ثلاث طرق لتشغيل Entergram داخل n8n

n8n Cloud

أقصر الطرق. ضع عقدة MCP Client في سير عمل، والصق نقطة النهاية المُستضافة، ودع n8n Cloud يتولى دورة OAuth كاملةً على نطاق الاستدعاء الراجع الخاص به — فلا نفق تفتحه ولا شهادة تديرها. ولأن خادم Entergram بعيد، تحمل العقدة بيانات اعتماد بدل أن تشغّل عملية محلية، فيعمل سير العمل نفسه بالطريقة نفسها على كل عامل تنفيذ، ويبقى سليمًا بعد تصديره واستيراده في مشروع آخر.

n8n المستضاف ذاتيًا

العقدة نفسها، مع شرط إضافي واحد: مصافحة OAuth تعود إلى نسختك، فيجب أن يعرف n8n عنوانه العام. اضبط متغيرات المضيف والـ webhook قبل إنشاء بيانات الاعتماد، وإلا اكتملت شاشة الموافقة ثم ارتدّت إلى localhost. وكل ما بعد ذلك يتصرف كما في النسخة السحابية، بما في ذلك مشاركة بيانات الاعتماد بين المشاريع.

N8N_HOST=n8n.yourcompany.com
N8N_PROTOCOL=https
WEBHOOK_URL=https://n8n.yourcompany.com/

عقدة AI Agent مع أدوات MCP

بدل توصيل كل استدعاء يدويًا، اربط عميل MCP بعقدة AI Agent كمزوّد أدوات ودع النموذج يختار أي أدوات Entergram يستدعي لكل مُدخل. يناسب هذا المهام غير الحادّة — تصنيف رسالة واردة، أو تقرير ما إذا كان أمر ما يستحق تذكرة — حيث وصف منطق التفريع أسهل من رسمه. ثبّت قائمة الأدوات التي تريد إتاحتها فعلًا؛ فوكيل أمامه سبعون أداة سيسلك أحيانًا طريقًا التفافيًا، والوكيل المجدول لا ينبغي أن تكون الأدوات المدمِّرة في متناوله أصلًا.

ستة مسارات عمل تسدّد كلفتها بنفسها

لا يتحادث n8n مع حساب تيليجرام الخاص بك، بل يجدول العمل عليه. كل صف أدناه شكل سير عمل حقيقي: المُطلِق والهدف في جهة، واستدعاءات Entergram المرتّبة التي تحقّقه في الجهة الأخرى، وما يحطّ في أنظمتك حين ينتهي التشغيل. وكلها تعمل سواء فتح أحد التبويب أم لا، وهذا وحده سبب البناء هنا بدل بنائه في عميل دردشة.

سير العمل

كل ليلة عند الساعة 02:00، انسخ كل محادثات مساحة العمل وحقول خط الأنابيب الخاصة بها إلى Postgres من أجل لوحة ذكاء الأعمال.

الأدوات المستدعاة

entergram_list_workspace_chatsentergram_list_custom_columnsentergram_get_chat_custom_fields

ما ينتجه التشغيل

يوزّع مُطلِق مجدول قائمة المحادثات على عقدة Loop Over Items، ويقرأ مخطط الأعمدة مرة واحدة فتُحلّ المفاتيح بدل تخمينها، ثم يكتب صفًا لكل محادثة. يستعلم محلّلوك في صباح اليوم التالي عن حالة خط أنابيب تيليجرام بلغة SQL دون أن يلمس أحد Entergram.

سير العمل

حين ينشر نظام التكامل المستمر webhook باكتمال النشر، أبلِغ مجموعات العملاء المتأثرة بالإصدار.

الأدوات المستدعاة

entergram_list_groupsentergram_send_message

ما ينتجه التشغيل

تستقبل عقدة Webhook حمولة البناء، وتربط عقدة Code أسماء الخدمات بعناوين المجموعات المعنيّة بها، ثم ينطلق استدعاء إرسال واحد لكل مجموعة. تتوقف مراسلات الإصدار عن الاعتماد على من يتذكّر لصق سجل التغييرات، ولأن الرسالة تُركَّب من بيانات البناء فهي تحمل دائمًا النسخة التي شُحنت فعلًا.

سير العمل

كل ساعة، أغلِق أي تذكرة صمتت محادثتها الأصلية سبعة أيام.

الأدوات المستدعاة

entergram_list_ticketsentergram_list_messagesentergram_update_ticket

ما ينتجه التشغيل

يسحب سير العمل التذاكر المفتوحة، ويفحص توقيت آخر رسالة في كل محادثة مرتبطة، ويرشّح حسب العمر بعقدة IF قبل كتابة تغيير الحالة. تختفي البنود الراكدة من الطابور وحدها، وما يصله رد بعد الإغلاق يُعاد فتحه ببساطة عند أول رسالة واردة.

سير العمل

عند وصول حدث فشل دفع من مزوّد الفوترة، افتح تذكرة تحصيل مع إرفاق تفاصيل الفاتورة.

الأدوات المستدعاة

entergram_list_contactsentergram_create_ticketentergram_create_ticket_comment

ما ينتجه التشغيل

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

سير العمل

كل يوم أحد، قابِل عضوية مجموعات تيليجرام بكشف الموارد البشرية واحذف من غادر.

الأدوات المستدعاة

entergram_list_groupsentergram_list_group_membersentergram_remove_chat_member

ما ينتجه التشغيل

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

سير العمل

كل خمس عشرة دقيقة، حوّل الفواتير والعقود التي أسقطها العملاء في المحادثات إلى قناة المالية.

الأدوات المستدعاة

entergram_list_messagesentergram_get_messageentergram_forward_messages

ما ينتجه التشغيل

يمسح فرع الاستطلاع السجل الأخير بحثًا عن مرفقات المستندات، وتُبقي عقدة Filter ما يطابق قواعد التسمية لديك، ويحفظ التحويل نسبة الرسالة إلى مرسِلها الأصلي. تتوقف المالية عن السؤال عمّا إذا كان ملف PDF الموقّع ما زال قابعًا في رسائل أحدهم الخاصة.

ما الذي يستطيع n8n فعله بتيليجرام الخاص بك

—إطلاق سير العمل عند ورود رسائل وأحداث جديدة
—اكتشاف المحادثات غير المُجابة والعملاء المحتملين الذين فتروا
—إرسال الرسائل والبثوث من داخل سير العمل
—مزامنة جهات الاتصال والحقول المخصصة مع تطبيقات أخرى
—قياس الفرص الضائعة وفق جدول زمني
—نقل بيانات تيليجرام عبر منظومتك بأكملها

سطح الأدوات الذي تستدعيه مسارات عملك

بيانات اعتماد واحدة مُصرَّح لها تفتح الأدوات السبعين كلها عبر 9 مجموعات أمام كل عقدة تشير إليها. عمليًا ستثبّت حفنة منها لكل سير عمل — أدوات القراءة في فروع الاستطلاع، وأدوات الكتابة خلف مرشِّح — لكن لا شيء هنا يتطلب تكاملًا منفصلًا ولا بيانات اعتماد ثانية.

الحسابات ومساحة العمل

5 أداة

اكتشاف الهوية ونطاق الصلاحيات. كل استدعاء يخص الرسائل يحتاج أولًا إلى account_id من list_accounts — وأي عميل ذكاء اصطناعي يتخطى هذه الخطوة سيخاطب حساب تيليجرام الخطأ.

entergram_get_me
entergram_list_accounts
entergram_get_workspace
entergram_get_member
entergram_list_members

المحادثات واكتشافها

8 أداة

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

entergram_list_chats
entergram_get_chat
entergram_list_live_chats
entergram_get_live_chat
entergram_list_workspace_chats
entergram_get_workspace_chat
entergram_update_workspace_chat
entergram_get_chat_management

الرسائل

9 أداة

قراءة سجل الرسائل والكتابة فيه، بما في ذلك التعديل وإعادة التوجيه والتفاعلات. الإرسال محصور بكل حساب على حدة، فلا شيء يسري عامًا على جميع حساباتك المرتبطة.

entergram_list_messages
entergram_get_message
entergram_send_message
entergram_send_media_message
entergram_edit_message
entergram_delete_message
entergram_forward_messages
entergram_get_message_reactions
entergram_set_message_reactions

جهات الاتصال

3 أداة

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

entergram_list_contacts
entergram_get_contact
entergram_list_contact_shared_groups

التذاكر

10 أداة

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

entergram_list_tickets
entergram_get_ticket
entergram_create_ticket
entergram_update_ticket
entergram_delete_ticket
entergram_list_chat_tickets
entergram_list_ticket_comments
entergram_create_ticket_comment
entergram_update_ticket_comment
entergram_delete_ticket_comment

حقول CRM المخصصة

11 أداة

مخطط مسار مبيعاتك. اقرأ الأعمدة قبل كتابة القيم — مربعات الاختيار تأخذ قيمًا منطقية، والاختيار المتعدد يأخذ مصفوفات من قيم الخيارات، والتواريخ تأخذ نصوصًا بصيغة ISO 8601.

entergram_list_custom_columns
entergram_get_custom_column
entergram_create_custom_column
entergram_update_custom_column
entergram_delete_custom_column
entergram_list_custom_column_options
entergram_create_custom_column_option
entergram_update_custom_column_option
entergram_delete_custom_column_option
entergram_get_chat_custom_fields
entergram_patch_chat_custom_fields

حقول التذاكر المخصصة

9 أداة

التحكم نفسه بالمخطط في جانب التذاكر — الفئات ودرجات الخطورة ومستويات SLA وكل ما يتابعه مكتب الدعم لديك بعد الحالة والأولوية.

entergram_list_ticket_custom_columns
entergram_get_ticket_custom_column
entergram_create_ticket_custom_column
entergram_update_ticket_custom_column
entergram_delete_ticket_custom_column
entergram_list_ticket_custom_column_options
entergram_create_ticket_custom_column_option
entergram_update_ticket_custom_column_option
entergram_delete_ticket_custom_column_option

الملاحظات الداخلية

4 أداة

تعليقات على محادثة لا يراها عميلك أبدًا. مفيدة كي يترك عميل الذكاء الاصطناعي تحليله خلفه ليكمل زميل بشري من حيث انتهى.

entergram_list_chat_comments
entergram_create_chat_comment
entergram_update_chat_comment
entergram_delete_chat_comment

المجموعات والقنوات

11 أداة

إنشاء مجموعات تيليجرام وقنواتها وإدارتها — العضوية والصلاحيات والخصوصية والمعلومات — إضافةً إلى منفذ لتنفيذ أمر خام لما تبقّى.

entergram_list_groups
entergram_get_group
entergram_list_group_members
entergram_create_group_chat
entergram_create_channel
entergram_invite_chat_members
entergram_remove_chat_member
entergram_update_chat_info
entergram_update_chat_permissions
entergram_update_chat_privacy
entergram_run_chat_command

أنت تمنح الإذن لسير عمل، لا لشخص

بيانات الاعتماد التي تنشئها في n8n تظل تعمل بعد إغلاق تبويب المتصفح بوقت طويل، وهذا هو المقصود منها وهذا هو خطرها في آنٍ واحد. فاحسم من البداية هل تتصرّف هذه الوصلة بصفة عضو واحد أم بصفة مساحة العمل كلها، لأن التشغيلات غير المراقَبة ستظل تمارس ما منحتَه لها. أما بيانات جلسة تيليجرام فتبقى داخل Entergram؛ ولا يحمل n8n سوى رمز OAuth.

الوكيل الشخصي: متاح لأي عضو في مساحة العمل. يقرأ مساحة العمل والحسابات وجهات الاتصال والمحادثات والرسائل والتذاكر، ويقرأ ويكتب الحقول المخصصة على المحادثات التي تخصّك. سير عمل للتقارير أو للتنبيهات لا يحتاج أكثر من ذلك، وبيانات اعتماد لا تستطيع الإرسال هي بيانات اعتماد لا تستطيع إحراجك عند الثالثة فجرًا.
موصِّل مساحة العمل: محصور بالمالكين والمشرفين. هذه هي الدرجة التي يحتاجها سير عمل يرسل — رسائل صادرة، وكتابة على الحقول المخصصة لأي محادثة، وإدارة المجموعات — وهي مشتركة مع الفريق، فيستطيع زميل صيانة الأتمتة دون إعادة إنشاء بيانات الاعتماد باسمه. واحتفظ بمسارات الإرسال في مشروع منفصل عن مسارات التقارير كي لا تكون بيانات الاعتماد القوية ملحقة بكل شيء افتراضيًا.
إلغاء الوصول: أوقف الرمز من Settings → Workspace → Connectors → MCP وسيبدأ كل تنفيذ مجدول بالفشل عند استدعائه التالي بدل أن يمضي بصمت. وحذف بيانات الاعتماد داخل n8n يعطي الأثر نفسه من الاتجاه المقابل. ألغِ الوصول قبل إنهاء خدمة من بنى سير العمل، لا بعدها.

قيود تصمّم مساراتك حولها

لا شيء منها يوقفك، لكن كل واحد يغيّر طريقة بنائك لرسم عقد يعمل دون إشراف.

الوصول عبر MCP يقع على خطة Pro. تُمنح بيانات الاعتماد الإذن على أي باقة، فيظهر الخلل لاحقًا كأخطاء أدوات داخل تنفيذ مجدول بدل أن يظهر وقت الإعداد.
MCP طلب واستجابة لا قناة دفع. لا يفتح Entergram مقبسًا نحو n8n، فالإحساس بالعمل المدفوع بالأحداث يأتي من مُطلِق مجدول يستطلع بوتيرة كافية — والمقايضة بين زمن الاستجابة وعدد التنفيذات.
لا أحد يوافق على الإرسال نيابةً عنك. في عميل الدردشة يقرأ إنسان كل مسودة قبل خروجها؛ أما مهمة cron فلا، فعامِل فروع الإرسال معاملة كود الإنتاج واحجزها خلف مرشّحات صريحة وخلف مفتاح وضع اختبار.
لا توجد نقطة نهاية للدفعات. البث إلى ثلاثين محادثة يعني ثلاثين استدعاءً منفصلًا، فأمهِل الحلقة، وقيّد إعادات المحاولة، وتوقّع أن يكون سقفك هو التحكم بالتدفق في تيليجرام نفسه لا سير العمل.
التشغيل الفاشل ليس ذرّيًا. إن ماتت عملية تنفيذ في منتصف حلقة، تبقى عمليات الإرسال وكتابة الحقول التي تمّت كما هي — فابنِ سير العمل ليكون قابلًا للتكرار دون أثر جانبي، وسجّل ما عالجه بدل افتراض تراجع نظيف.
الرموز تنتهي صلاحيتها. أتمتة عملت أسابيع قد تتوقف بين ليلة وضحاها لأن أحدًا لم يجدّد الموافقة، فأضف فرع خطأ ينبّه إنسانًا بدل أن يفشل في سجلّ لا يقرأه أحد.

حل مشكلات موصِّل n8n

تكتمل OAuth لكنها تعيد التوجيه إلى localhost

نسخة مستضافة ذاتيًا لا تعرف عنوانها العام ترسل الاستدعاء الراجع إلى نفسها. اضبط متغيرات المضيف والبروتوكول والـ webhook على العنوان الذي يستخدمه متصفحك فعلًا، وأعد تشغيل n8n، ثم احذف بيانات الاعتماد وأنشئها من جديد — فالقديمة تحتفظ بعنوان إعادة التوجيه القديم مخبوزًا فيها.

العقدة تتصل لكنها لا تعرض أي أدوات

يخزّن n8n بيان الأدوات مؤقتًا لحظة إنشاء بيانات الاعتماد. أعد فتح العقدة وحدّث قائمة الأدوات، أو انسخ العقدة مرة واحدة؛ فسير عمل حُفظ قبل تحميل البيان سيظل يشير إلى مجموعة فارغة.

عقد القراءة تعمل وعقد الإرسال تعود بخطأ 403

هذا وكيل شخصي يفعل تمامًا ما هو مخوّل به. فالإرسال الصادر يخصّ موصِّل مساحة العمل الذي يجب أن ينشئه مالك أو مشرف — وإعادة منح الإذن لبيانات الاعتماد الشخصية نفسها لن توسّعها. وإن أصاب الخطأ 403 عقد القراءة أيضًا فراجع الخطة بدل ذلك: الوصول عبر MCP يتطلب Pro.

سير العمل ينشر في حساب تيليجرام الخطأ

كل أداة رسائل تأخذ account_id صريحًا، وتركه دون تحديد يعني أن النظام حلّه نيابةً عنك. استدعِ قائمة الحسابات مرة واحدة في رأس سير العمل، وثبّت المعرّف الذي تريده كمتغيّر لسير العمل، وأشِر إليه في كل عقدة تالية.

جدول عمل أسابيع يفشل فجأة

السبب غالبًا رمز منتهي الصلاحية. افتح بيانات الاعتماد، وأعد الاتصال، ووافق على الوصول من جديد، فتستأنف التنفيذات المعلّقة عند النبضة التالية. وصِل مخرج الخطأ في عقدة MCP بإشعار كي لا يكتشف العميلُ انتهاءَ الصلاحية القادم قبلك.

التنفيذات تتجاوز المهلة عند سحب رسائل كثيرة

قراءة السجل الكامل لمئات المحادثات في عقدة واحدة تتجاوز مهلة التنفيذ. جزّئ قائمة المحادثات بعقدة Loop Over Items، وحدّد حجم الدفعة، واحفظ مؤشّرًا ليلتقط كل تشغيل من حيث توقّف سابقه. والتعبئة التاريخية ينبغي أن تكون سير عمل منفصلًا عن السير التزايدي الذي يعمل كل ساعة.

أسئلة شائعة: n8n + تيليجرام

هل يستبدل هذا عقدة Telegram في n8n؟

بل يكمّلها. تستخدم عقدة Telegram الأصلية رمز بوت؛ أما Entergram فيربط حسابك الشخصي الحقيقي عبر MCP، فتستطيع الأتمتة على محادثات لا يراها البوت.

n8n مستضاف ذاتيًا أم سحابي؟

كلاهما. أي نسخة n8n تحتوي عقدة MCP تستطيع الاتصال بعنوان MCP المُستضاف الخاص بـ Entergram عبر OAuth.

هل يستطيع تنبيهي بالرسائل الفائتة؟

نعم. ابنِ سير عمل يقرأ المحادثات غير المُجابة وفق جدول زمني ويرسل لك ملخصًا أو تذكيرًا حيثما تريد.

هل هو آمن؟

نعم. OAuth 2.0 بصلاحيات محددة النطاق؛ تبقى البيانات السرية داخل Entergram والوصول قابل للإلغاء في أي وقت.

موصّلات أخرى

يعمل Entergram مع أي أداة ذكاء اصطناعي متوافقة مع MCP.