الأتمتة باستخدام n8n

n8n أداة لأتمتة سير العمل. وبعُقد إس تي إس كونكت الخاصة بـ n8n يمكنك تشغيل سير عمل عند وصول رسالة إلى صندوق الوارد، وإرسال الرسائل وتحديث المحادثات وحفظ جهات الاتصال من أي سير عمل.

ما تحتاج إليه

• نسخة n8n مستضافة ذاتيًا (يثبّت مالكُ النسخة العُقدَ المجتمعية)، يمكن الوصول إليها من الإنترنت عبر HTTPS ليتمكن صندوق الوارد من إرسال الويبهوك إليها.
• حساب مسؤول في صندوق الوارد إس تي إس كونكت.

ثبّت العُقد

1. في n8n افتح Settings → Community Nodes → Install (الإعدادات ← العُقد المجتمعية ← تثبيت).
2. أدخل n8n-nodes-stsconnect ثم أكّد.

تظهر عقدتان: STS Connect (لإرسال الرسائل وإدارة المحادثات وجهات الاتصال وقراءة صناديق الوارد والوسوم والفرق والموظفين)، وSTS Connect Trigger (لتشغيل سير العمل عند أحداث صندوق الوارد).

أنشئ مفتاحًا للواجهة البرمجية

1. في صندوق الوارد افتح الإعدادات ← الواجهة البرمجية والويبهوك وأنشئ مفتاحًا.
2. اختر قراءة إن كان سير العمل يقرأ البيانات فقط، أو قراءة وكتابة إن كان يرسل الرسائل أو يعدّل المحادثات وجهات الاتصال.
3. انسخ المفتاح فورًا، فهو لا يظهر إلا مرة واحدة.

في n8n أنشئ بيانات اعتماد من نوع STS Connect API بالمفتاح وAccount ID (معرّف الحساب، وهو الرقم الظاهر في عنوان صندوق الوارد بعد /app/accounts/). اترك عنوان الخادم كما هو.

شغّل سير عمل عند وصول رسائل جديدة

1. أضف عقدة STS Connect Trigger، واختر الأحداث التي تريدها، ثم فعّل سير العمل. وإن كان سير العمل يرسل ردودًا، ففعّل Options → Only Incoming Messages (الرسائل الواردة فقط)، وإلا فستعيد ردودك تشغيل سير العمل.
2. انسخ Production URL (رابط الإنتاج) من العقدة، فرابط الاختبار لا يعمل إلا أثناء الاختبار في المحرر.
3. في صندوق الوارد افتح الإعدادات ← الواجهة البرمجية والويبهوك ← الويبهوك ← إضافة ويبهوك، والصق الرابط، واختر الأحداث نفسها.
4. اضغط إظهار السر في الويبهوك الجديد، والصق السر في بيانات اعتماد STS Connect Webhook في العقدة.

كل إرسال موقَّع. ويُرفض كل إرسال توقيعه غير صحيح أو مضى عليه أكثر من 5 دقائق قبل أن يصل إلى سير العمل.

ملاحظات

• يعمل المفتاح باسم حسابك، لا باسم شخص بعينه. احذفه من الواجهة البرمجية والويبهوك حين تستغني عن سير العمل.
• مفتاح القراءة لا يرسل الرسائل، فتفشل هذه الطلبات برمز 403.
• الشيفرة المصدرية للعُقد ومرجعها الكامل منشوران على GitHub.