n8n

• 1. افتح لوحة العقد. في سير عمل، انقر «+» وابحث عن «Sofia».
• 2. ثبّت العقدة. اختر Sofia ثم «Install node». يثبّتها مالك النسخة مرة واحدة لكل الأعضاء.
• 3. أو ثبّت الحزمة. على نسخة مستضافة ذاتيًا، افتح «Settings › Community nodes › Install» وأدخل اسم الحزمة n8n-nodes-sofia-post.

• 1. أنشئ مفتاحًا شخصيًا. في الإعدادات، صفحة «Sofia API»، تبويب «الوصول الشخصي»، «مفتاح جديد». يُعرض مرة واحدة فقط.
• 2. أنشئ بيانات الاعتماد في n8n. أضف بيانات اعتماد «Sofia API» والصق المفتاح في الحقل «Personal Key» (sofia_pk_live_…). اترك «API URL» كما هو؛ يختبر n8n المفتاح بـ GET /v1/me.
• 3. استخدمها في سير عمل. تصل بيانات اعتماد واحدة إلى كل منشآتك، بصلاحياتك.

تمتلئ قائمتا «Establishment» و«Accounts» من منشآتك وحساباتك المرتبطة. اترك «Schedule At» فارغًا لتنشر الآن؛ ويُقرأ التاريخ بالمنطقة الزمنية لسير العمل. «Draft» يحفظ المنشور دون نشره. الحقل غير المتسق (مسودة مؤرخة، عنوان وسائط ناقص) يُرفض قبل إنشاء المنشور.

• 1. أنشئ المنشور. أضف عقدة «Sofia» على «Post › Create»، واختر منشأة وحساباتها، واكتب النص، ثم أضف «Media URLs» و«Schedule At» ضمن «Additional Fields».
• 2. اقرأ حالته. أضف عقدة «Sofia» ثانية على «Post › Get» وأعطها id الذي أعادته الخطوة السابقة. بعد صدور المنشور تكون قيمة status هي published أو partial أو failed، مع الرابط وردّ كل شبكة.
• 3. تصرّف عند الفشل. شغّل سير عمل آخر بعقدة «Sofia Trigger» على «Post Failed»، واربطها بعقدة Slack أو بريد إلكتروني مع الرسالة أدناه.

{{ $json.platforms }}: {{ $json.errors }}

يستطلع المشغّل Sofia. يبدأ بالمنشورات التي تظهر بعد تفعيل سير العمل: المنشورات السابقة لا تُعاد. «Fetch Test Event» يعرض أحدث منشور لتربط حقوله، واختيار منشأة يجعله يراقب تلك المنشأة وحدها.

• 401: لم يعد المفتاح صالحًا، أنشئ مفتاحًا جديدًا والصقه في بيانات الاعتماد نفسها.
• 429: استدعاءات كثيرة جدًا؛ يذكر الخطأ عدد الثواني التي تنتظرها قبل إعادة المحاولة.
• أي رفض آخر: يظهر خطأ Sofia مع رمزه في n8n. مع «Continue On Fail»، يصبح العنصر المرفوض عنصر error بدل أن يوقف سير العمل.

استخدم n8n حين تكون أتمتتك قائمة فيه أصلًا. وفضّل Zapier إن كانت أدواتك تتصل به، وwebhooks أو Sofia API حين تكتب شيفرة.