تكامل واجهة API للأعمال

يتكون جزء مهم من تكامل Business Plan أو Launch Plan من إنشاء حسابات ملفات شخصية جديدة في Ayrshare لمستخدميك أو عملائك والسماح لهم بربط شبكاتهم الاجتماعية عبر صفحة الربط الاجتماعي. يتم إعداد كل مستخدم لديك كملف مستخدم Ayrshare. يحصل ملف المستخدم على اتصال واحد بكل شبكة تواصل اجتماعي.

هذه هي الطريقة القياسية لتأهيل العملاء. يقوم مستخدموك بربط حسابات التواصل الاجتماعي الخاصة بهم عبر صفحة JWT URL المخصصة بعلامتك التجارية الموضحة أدناه — فهم لا يسجّلون الدخول إلى Ayrshare أبدًا ولا يستخدمون لوحة التحكم الخاصة بك. لوحة التحكم مخصصة لفريقك الداخلي (لإنشاء الملفات وإدارتها والاختبار والنشر بالنيابة عن العميل).

سير عمل التكامل

لدمج Ayrshare في تطبيقك، ستحتاج إلى إجراء استدعاءَي API:

استدعِ نقطة نهاية Create Profiles لإنشاء ملف Ayrshare جديد للمستخدم الخاص بك.
استدعِ نقطة نهاية Generate JWT للحصول على JWT URL.

يسمح JWT URL للمستخدم الخاص بك بالوصول الآمن إلى صفحة الربط الاجتماعي من خلال مصادقة الدخول الموحد (Single Sign-On). ستعرض هذه الصفحة في علامة تبويب أو نافذة أو view controller جديدة للسماح للمستخدمين بربط حسابات التواصل الاجتماعي الخاصة بهم.

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

لأسباب أمنية، تتطلب منصات التواصل الاجتماعي من المستخدمين المصادقة عبر متصفحهم، وهو ما لا يمكن القيام به من خلال استدعاءات الخادم الخلفية. يضمن ذلك أن يتمكن مستخدموك من ربط حسابات التواصل الاجتماعي الخاصة بهم بأمان عن طريق تسجيل الدخول مباشرةً باستخدام صفحة تسجيل الدخول الرسمية لكل منصة. تُقيِّد شبكات التواصل الاجتماعي المصادقة لتحدث فقط عبر نطاقات شركائها المعتمدين، مثل Ayrshare. كما تحجب iFrames، ما يعني أنه لا يمكنك تضمين صفحة ربط Ayrshare أو عرضها داخل iFrame في موقعك.

إنشاء ملف مستخدم Ayrshare

إنشاء ملف باستخدام واجهة API

عند تسجيل مستخدم جديد في نظامك أو عند نقر عميلك على رابط شبكة التواصل الاجتماعي في تطبيقك، أنشئ حساب ملف Ayrshare جديد عن طريق استدعاء نقطة النهاية RESTful الخاصة بـ /profiles/create-profile، أو باستخدام حزم NPM أو PyPi.

Profiles

سيتم إرجاع PROFILE KEY الخاص بالمستخدم من هذا الاستدعاء. سيُستخدم هذا المفتاح للنشر بالنيابة عن المستخدم الخاص بك ولإدارة حسابه. ينبغي أن تخزنه في موقع آمن.

إنشاء ملف باستخدام لوحة التحكم (الفريق الداخلي)

يمكن لفريقك الداخلي أيضًا إنشاء ملفات مستخدمين مباشرةً من Developer Dashboard — وهو مفيد للاختبار، أو لتأهيل ملف يدويًا، أو لإدارة مرة واحدة. هذه أداة للفريق، وليست تدفقًا موجّهًا للعملاء: لن يُمنح عملاؤك أبدًا إمكانية الوصول إلى لوحة التحكم، ويتم دائمًا تأهيلهم عبر صفحة JWT URL للاتصال. للتأهيل في الإنتاج، أنشئ الملفات برمجيًا باستخدام واجهة API بحيث يتم توفير كل مستخدم جديد تلقائيًا.

Manage User Profiles in Dashboard

حزمة التكامل

أثناء تأهيلك كعميل Business Plan أو Launch Plan، تلقيت حزمة تكامل مخصصة تحتوي على معلومات إعداد ونطاق مهمة، وأمثلة على استدعاءات نقاط النهاية، والمزيد. يُرجى التحقق مع صاحب الحساب الأساسي للحصول على هذه المعلومات. يمكنك أيضًا استرداد أو إعادة تعيين حزمة التكامل في لوحة التحكم في صفحة API. تأكد أولًا من التبديل إلى Primary Profile.

