تسجيل الدخولابدأ الفترة التجريبية المجانية
easyCoexistence واجهات API الرسمية

كيفية ربط صفحة Facebook بواجهة برمجة التطبيقات (API) أو بوكيل ذكاء اصطناعي

تتصل صفحة Facebook بواجهة برمجة التطبيقات (API) أو بوكيل ذكاء اصطناعي عبر Facebook Login for Business. يسجّل الدخول بحساب Facebook من يملك الصفحة أو يستطيع تنفيذ مهام عليها، ويوافق على أذونات الصفحة التي يطلبها التطبيق، وتشمل النشر والتعليقات وMessenger والإحصاءات. ثم يقرأ التطبيق رمز الوصول (token) لكل صفحة من /me/accounts، وهو رمز بلا تاريخ انتهاء إذا جاء من رمز مستخدم طويل الأمد.

يربط easyCoexistence صفحات Facebook لديك بتسجيل دخول واحد عبر Facebook Login for Business، ويحتفظ بـ token كل صفحة مشفرًا ويفحصه كل 6 ساعات، فيستطيع Claude أو ChatGPT أو منصتك الخاصة النشر والجدولة والرد على التعليقات والرسائل المباشرة وقراءة الإحصاءات عبر واجهة Meta الرسمية.

Owner or task

للحصول على token الخاص بالصفحة من شخص، يجب أن يكون ذلك الشخص مالكًا للصفحة أو قادرًا على تنفيذ مهمة عليها.

Admin access

يستطيع الشخص الممنوح صلاحية Admin على الصفحة من واجهة Facebook تنفيذ جميع المهام على تلك الصفحة.

No expiry

لا تنتهي صلاحية رموز وصول الصفحات طويلة الأمد، المُنشأة من رمز مستخدم طويل الأمد.

Task access

يدير من لديهم صلاحية المهام الصفحة عبر أدوات مثل Meta Business Suite، لا مباشرةً على Facebook.

1 hour

المدة التي يبقى فيها رابط الربط الخاص بـ easyCoexistence فعالًا قبل انتهاء الجلسة.

من يستطيع ربط الصفحة؟

يستطيع الربط من يملك الصفحة أو ينفذ مهامًا عليها، لأن Meta تُصدر رمز وصول الصفحة لهذا الشخص وحده. في إعدادات وصول الصفحات على Facebook يعني ذلك وصولًا من Facebook بتحكم كامل أو جزئي، أو وصول المهام المستخدم من Meta Business Suite أو Ads Manager؛ وتذكر نظرة عامة على Pages API من Meta أن وصول Admin يشمل جميع المهام. ثم تُفحص كل استدعاء مقابل مهام ذلك الشخص، لذا اربط من الحساب الذي تغطي مهامه العمل المطلوب:

  • صلاحية CREATE_CONTENT لنشر المنشورات.
  • صلاحية MODERATE للرد على التعليقات وحذفها.
  • صلاحية MESSAGING للرد على رسائل Messenger والردود الخاصة.
  • صلاحية ANALYZE لقراءة الإحصاءات.

ماذا يرى الشخص عند تسجيل الدخول؟

نافذة تسجيل الدخول الخاصة بـ Facebook نفسها، ويشغّلها Facebook Login for Business. يفتح التطبيق حوار تسجيل الدخول في Facebook مع config_id لإعداد يحدد نوع الـ token والأصول والأذونات التي يحتاجها؛ وعند استخدام إعداد user access token يسجّل الشخص الدخول بحساب Facebook الشخصي ويمنح التطبيق صلاحية الوصول إلى صفحاته. يعيد Facebook رمز تفويض يحوّله خادم التطبيق إلى رمز مستخدم، ثم إلى رمز مستخدم طويل الأمد، قبل قراءة /me/accounts لكل صفحة ورمز وصولها.

ما وظيفة كل إذن؟

