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

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

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

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

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

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

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

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

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

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

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

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

Profiles

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

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

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

Manage User Profiles in Dashboard

حزمة التكامل

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

الدخول الموحد إلى صفحة الربط الاجتماعي

يقوم Ayrshare بتسجيل دخول المستخدم الخاص بك إلى صفحة الربط الاجتماعي نيابةً عنك. تقوم بإنشاء جلسة ربط ثم تفتح عنوان url الذي يُعاد إليك؛ ولا يوجد شيء ينبغي لتطبيقك إنشاؤه ولا شيء ينبغي توقيعه.

إنشاء عنوان URL للربط الاجتماعي

استدعِ إنشاء جلسة ربط مع تمرير Profile-Key الخاص بالمستخدم في الترويسة. يُعيد عنوان url يحمل رمز جلسة غير شفاف وقصير الأجل:

Linking URL

https://profile.ayrshare.com?session=ayr_ls_kJ8mQ2vX9pLnR4tYwZ6aBcD1eFgH3iJkLmN0oPqRsTu&domain=YOUR_DOMAIN

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

عنوان URL صالح لمدة 5 دقائق افتراضيًا. استخدم expiresIn لتحديد مدة أخرى، حتى 2880 دقيقة (48 ساعة)، وهو ما يتطلب Max Pack.

يمكنك أيضًا التحقق مما إذا كان رابط قد فُتح وإبطاله قبل انتهاء صلاحيته.

تنفّذ إنشاء رابط ربط (generateJWT) المهمة نفسها وتستمر في العمل دون تغيير، فالروابط التي سلّمتها بالفعل لا تتأثر. وهي مهملة (deprecated) للتكاملات الجديدة وليس لها موعد للإزالة. لا تزال معاملاتها privateKey وbase64 وverify تُقبل وتُتجاهل — لا شيء يُوقَّع من جانبك، ولم تعد بحاجة إلى المفتاح الخاص الذي أصدرناه لك.

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

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

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

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

White-Label the Connect Accounts Page

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

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

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

فتح وإغلاق عنوان 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 لإعادة التوجيه. يُرجى الاطلاع على إنشاء جلسة ربط لمزيد من التفاصيل.

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

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

Linking URL

https://profile.ayrshare.com?session=[session token]&domain=[domain id]&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

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

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

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

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

Profiles

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

Manage User Profiles in Dashboard

حزمة التكامل

الدخول الموحد إلى صفحة الربط الاجتماعي

إنشاء عنوان URL للربط الاجتماعي

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

White-Label the Connect Accounts Page

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

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

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

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

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

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

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

نظرة عامة

مثال

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

User Integration

Post API

Profiles API

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

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

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

Profiles

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

Manage User Profiles in Dashboard

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

​الدخول الموحد إلى صفحة الربط الاجتماعي

​إنشاء عنوان URL للربط الاجتماعي

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

White-Label the Connect Accounts Page

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

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

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

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

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

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

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

​نظرة عامة

​مثال

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

User Integration

Post API

Profiles API

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

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

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

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

حزمة التكامل

الدخول الموحد إلى صفحة الربط الاجتماعي

إنشاء عنوان URL للربط الاجتماعي

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

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

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

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

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

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

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

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

نظرة عامة

مثال

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