الدخول الموحد باستخدام مصادقة JWT

يستخدم Ayrshare JWT (JSON Web Token) للمصادقة على المستخدم الخاص بك وتنفيذ الدخول الموحد إلى صفحة الربط الاجتماعي. JWT هو آلية آمنة لتمرير المعلومات الموقعة رقميًا وتسمح لـ Ayrshare بمصادقتك أنت والمستخدم الخاص بك.

إنشاء JWT

سينشئ تطبيقك JWT مكوّنًا من API Key الخاص بك، وProfile Key للمستخدم، وبعض المعاملات الأخرى. وسيتم توقيع ذلك بمفتاحك الخاص بحجم 1024 بت.

رمز JWT صالح لمدة 5 دقائق. يُرجى الاطلاع على Max Pack للحصول على مدة انتهاء صلاحية أطول.

يُرجى استخدام نقطة نهاية Generate JWT لجعل Ayrshare ينشئ الرمز وعنوان URL للربط الاجتماعي. افتح عنوان URL للربط الاجتماعي في علامة تبويب أو نافذة جديدة، مما يسمح لمستخدميك بـ ربط شبكاتهم الاجتماعية بسهولة.

JWT URL هو مسار التأهيل الموصى به لكل عميل. يُصادِق مستخدموك مباشرةً مع كل شبكة تواصل اجتماعي بأنفسهم — فأنت لا تجمع أو تخزن بيانات اعتمادهم الاجتماعية أبدًا. إذا احتاج فريقك إلى ربط حساب يدويًا أثناء الاختبار، فيمكنك القيام بذلك من لوحة التحكم، ولكن هذا مجرد وسيلة راحة داخلية وليس الطريقة التي ينبغي بها تأهيل العملاء.

تمييز صفحة ربط الحسابات بعلامتك التجارية (White-Label)

نظرًا لأن صفحة الاتصال التي يفتحها JWT URL هي واجهة Ayrshare الوحيدة التي يراها مستخدموك، فينبغي أن تُميّزها بعلامتك التجارية الخاصة. أضف شعارك وترويسات مخصصة، واختر شبكات التواصل الاجتماعي التي تظهر، واضبط لغة الصفحة، واستخدم روابط المساعدة الخاصة بك — ومع Max Pack، طبّق ملف CSS مخصصًا كاملًا، وأيقونة favicon، وعنوان صفحة، وتذييلًا. يتم تكوين هذه الخيارات مرة واحدة من قِبَل فريقك من Primary Profile وتنطبق على كل JWT URL تُنشئه.

White-Label the Connect Accounts Page

اطّلع على كل خيارات العلامة التجارية والتخصيص لصفحة الاتصال.

تسجيل الخروج التلقائي من جلسة ملف

كيفية تسجيل الخروج تلقائيًا من جلسة الملف النشطةإذا كان هناك ملف مُسجَّل الدخول بالفعل، فإن إرسال JWT لملف مختلف لن يبدّل الملفات. يتم ذلك لجعل التجربة أسرع للمستخدمين المُسجَّل دخولهم بالفعل. عند الاختبار، سجّل الخروج من الملف الحالي قبل إجراء استدعاء SSO لملف مختلف. تبقى الملفات المُسجَّل دخولها مُسجَّلة الدخول حتى يتم تسجيل الخروج منها بشكل صريح.ومع ذلك، إذا كان لديك حاجة تجارية، مثل امتلاك مستخدميك عدة ملفات يصلون إليها كثيرًا، أو إذا كنت ترغب في الاختبار، فقم بتضمين معامل URL في SSO URL:logout=trueعلى سبيل المثال:https://profile.ayrshare.com?domain=[domain id]&jwt=[jwt token]&logout=trueيفرض هذا تسجيل الخروج ثم يسجّل الدخول للملف الجديد.يُرجى أيضًا الاطلاع على نقطة نهاية Generate JWT لإضافة تسجيل الخروج تلقائيًا.تحذير: استخدام تسجيل الخروج التلقائي يسبب تأخيرًا في الأداء للمستخدم الخاص بك، لذا ما لم تكن في حاجة إليه، نقترح عدم فرض تسجيل الخروج وعدم استخدامه في الإنتاج.

فتح وإغلاق عنوان URL للربط الاجتماعي

تحتوي صفحة Social Accounts على زر “Close” يُغلق النافذة ويعيد المستخدم إلى موقعك.

فتح عنوان URL للربط الاجتماعي

