n8n
n8n أداة لأتمتة مسارات العمل يمكنك استخدامها سحابيًا أو استضافتها على خادمك. تمنحك عقدة Resool المجتمعية في n8n (n8n-nodes-resool) عقدة Resool Trigger التي تبدأ مسارات العمل عند عشرة أحداث في مساحة العمل، وعقدة Resool للتعامل مع جهات الاتصال والرسائل والتذاكر والمهام والمحادثات. ويمكن أيضًا استخدام عقدة Resool كأداة لعقدة AI Agent في n8n، فيستطيع سير عمل بالذكاء الاصطناعي البحث عن جهات الاتصال أو إرسال الرسائل في Resool.
ما يمكنك فعله مع n8n
عقدة Resool Trigger — تبدأ سير العمل عند أحد هذه الأحداث:
| الحدث | يبدأ عندما |
|---|---|
| Contact Created | تُنشأ جهة اتصال. |
| Contact Tag Added | يُضاف وسم إلى جهة اتصال. |
| Conversation Created | تبدأ محادثة جديدة. |
| Conversation Assigned | تُسند محادثة. |
| Conversation Closed | تُغلق محادثة. |
| Message Received | تصل رسالة من العميل. |
| Ticket Created | تُنشأ تذكرة. |
| Ticket Updated | تتغير تذكرة. |
| Task Created | تُنشأ مهمة. |
| Task Completed | تُنجز مهمة. |
فعّل Output Only Data لتخرج العقدة حقل data من الحدث فقط بدل الحدث كاملًا (id وtype وcreatedAt وdata).
عقدة Resool — العمليات حسب المورد:
| المورد | العمليات |
|---|---|
| Contact | Create، وCreate or Update (المطابقة بالبريد أو الهاتف)، وGet، وGet Many (بحث بالاسم أو البريد أو الهاتف)، وUpdate، وAdd Tag (وسم موجود أو بالاسم فيُنشأ إن لم يوجد)، وRemove Tag |
| Message | Send to Contact (في آخر محادثة لجهة الاتصال)، وSend to Conversation (رسالة أو ملاحظة داخلية) |
| Ticket | Create، وGet، وGet Many، وUpdate |
| Task | Create، وGet Many، وUpdate |
| Conversation | Get Many (تصفية حسب الحالة)، وUpdate (الحالة، المسؤول، الفريق) |
تُحمَّل القوائم المنسدلة للوسوم والأعضاء والمشاريع من مساحة عملك.
قبل أن تبدأ
- تحتاج إلى n8n Cloud أو n8n مستضاف ذاتيًا يمكنك تثبيت عقد المجتمع عليه.
- اتصل بحساب عضو في Resool يسمح دوره بما تفعله مسارات العمل. تحتاج عقدة Resool Trigger إلى مالك أو مسؤول، لأنها تشترك في أحداث مساحة العمل.
كيفية تثبيت عقدة Resool
- في n8n انتقل إلى Settings › Community nodes وانقر Install.
- أدخل
n8n-nodes-resool، ووافق على التنبيه، وانقر Install.
في n8n المستضاف ذاتيًا يمكنك أيضًا تشغيل npm install n8n-nodes-resool داخل ~/.n8n/nodes ثم إعادة تشغيل n8n.
كيفية ربط Resool بـ n8n
- أضف عقدة Resool أو Resool Trigger إلى سير عمل.
- تحت Credential أنشئ بيانات اعتماد جديدة من نوع Resool OAuth2 API.
- إن طلب n8n Client ID وClient Secret (غالبًا في n8n المستضاف ذاتيًا)، تواصل مع دعم Resool للحصول عليهما. اترك Base URL كما هو.
- انقر Connect my account. تفتح صفحة من Resool بعنوان ربط n8n بـ Resool.
- اختر مساحة العمل وانقر سماح.
n8n › سير عمل › عقدة Resool › Credential › Create new (Resool OAuth2 API)
بيانات اعتماد "Resool OAuth2 API" مع حقل Base URL وزر Connect my account بعد نجاح الاتصال (عبارة "Account connected" باللون الأخضر).
الملف: screenshots/ar/n8n-credential.png
صفحة التفويض في Resool المفتوحة من n8n
صفحة Resool "ربط n8n بـ Resool" ومنتقي مساحة العمل، وقائمة "سيتمكن من:"، وزرَّا سماح ورفض.
الملف: screenshots/ar/n8n-consent.png
كيفية بدء سير عمل من حدث في Resool
- أضف عقدة Resool Trigger واختر Event، مثل Message Received.
- انقر Test step (أو انتظر حدثًا تجريبيًا) وأرسل رسالة إلى إحدى قنواتك.
- أضف العقد التالية وفعّل سير العمل.
عند تفعيل سير العمل يسجّل Resool المشغّل، وعند إيقافه يُزال الاشتراك. وأثناء التفعيل يظهر في صفحة Webhooks في Resool مع عبارة أُضيفت عبر الواجهة البرمجية.
n8n › محرر سير العمل مع Resool Trigger
سير عمل يبدأ بعقدة "Resool Trigger" (Event: Message Received) تليها عقدة IF ثم عقدة Resool "Send to Contact"، مع لوحة مخرجات المشغّل تعرض id وtype وcreatedAt وdata.
الملف: screenshots/ar/n8n-trigger.png
كيفية استخدام عقدة Resool
- أضف عقدة Resool واختر Resource وOperation، مثل Message › Send to Contact.
- اختر جهة الاتصال أو اربطها، واكتب الرسالة.
- شغّل العقدة لاختبارها.
لتمكين وكيل ذكاء اصطناعي من استخدام Resool، أضف عقدة Resool كأداة لعقدة AI Agent في n8n.
كيفية إلغاء ربط n8n
- أوقف سير العمل لإزالة اشتراك Resool Trigger.
- احذف بيانات اعتماد Resool OAuth2 API في n8n لإزالة الوصول بالكامل.
الأسئلة الشائعة وحل المشكلات
لا تستقبل عقدة Resool Trigger أي أحداث
ما يمكنك فعله:
- تأكد أن سير العمل مفعّل. مستمع الاختبار يعمل فقط أثناء الانتظار.
- يجب أن يكون n8n الخاص بك متاحًا من الإنترنت عبر
httpsليتمكن Resool من إرسال الأحداث. - أعد ربط بيانات الاعتماد بحساب مالك أو مسؤول.
- في صفحة Webhooks في Resool، تأكد أن نقطة الاستقبال ليست أُوقفت بعد تكرار الفشل.
يقول n8n إن الخطة لا تشمل الواجهة البرمجية
يتصل n8n عبر الواجهة البرمجية لـ Resool، وهي جزء من خطة التوسع (Scale). يستطيع المالك الترقية من الإعدادات › الفوترة والاستخدام.
من أين أحصل على Client ID وClient Secret؟
تطلبهما بعض إعدادات n8n فقط، وغالبًا n8n المستضاف ذاتيًا. تواصل مع دعم Resool وسنرسل لك بيانات عميل n8n.
يفشل إجراء Send to Contact
تُرسل الرسالة إلى آخر محادثة لجهة الاتصال، لذا يجب أن تكون لها محادثة واحدة على الأقل. وعلى واتساب لا يمكن إرسال رسالة حرة إلا خلال 24 ساعة من آخر رسالة من العميل.