تخطَّ إلى المحتوى

أتمتة شارك بـ n8n

يربط n8n شارك بكل ما تشغله سواه. فصف جديد في جدول بيانات يصير منشورًا مجدولًا؛ وعنصر RSS يصير مسودة يراجعها فريقك. بلا كود، وبلا سكربت استطلاع تبقيه يعمل.

وينشر شارك عقدة n8n خاصة به، فيصير هذا على n8n المستضاف ذاتيًا بضع نقرات بدل مجموعة عقد HTTP Request تصونها بنفسك.

وكلا الطريقين يستخدم مفتاح API الخاص بك في شارك. ليست ضمن كل الخطط. لا يظهر تبويب المطورون، حيث المفتاح، إلا حين تتضمن خطتك واجهة API العامة. راجع الأسعار.

  1. في n8n، افتح Settings، ثم Community nodes، واختر Install. وإن لم تكن أي عقدة مجتمع مثبتة بعد، فالزر يحمل اسم Install a community node.

  2. أدخل اسم الحزمة:

    n8n-nodes-sharek
  3. حدد I understand the risks of installing unverified code from a public source، ثم اختر Install. عندها تظهر عقدة اسمها Sharek في لوحة العقد.

لا يستطيع n8n Cloud تثبيت عقدة شارك بعد، لكن عقدة HTTP Request المدمجة فيه تستطيع استدعاء واجهة API العامة مباشرة، بمفتاح API نفسه.

  1. أضف عقدة HTTP Request. وتحت Authentication، اختر Generic Credential Type، ثم Header Auth في Generic Auth Type، وأنشئ بيانات اعتماد جديدة.

  2. في بيانات الاعتماد، اضبط Name على Authorization وValue على مفتاح API الخاص بك في شارك، من بطاقة مفتاح API التي تشرحها المصادقة. الصق المفتاح وحده، دون Bearer أمامه.

  3. اضبط Method على GET وURL على العنوان أدناه، ثم نفذ العقدة. فالعقدة ترسل هذا الطلب، والرد {"connected": true} يعني أن المفتاح يعمل:

    GET https://dash.sharek.app/api/public/v1/is-connected
    Authorization: your-api-key
  4. وجه العقدة إلى العملية التي تحتاجها، على عنوانها تحت /public/v1. ولعملية لها جسم طلب، مثل إنشاء منشور، اجعل Send Body مفعلًا، واضبط Specify Body على Using JSON، والصق جسم الطلب من تلك الصفحة.

  1. أضف عقدة Sharek إلى سير عمل وأنشئ بيانات اعتماد Sharek API جديدة.

  2. في حقل API Key، الصق مفتاح API الخاص بك في شارك. خذه من الإعدادات، ثم المطورون، ثم بطاقة مفتاح API في شارك، كما تشرح المصادقة. الصق المفتاح وحده، دون Bearer أمامه.

  3. اترك Host كما هو. فهو يشير إلى المكان الصحيح بالفعل:

    https://dash.sharek.app/api
  4. احفظ. يختبر n8n بيانات الاعتماد وهو يحفظها، باستدعاء GET https://dash.sharek.app/api/public/v1/is-connected. والاختبار الأخضر يعني أن المفتاح يعمل.

سبع عمليات:

العملية ما الذي تفعله
Get Channels تسرد قنواتك المربوطة بمعرفاتها
Create Post تنشئ مسودة منشور أو تجدوله أو تنشره، إلى قناة أو أكثر
Get Posts تسرد المنشورات في مدى تواريخ، ولعلامة تجارية واحدة اختياريًا (حقل Customer يأخذ معرفها)
Delete Post تحذف منشورًا بمعرفه
Upload File تضع وسائط في مكتبتك وتعيد مرجعها
Generate Video تولد فيديو
Video Function تجلب القيم التي يحتاجها مولد الفيديو أولًا

وكل واحدة منها تستدعي عملية واحدة في واجهة API العامة: Get Channels هي سرد القنوات، وCreate Post هي إنشاء منشور، وGet Posts هي سرد المنشورات، وDelete Post هي حذف منشور، وUpload File هي رفع ملف، وGenerate Video هي توليد فيديو، وVideo Function هي دوال مزودي الفيديو. وتلك الصفحات هي التفصيل خلف كل واحدة.