عند فتح عنوان URL للربط الاجتماعي، نوصي باستخدام دالة window.open() في JavaScript بدلًا من anchor href. يستخدم زر “Close” JavaScript لإغلاق النافذة، ومعظم المتصفحات لا تسمح بإغلاق سوى النوافذ المفتوحة عبر سكربت. يمكنك استخدام رمز العينة التالي في موقعك لإطلاق نافذة الربط الاجتماعي.

Window Open

<div onclick="window.open('https://profile.ayrshare.com?domain...', '_blank')">
  Link Social Networks
</div>

أو

Window Open Function

<button onclick="openNewTabAndRedirect()">Open New Tab and Redirect</button>
<script>
  function openNewTabAndRedirect() {
    // Open a new tab
    var newTab = window.open("https://profile.ayrshare.com?domain...");

    // Optional: Focus on the new tab
    newTab.focus();
  }
</script>

يمكنك التحكم في زر “Close” لإما إعادة توجيه علامة تبويب الربط الاجتماعي إلى صفحة من اختيارك أو إعادة توجيه علامة التبويب/النافذة المُفتِح الأصلية وإغلاق علامة تبويب الربط الاجتماعي. يمكن القيام بذلك باستخدام معامل redirect وإضافة origin=true إلى معاملات الاستعلام في عنوان URL لإعادة التوجيه. يُرجى الاطلاع على نقطة نهاية Generate JWT لمزيد من التفاصيل.

إعادة التوجيه عند الإغلاق

بالإضافة إلى ذلك، إذا كنت تريد أن يقوم زر Close بإعادة التوجيه إلى صفحتك (غالبًا ما يكون مفيدًا على الأجهزة المحمولة)، فمرّر معامل GET المُسمى redirect كسلسلة مُشفَّرة بعنوان URL تبدأ بـ https. يُرجى الاطلاع على معاملات نقطة نهاية Generate JWT لمزيد من التفاصيل.

JWT URL

https://profile.ayrshare.com?domain=[domain id]&jwt=[jwt token]&redirect=https%3A%2F%2Fmywebsite.com

سيتم حفظ إعادة التوجيه لذلك الملف واستخدامها في استدعاءات SSO اللاحقة حتى إذا لم يتم تمرير معامل redirect. لإعادة تعيين زر Close إلى الإغلاق فقط، مرِّر المعامل redirect=null.

مزيد من المعلومات

إشعارات ربط أو فصل المستخدم

عندما يقوم مستخدم بربط أو فصل شبكة تواصل اجتماعي، يمكنك تلقّي إشعار عبر webhook. يُرجى الاطلاع على صفحة Social Action Webhooks لمزيد من المعلومات. يمكنك أيضًا استخدام نقطة نهاية user للحصول على شبكات التواصل الاجتماعي المتصلة بملف مستخدم.

مجموعات متعددة من حسابات التواصل الاجتماعي

نظرة عامة

لكل ملف مستخدم مجموعة من حسابات التواصل الاجتماعي ويمكنه إجراء اتصال واحد بكل شبكة تواصل اجتماعي. إذا كان مستخدموك أو عملاؤك لديهم مجموعات متعددة من حسابات التواصل الاجتماعي، مثل صفحتَي Facebook، وحسابَي Instagram، وقناتَي YouTube، فيمكنك إدارة هذه المجموعات المتعددة من حسابات التواصل الاجتماعي باتباع الخطوات التالية:

إنشاء ملفات مستخدمين متعددة - أنشئ ملفات مستخدمين منفصلة داخل نظام Ayrshare لكل مجموعة من حسابات التواصل الاجتماعي التي يحتاج المستخدم أو العميل إلى إدارتها.
تخزين Profile Keys الفريدة - سيكون لكل ملف مستخدم Profile Key فريد خاص به، يُعاد من نقطة نهاية إنشاء User Profile.
تسمية ملفاتك - عنوِن أو ضع وسمًا لـ كل ملف مستخدم لتحديد بوضوح حسابات التواصل الاجتماعي المرتبطة به (على سبيل المثال، “Facebook Page A” و”Facebook Page B”).
الربط في قاعدة بياناتك - في نظامك الخاص، اربط جميع Profile Keys ذات الصلة بالمستخدم أو العميل المعني.
استخدام Profile Key المناسب - عند نشر المحتوى أو استرداد التحليلات لحساب تواصل اجتماعي معين، استخدم Profile Key المرتبط بذلك الحساب. على سبيل المثال، للنشر على Facebook Page A، استخدم Profile Key الخاص بملف المستخدم المتصل بـ Facebook Page A.

مثال

لنأخذ في الاعتبار سيناريو عمليًا لعدة حسابات عملاء:

العميل: سلسلة مطاعم Joe مع موقعين

