واجهة برمجة لوسائل التواصل للوكالات: أدر حسابات عملائك من برمجياتك الخاصة
تمكّن واجهة برمجة التطبيقات (API) برمجيات الوكالة من ربط حسابات عملائها على وسائل التواصل الاجتماعي، ونشر المحتوى عليها والرد فيها وإعداد تقاريرها. مع Partner API من easyCoexistence، ينضم رقم WhatsApp الخاص بالعميل وحساباته على Instagram وFacebook وTikTok وYouTube وLinkedIn إلى حساب الوكالة عبر روابط مستضافة موسومة بمعرّف العميل، ويجدول مفتاح API واحد هذه الحسابات كلها ويوجّهها ويراقبها.
أطول قيمة external_ref تقبلها جلسة الربط، وهو معرّف الوكالة الخاص بالعميل، ويبقى محفوظًا على كل اتصال.
المدة التي يبقى فيها رابط الربط المستضاف صالحًا للعميل الذي يفتحه.
ما يحتاج إليه تطبيق Meta لخدمة حسابات Instagram المحترفة التي لا يملكها ولا يديرها، بعد App Review وBusiness Verification.
دور صفحة LinkedIn الذي يحتاجه العضو لصلاحية rw_organization_admin، وهي الصلاحية التي تدير الصفحات وتقرأ تقاريرها.
متى تتوقف الفوترة عن اتصال عميل تزيله الوكالة عبر API.
كيف تنظّم الواجهة عملاء الوكالة؟
بمعرّف العميل الخاص بك. أرسله كـ external_ref في كل جلسة ربط، فيبقى محفوظًا على كل رقم وحساب تنشئه الجلسة، ويعود مع كل حدث حالة. تسرد GET /channels?external_ref=client_118 حسابات التواصل الاجتماعي لذلك العميل، ويمكنك إضافة &channel=instagram لتقصرها على شبكة واحدة، وتسرد GET /connections?external_ref=client_118 أرقام WhatsApp الخاصة به. يقع كل عميل ضمن حساب الوكالة الواحد، تحت مفتاح ec_live_ واحد، وهذا ما يضع العدد كله في شريحة سعر واحدة.
curl "https://easycoexistence.com/api/v1/channels?external_ref=client_118" \
-H "Authorization: Bearer $EC_API_KEY"
curl "https://easycoexistence.com/api/v1/connections?external_ref=client_118" \
-H "Authorization: Bearer $EC_API_KEY"كيف يمنح العميل الوصول؟
عبر رابط ترسله الوكالة. يعيد الطلب POST /connect-sessions عنوان URL عند إرسال الشبكة كقيمة channel، وexternal_ref الخاص بالعميل، واسم الوكالة كقيمة partner_name. يفتحه العميل، ويسجّل الدخول عبر شاشة الموافقة الخاصة بالشبكة، أو يشغّل النافذة المنبثقة من Meta ويمسح رمز QR لرقم WhatsApp، ثم يعود إلى redirect_url الخاص بالوكالة. قد يضم تسجيل الدخول عبر Facebook أو LinkedIn عدة صفحات دفعة واحدة، لكل منها اتصال خاص، لذا قارن القائمة بموجز العميل.
كيف تنشر الوكالة لصالح عملائها؟
من مسار الموافقة الخاص بها. تحتفظ برمجيات الوكالة بالمسودات إلى أن يوافق العميل، ثم ترسل كل منشور معتمد إلى POST /channels/:id/posts مع publish_at، بحد أقصى 90 يومًا مقدمًا. تعرض GET /channels/:id/posts تقويم حساب واحد، ويعرض GET /posts مع فلتر الحالة ما ينتظر عبر العملاء، ويخبر الحدثان post.published وpost.failed مدير الحساب بما جرى. تمرّ منشورات LinkedIn دائمًا عبر موافقة شخص، وخطوة الاعتماد لدى الوكالة توفر ذلك أصلًا.
كيف ترد الوكالة على التعليقات والرسائل المباشرة لعملائها؟
من صندوق وارد واحد يوجّه حسب الحساب. يحدد PUT /channels/:id/webhook وجهة الإرسال لكل حساب Instagram وصفحة Facebook وحساب TikTok، وكل تعليق أو إشارة أو رسالة مباشرة تُعاد توجيهها يحمل account_id الذي يربطه بالعميل. تنتقل رسائل رقم WhatsApp من Meta إلى webhook_url المحدد له. تخرج الردود عبر واجهة كل شبكة ببيانات الاعتماد من GET /channels/:id?credentials=1، ويمكن لفريق الوكالة أيضًا العمل عبر العملاء داخل Claude أو ChatGPT من خلال موصل MCP على الحساب نفسه.
كيف تُعدّ الوكالة تقارير العملاء؟
من تحليلات كل شبكة، تُستدعى ببيانات اعتماد حساب العميل. تأتي تحليلات Instagram وFacebook من Meta Graph API، وتأتي تحليلات TikTok من API for Business الخاصة بها، وتأتي تحليلات YouTube من YouTube Analytics، وتتضمن بيانات اعتمادها عنوانها الأساسي، وتأتي تحليلات LinkedIn من نقاط النهاية الخاصة بالإحصاءات. تجلب مهمة التقارير لدى الوكالة بيانات اعتماد حديثة لكل حساب في بداية كل تشغيل، وتسحب أرقام الفترة، وتحفظها تحت external_ref الخاص بالعميل.
كيف تعرف الوكالة أن حساب عميل يحتاج إلى انتباه؟
من أحداث الحالة الموقّعة. يحمل كل من channel.disconnected وconnection.disconnected الـ external_ref الخاص بالعميل، فتستطيع برمجيات الوكالة تنبيه مدير حساب ذلك العميل وإرسال رابط ربط جديد إليه. تُراقَب كل الاتصالات على مدار الساعة طوال أيام الأسبوع، ويُرسل بريد إلكتروني إلى مالك الوكالة كلما انقطع أحدها. والعميل الذي يسحب الوصول من إعدادات الشبكة يظهر بالطريقة نفسها.
ماذا يحدث في الواجهة عندما يغادر عميل؟
تسرد مهمة الإنهاء لدى الوكالة اتصالات العميل حسب external_ref، وتستدعي DELETE /channels/:id وDELETE /connections/:id على كل منها. تتوقف رسومها في نهاية الدورة، وتُلغى المنشورات المجدولة على قناة مُزالة، ويُنسى رمز الوصول (token) لحساب التواصل المحذوف. يبقى رقم WhatsApp على Cloud API حتى يفصله العميل في تطبيق WhatsApp Business.
الأخطاء الشائعة
- جدولة منشورات العملاء قبل أن يوافق العميل. المنشور المجدول يُنشر في موعده دون فحص آخر، لذا احفظ المسودات في خطوة الموافقة لديك، ولا ترسلها إلا بعد اعتمادها.
- وضع مفتاح Partner API في الواجهة الأمامية لبوابة العميل. يصل المفتاح إلى بيانات اعتماد كل عميل في الحساب، لذا أبقه على خادم الوكالة.
- انتظار أحداث التعليقات من قناة YouTube الخاصة بعميل أو من صفحة LinkedIn الخاصة به. لا تستقبل easyCoexistence أيًّا منهما، لذا تقرأها مهمة التقارير أو الصندوق الوارد عبر واجهة كل شبكة.
تمنح easyCoexistence برمجيات الوكالة واجهة برمجة واحدة لأرقام WhatsApp الخاصة بعملائها وحساباتهم على Instagram وFacebook وTikTok وYouTube وLinkedIn، وقنوات أخرى قادمة: روابط ربط مستضافة موسومة لكل عميل، وقائمة انتظار للنشر، والرسائل والتعليقات المُعاد توجيهها، وبيانات اعتماد حديثة للتقارير، ومراقبة كل اتصال على مدار الساعة. من US$ 9 إلى US$ 0.75 لكل اتصال شهريًا، ينخفض كلما أضفت اتصالات، مع أول 3 أيام مجانًا.
الأسئلة الشائعة
هل يحتاج العملاء إلى حساب خاص بهم في easyCoexistence؟
لا. يفتح العميل الرابط المستضاف ويسجّل الدخول، فينضم الاتصال إلى حساب الوكالة، حيث يُحتسب ثمنه ويُراقَب.
هل يمكن للوكالة أن تُبقي عملاءها على مفاتيح API منفصلة؟
الحساب الواحد يحمل مفتاحًا واحدًا. المفاتيح المنفصلة تعني حسابات منفصلة في easyCoexistence، يُحتسب كل منها من الشريحة الأولى، لذلك تفصل معظم الوكالات عملاءها عن بعض بواسطة external_ref.
هل يرى العميل اسم الوكالة عند الربط؟
نعم. تعرض الصفحة المستضافة الاسم المرسل بوصفه partner_name. وتُظهر شاشة الموافقة الخاصة بالشبكة easyCoexistence بوصفه التطبيق الذي يطلب الوصول.
كم تكلّف easyCoexistence الوكالة؟
من US$ 9 إلى US$ 0.75 لكل اتصال عميل شهريًا، ينخفض كلما أضافت الوكالة عملاء، وبالسعر نفسه على كل شبكة، مع أول 3 أيام مجانًا.
تابع القراءة
اربط قناتك الأولى في دقيقتين.
لا حاجة لانتظار مراجعات المنصات. اربط WhatsApp أو Instagram أو TikTok أو أي قناة أخرى، ثم اطلب من الذكاء الاصطناعي النشر أو الرد أو إعداد التقارير، وشاهده يعمل.
- 3 أيام مجانًا
- إلغاء في أي وقت
- واجهات API الرسمية فقط
- مراقبة على مدار الساعة 24/7
تم التحقق في