يوافق الشخص عليها معًا في النافذة نفسها، وكل إذن يفتح جزءًا من Graph API. يطلب easyCoexistence هذه الأذونات التسعة، لكي يستطيع الوكيل النشر على الصفحة والرد عليها وقياس أدائها؛ وكل ملاحظة هي ما تقوله مرجعية الأذونات لدى Meta عما يسمح به الإذن:

pages_show_listAccess the list of Pages a person manages
pages_read_engagementRead content the Page posted, and metadata and insights about the Page
pages_manage_postsCreate, edit and delete the Page's posts
pages_manage_engagementCreate, edit and delete comments posted on the Page
pages_read_user_contentRead what others post on the Page, such as posts, comments and ratings
pages_manage_metadataSubscribe to webhooks about activity on the Page, and update its settings
pages_messagingManage and access the Page's conversations in Messenger
read_insightsRead Insights data for Pages the person owns
business_managementRead and write with the Business Manager API

أي الصفحات تصبح اتصالات؟

تصبح كل صفحة يعيدها تسجيل الدخول مع token اتصالًا مستقلًا، وتُحتسب مثل أي اتصال آخر. وإذا كانت الصفحة تعمل بالفعل في حساب easyCoexistence آخر، تبقى هناك ويُبلَّغ بأنها متصلة مسبقًا، فلا يستطيع أحد لديه وصول إليها سحبها من حساب مدفوع. وعند تسجيل الدخول لاحقًا، تُضاف الصفحات المُنشأة منذ ذلك الحين، ويُحدَّث token الصفحات المتصلة فعلًا.

كيف تربطها بـ easyCoexistence؟

من لوحة التحكم، وبتسجيل دخول واحد: اختر «اتصال جديد»، ثم Facebook، وسجّل الدخول بحساب Facebook الذي يدير الصفحة، ثم اختر الصفحات. إذا لم تكن بطاقة مسجلة في الحساب، يُطلب إضافة بطاقة أولًا، لأن كل اتصال يُحتسب. وعند عودة Facebook، تظهر كل صفحة بحالة Connected، ويشترك easyCoexistence بها في حقول خطاف الويب (webhook) الخاصة بالمنشورات والرسائل والإشارات، ويحتفظ بـ token الخاص بها مشفرًا، ويفحصه كل 6 ساعات.

1New connectionIn the easyCoexistence dashboard
2FacebookFacebook's own login window opens
3ApproveThe Pages and the nine permissions
4ConnectedEach Page ready for Claude, ChatGPT or your code

كيف تربط منصة صفحات عملائها؟

عبر رابط ربط مستضاف من Partner API. يرسل خادمك طلبًا إلى /api/v1/connect-sessions مع channel بقيمة facebook وredirect_url، ثم يوجّه العميل إلى url الذي يعيده الطلب، حيث يكمل عبر Facebook دون أن يملك حسابًا خاصًا في easyCoexistence. يعود المتصفح مع الجلسة والحالة وchannel_id، فيؤكدها خادمك عبر GET /connect-sessions/:id. تُعلَن كل صفحة ربطها تسجيل الدخول بحدث channel.connected وتحمل external_ref الخاص بك، ما لم تكن قد وُسمت لعميل آخر لديك.

Create a connect session for a Facebook Page
curl -X POST https://easycoexistence.com/api/v1/connect-sessions \
  -H "Authorization: Bearer $EC_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "channel": "facebook",
    "redirect_url": "https://app.example.com/connect/return",
    "external_ref": "customer_4821"
  }'

ماذا يحدث بعد الربط؟

تصبح الصفحة جاهزة لأي عمل يُنفَّذ عليها. تُعيدها list_social_accounts إلى Claude أو ChatGPT أو وكيلك الخاص، ويسلّم get_social_credentials معرّف الصفحة وقاعدة API إلى شيفرتك، وتُرسَل تغييرات منشورات الصفحة ورسائل Messenger والإشارات إلى نقطة النهاية (endpoint) الخاصة بك متى حددتها، عبر set_social_webhook_destination أو PUT /api/v1/channels/:id/webhook.