وتعمل العقدة أيضًا أداة لعقدة AI Agent في n8n. اربطها ضمن أدوات الوكيل، فيشغل الوكيل هذه العمليات بنفسه، كأن يجدول منشورًا كتبه للتو.

أقصر سير عمل مفيد هو عقدتان.

  1. أضف عقدة Sharek واضبط العملية على Get Channels. نفذها. تستعيد قنواتك بمعرفاتها، وهو ما يؤكد أن بيانات الاعتماد تعمل ويعطيك المعرف للخطوة التالية.

  2. أضف عقدة Sharek ثانية مضبوطة على Create Post. اضبط Type على Schedule، وضع تاريخًا مستقبليًا بصيغة ISO 8601 في Date، ثم أضف مدخلًا واحدًا تحت Posts: معرف القناة من الخطوة 1، ومحتواك.

  3. نفذ سير العمل، ثم افتح التقويم في شارك. ستجد المنشور هناك.

وبقية حقول Create Post:

  • Short Link معطل افتراضيًا. اجعله مفعلًا لتستبدل بالروابط في محتواك روابط شارك المختصرة، كي يحسب شارك النقرات.
  • Tags موضعه في Create Post نفسها، فالوسوم نفسها تغطي الطلب كله. أما Group فموضعه داخل كل مدخل تحت Posts، فاتركه فارغًا للمنشور الجديد. فالقيمة فيه تسمي مجموعة منشور موجود، فيستبدل ذلك المنشور ويحذف القديم، كما عبر API. ويعطي شارك كل منشور جديد مجموعة خاصة به.
  • كل مدخل تحت Settings في المنشور له Key وValue Type وقيمة. وValue Type هو String ما لم تغيره إلى Number أو Boolean أو JSON؛ فاختر ما يتوقعه الإعداد، وJSON للكائن أو القائمة.

وبمجرد نجاح ذلك، ضع مكان المشغل اليدوي ما ينبغي أن يبدأ سير العمل فعلًا: جدول زمني، أو Webhook، أو صف جديد، أو عنصر RSS جديد.

الوسائط لا بد أن تكون في شارك قبل أن يستخدمها منشور، فضع خطوة Upload File قبل المنشور.

وUpload File تقرأ بيانات ثنائية من العنصر الوارد لا من مسار، وحقل Binary Property يسمي أيها تقرأ، وهو data عادةً. ومن ثم فالخطوة التي قبلها لا بد أن تنتج بيانات ثنائية: عقدة HTTP Request تنزل الصورة، أو عقدة Read/Write Files from Disk، أو ما يوفره مشغلك أصلًا.

خذ id وpath اللذين يعيدهما الرفع إلى مدخل Images في المنشور، في حقلي ID وPath. ويجب أن ينتهي المسار بـ .png أو .jpg أو .jpeg أو .gif أو .webp أو .mp4، وإلا رفض Create Post، كما عبر API. أما مسار على جهازك فلا يعمل أبدًا، لأن شارك لا ينشر إلا وسائط يستطيع جلبها.

  • فشل اختبار بيانات الاعتماد. افحص المفتاح أولًا. وإن غيرت Host، فينبغي أن ينتهي عند /api بلا /public/v1 وبلا شرطة مائلة في آخره.
  • 401 على كل عملية. يذكر msg في الرد السبب: مفتاح خاطئ أو جرى تدويره، أو مفتاح لصق مع Bearer، أو مؤسسة بلا اشتراك فعال. وتسرد المصادقة كلًا منها. راجع المفتاح مقابل بطاقة مفتاح API.
  • خطأ في Upload File بشأن البيانات الثنائية. العنصر الوارد بلا بيانات ثنائية، أو اسم Binary Property لا يطابق ما أنتجته العقدة السابقة.
  • رفض Create Post. إعداد منصة ناقص لتلك القناة. وصفحة إعدادات كل قناة مرتبطة من القنوات التي يوفرها شارك.
  • تنشر المنشورات في وقت خاطئ، أو فورًا. يقرأ Date بتوقيت UTC إن لم يحمل فرق توقيت، والتاريخ الماضي ينشر في الحال. وإن لم ينشر المنشور أبدًا، فتأكد أن Type ليس Draft.