نشر المنشورات على لينكد إن من خلال زاكي بوست

يتيح زاكي بوست ربط حساب لينكد إن الخاص بك، سواء كان ملفك الشخصي أو صفحة شركتك على لينكد إن (LinkedIn Company Page)، ونشر المحتوى إليه بشكل تلقائي عبر واجهة برمجة التطبيقات API. سواء كنت تبحث عن أتمتة نشر المنشورات النصية، أو جدولة الصور والفيديوهات على لينكد إن، أو ربط لينكد إن بأنظمة إدارة المحتوى الخاصة بك، فإن تكامل لينكد إن مع زاكي بوست يمنحك الأدوات اللازمة لتنفيذ ذلك برمجيًا ودون أي تدخل يدوي متكرر.

آلية العمل بسيطة وآمنة: كل ما يتطلبه الأمر هو ربط حساب لينكد إن بمنصتنا عبر شاشة الموافقة الرسمية الخاصة بلينكد إن (LinkedIn OAuth). بمجرد إتمام هذه الخطوة، ستحصل فورًا على مفاتيح وصول برمجية مخصصة لحسابك، تمنحك القدرة الكاملة على أتمتة النشر على ملفك الشخصي، أو على صفحة شركتك إن كانت مرتبطة، مباشرة من أي بيئة تطوير أو أداة برمجية تفضلها.

1. آلية العمل من ناحية المستخدم

تتلخص عملية ربط لينكد إن ونشر المحتوى عليه في ثلاث خطوات رئيسية:

1. الحصول على مفتاحي الوصول الخاصين بالحساب (client_key و client_secret) من صفحة إعدادات مفاتيح API.
2. ربط حساب لينكد إن من خلال زر "ربط حساب LinkedIn"، وهي الخطوة الوحيدة التي يمر فيها المستخدم بشاشة الموافقة الرسمية لينكد إن، مع تحديد ما إذا كان الربط سيشمل صلاحيات النشر على صفحة الشركة أم الاقتصار على الملف الشخصي فقط.
3. استخدام مفتاحي الوصول مع معرّف الحساب الذي تم ربطه (linkedin_account_id) لإرسال طلبات النشر من أي بيئة برمجية تدعم إرسال طلبات HTTP، مع تحديد الوجهة المطلوبة: الملف الشخصي، صفحة الشركة، أو الاثنان معًا.

بعد إتمام هذه الخطوات، تتولى منصة زاكي بوست التفاصيل التقنية المرتبطة بالتعامل مع لينكد إن: تجديد التوكنات، تخزينها بشكل مشفّر، إرسال طلب النشر الفعلي إلى الوجهة الصحيحة (ملف شخصي أو صفحة شركة)، والتحقق من نتيجته بعد إرساله.

2. مفاتيح API الخاصة بالحساب

عند إنشاء الحساب في زاكي بوست، يتم توليد مفتاحين تلقائيًا وربطهما بشكل دائم بالحساب:

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

هذان المفتاحان لا علاقة لهما بحساب لينكد إن ذاته، وإنما هما وسيلة المصادقة بين المستخدم وخادم زاكي بوست. يجب إرسالهما مع كل طلب نشر عبر ترويستي HTTP التاليتين:

X-ZakiPost-Client-Key: zp_key_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
X-ZakiPost-Client-Secret: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

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

3. ربط حساب لينكد إن (الملف الشخصي وصفحة الشركة)

يوفّر زاكي بوست زر "ربط حساب LinkedIn" داخل لوحة التحكم، وعند النقر عليه يتم تنفيذ التسلسل التالي:

1. توليد رمز حماية عشوائي (state) يُحفظ مؤقتًا لمنع محاولات التزوير عبر الطلبات.
2. إعادة توجيه المستخدم إلى شاشة الموافقة الرسمية الخاصة بلينكد إن، حيث يمكنه اختيار منح صلاحيات النشر على الملف الشخصي فقط، أو منح صلاحيات إضافية لإدارة صفحة شركة يمتلك صلاحيات إدارية عليها.
3. بعد موافقة المستخدم، يُعاد توجيهه إلى زاكي بوست التي تتحقق من صحة الطلب وتستبدل كود التفويض بتوكن وصول صالح.
4. يتم تشفير التوكن وتخزينه بأمان، ولا يُعرض في أي وقت للمستخدم أو لأي طرف آخر.
5. يُولَّد معرّف داخلي خاص بهذا الحساب (linkedin_account_id) يُستخدم لاحقًا عند إرسال طلبات النشر إلى الملف الشخصي و/أو صفحة الشركة.

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

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

4. نشر محتوى عبر API

تستقبل نقطة الوصول الخاصة بالنشر طلبات POST بالصيغة التالية، وتدعم نشر النصوص، الصور، والفيديوهات، إلى الملف الشخصي أو صفحة الشركة أو كليهما معًا:

POST https://api.zakipost.com/v1/linkedin/publish
Content-Type: application/json
X-ZakiPost-Client-Key: zp_key_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
X-ZakiPost-Client-Secret: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

{
  "content": "نص المنشور هنا",
  "linkedin_account_id": "internal-token-uuid",
  "publish_to_profile": true,
  "publish_to_organization": false,
  "images": ["https://example.com/image1.jpg"],
  "video_url": "https://example.com/video.mp4"
}

شرح الحقول

ملاحظة: يتم إعطاء الأولوية للـ video_url إذا تم تمرير كلا من images وvideo_url في نفس الطلب. إذا كان video_url فارغًا، سيتم استخدام images. وإذا كان كلاهما فارغًا، سيتم نشر content كنص فقط. كذلك يمكن تفعيل publish_to_profile وpublish_to_organization معًا في نفس الطلب لنشر المحتوى على الوجهتين دفعة واحدة.

الاستجابة عند النجاح

{
  "success": true,
  "message": "Published successfully...",
  "data": {
    "post_url": "رابط المنشور إن توفر"
  }
}

5. الأخطاء الشائعة ومعانيها

6. التكاليف وحدود الاستخدام

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

7. ملخص سريع