لماذا قد يفشل الربط؟

عادةً لأحد أربعة أسباب، ولكل منها إصلاح مباشر:

  • الشخص لا يدير أي صفحة: لا يعيد Facebook أي صفحة للربط، لذا سجّل الدخول بحساب لديه وصول إليها.
  • ألغى الشخص تسجيل الدخول: لم يُربط شيء، وتفتح إعادة البدء نافذة جديدة.
  • الصفحة متصلة بالفعل بحساب easyCoexistence آخر: أزلها من هناك أولًا.
  • فُتح رابط الربط بعد ساعته: أنشئ جلسة جديدة.

كيفية إعداده

  1. Check your accessMake sure your Facebook account has full control, partial control or task access on the Page.
  2. Start the connectionIn the easyCoexistence dashboard, choose New connection, then Facebook.
  3. Approve the permissionsSign in with Facebook and approve access for the Pages you want to connect.
  4. Point your AI at itAdd https://easycoexistence.com/api/mcp to Claude or ChatGPT, or call the Page from your own code.

الأخطاء الشائعة

  • الربط عبر شخص على وشك مغادرة النشاط التجاري. يعتمد token الصفحة على صلاحية ذلك الشخص، ويتوقف عن العمل حين يفقدها، لذا سجّل الدخول من حساب سيبقى قائمًا.
  • الوثوق بحالة إعادة التوجيه وحدها. يستطيع أي أحد كتابة status=connected في رابط، لذا أكّد الجلسة عبر GET /connect-sessions/:id من خادمك.
  • إرسال webhook_url في جلسة ربط Facebook. ترفضه واجهة API هناك؛ حدّد مُرحِّل الأحداث لكل صفحة عبر PUT /api/v1/channels/:id/webhook بعد أن تُربط.
  • قراءة channel_id وحده من إعادة التوجيه. قد يربط تسجيل دخول واحد عبر Facebook عدة صفحات، لذا اعرضها كلها عبر GET /api/v1/channels مع تصفية بحسب channel وexternal_ref.
إنجاز ذلك باستخدام EasyCoexistence

من US$ 9 إلى US$ 0.75 لكل اتصال شهريًا، ينخفض كلما أضفت اتصالات، مع فترة تجريبية مجانية مدتها 3 أيام.

الأسئلة الشائعة

هل أحتاج إلى تطبيق Meta للمطورين الخاص بي لربط صفحة؟

لا. يطلب تطبيق Meta الخاص بـ easyCoexistence أذونات الصفحة، فيسجّل الشخص الدخول بحساب Facebook ويوافق عليها، دون تطبيق خاص به ودون الحاجة إلى مراجعة تطبيق أو توثيق نشاط تجاري خاص به.

هل يستطيع من لديه صلاحية المهام ربط صفحة؟

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

هل أستطيع ربط عدة صفحات على Facebook؟

نعم. تصبح كل صفحة من تسجيل الدخول اتصالًا مستقلًا، يُحتسب بسعر من US$ 9 إلى US$ 0.75 لكل اتصال شهريًا، كلما زاد إجمالي اتصالاتك.

ماذا لو كانت الصفحة متصلة في مكان آخر؟

لا يمكنها الانضمام إلى حساب easyCoexistence ثانٍ ما دامت متصلة بالفعل في الأول. أزلها من هناك، ثم اربطها من جديد.

تابع القراءة

اربط قناتك الأولى في دقيقتين.

لا حاجة لانتظار مراجعات المنصات. اربط WhatsApp أو Instagram أو TikTok أو أي قناة أخرى، ثم اطلب من الذكاء الاصطناعي النشر أو الرد أو إعداد التقارير، وشاهده يعمل.

  • 3 أيام مجانًا
  • إلغاء في أي وقت
  • واجهات API الرسمية فقط
  • مراقبة على مدار الساعة 24/7

تم التحقق في