يحتاج Joe إلى حسابات تواصل اجتماعي منفصلة لكل موقع مطعم: موقع المطعم 1:

Facebook Page: “Joe’s Downtown Bistro”
Instagram: @joesdowntownbistro
LinkedIn: صفحة أعمال Joe’s Downtown Bistro

موقع المطعم 2:

Facebook Page: “Joe’s Seaside Grill”
Instagram: @joesseasidegrill
LinkedIn: صفحة أعمال Joe’s Seaside Grill

حل التنفيذ:

أنشئ ملفَي مستخدم منفصلين في Ayrshare:

ملف المستخدم 1: بعنوان “Joe’s Downtown Bistro Accounts”
ملف المستخدم 2: بعنوان “Joe’s Seaside Grill Accounts”

اربط حسابات التواصل الاجتماعي المناسبة بكل ملف:

الملف 1: يربط Facebook وInstagram وLinkedIn لـ Downtown Bistro
الملف 2: يربط Facebook وInstagram وLinkedIn لـ Seaside Grill

خزّن كلا Profile Keys في قاعدة بياناتك، مع ربطها بحساب Joe:

Client: Joe's Restaurant Chain
- Profile Key 1: abc123... (Downtown location)
- Profile Key 2: xyz789... (Seaside location)

عند نشر تحديث قائمة طعام خاصة لموقع Downtown، استخدم Profile Key 1 في استدعاءات API. عند النشر عن عرض ترويجي للمأكولات البحرية في موقع Seaside، استخدم Profile Key 2.

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

الخطوات التالية

يُرجى الاطلاع هنا لمزيد من التفاصيل حول تجربة المستخدم:

User Integration

بمجرد أن يقوم المستخدم بإعداد روابط التواصل الاجتماعي الخاصة به، ستتمكن من البدء في النشر بالنيابة عنه باستخدام نقاط النهاية /post و/profile.

Get Started

API Endpoints

Multiple Users

Dashboard

Additional

سير عمل التكامل

إنشاء ملف مستخدم Ayrshare

إنشاء ملف باستخدام واجهة API

Profiles

إنشاء ملف باستخدام لوحة التحكم (الفريق الداخلي)

Manage User Profiles in Dashboard

حزمة التكامل

الدخول الموحد باستخدام مصادقة JWT

إنشاء JWT

تمييز صفحة ربط الحسابات بعلامتك التجارية (White-Label)

White-Label the Connect Accounts Page

تسجيل الخروج التلقائي من جلسة ملف

فتح وإغلاق عنوان URL للربط الاجتماعي

فتح عنوان URL للربط الاجتماعي

إعادة التوجيه عند الإغلاق

مزيد من المعلومات

إشعارات ربط أو فصل المستخدم

مجموعات متعددة من حسابات التواصل الاجتماعي

نظرة عامة

مثال

الخطوات التالية

User Integration

Post API

Profiles API

​سير عمل التكامل

​إنشاء ملف مستخدم Ayrshare

​إنشاء ملف باستخدام واجهة API

Profiles

​إنشاء ملف باستخدام لوحة التحكم (الفريق الداخلي)

Manage User Profiles in Dashboard

​حزمة التكامل

​الدخول الموحد باستخدام مصادقة JWT

​إنشاء JWT

​تمييز صفحة ربط الحسابات بعلامتك التجارية (White-Label)

White-Label the Connect Accounts Page

​تسجيل الخروج التلقائي من جلسة ملف

​فتح وإغلاق عنوان URL للربط الاجتماعي

​فتح عنوان URL للربط الاجتماعي

​إعادة التوجيه عند الإغلاق

​مزيد من المعلومات

​إشعارات ربط أو فصل المستخدم

​مجموعات متعددة من حسابات التواصل الاجتماعي

​نظرة عامة

​مثال

​الخطوات التالية

User Integration

Post API

Profiles API

سير عمل التكامل

إنشاء ملف مستخدم Ayrshare

إنشاء ملف باستخدام واجهة API

إنشاء ملف باستخدام لوحة التحكم (الفريق الداخلي)

حزمة التكامل

الدخول الموحد باستخدام مصادقة JWT

إنشاء JWT

تمييز صفحة ربط الحسابات بعلامتك التجارية (White-Label)

تسجيل الخروج التلقائي من جلسة ملف

فتح وإغلاق عنوان URL للربط الاجتماعي

فتح عنوان URL للربط الاجتماعي

إعادة التوجيه عند الإغلاق

مزيد من المعلومات

إشعارات ربط أو فصل المستخدم

مجموعات متعددة من حسابات التواصل الاجتماعي

نظرة عامة

مثال

الخطوات التالية