واجهة برمجة التطبيقات (API) لوسائل التواصل الاجتماعي متعددة العملاء: مفتاح واحد لحسابات كثيرة
واجهة Partner API من easyCoexistence متعددة العملاء بطبيعتها: يربط مفتاح ec_live_ واحد في حسابك ويدير أرقام واتساب وحسابات التواصل الاجتماعي لكثير من عملائك. يحمل كل اتصال معرّف عميلك بوصفه external_ref، ويحتفظ برمز الوصول (token) الخاص بذلك العميل، ويحصل على وجهة خطاف الويب (webhook) خاصة به، ويظهر في أحداث الحالة الموقعة، فيسرد GET /channels?external_ref= حسابات عميل واحد.
أطول external_ref تقبلها جلسة الربط: معرّفك الخاص بالعميل، ويُخزَّن على الاتصال الذي تنشئه.
مفاتيح API التي يحتفظ بها حساب easyCoexistence في وقت واحد؛ المفاتيح المنفصلة تعني حسابات منفصلة وفواتير منفصلة.
عدد جلسات الربط المفتوحة في آن واحد لكل حساب، إلى جانب حد 100 جلسة جديدة في الساعة.
العمر الأقصى للطابع الزمني لحدث موقّع الذي يجب رفضه بعده، مع مقارنة HMAC بزمن ثابت.
كيف يخدم حساب واحد عملاء كثيرين؟
يمثل حسابك في easyCoexistence منتجك، وكل عميل وسم يُضاف إلى الاتصالات التي يجلبها. لا ينشئ العملاء حسابات خاصة بهم، ولا يرون مفتاحك أبدًا، ويحاسبهم أنت، لا easyCoexistence:
كيف تضع وسماً لكل اتصال بعميلك؟
أرسل external_ref في جلسة الربط. تُخزَّن القيمة على الرقم أو القناة التي تنشئها الجلسة، وتُضاف إلى إعادة التوجيه، وتُدرج في أحداث الحالة الخاصة بها. تقوم تسجيلات الدخول إلى Facebook أو LinkedIn التي تجلب عدة صفحات بوسم كل واحدة منها. لعرض حسابات عميل واحد، صفِّ أيًّا من القائمتين:
curl "https://easycoexistence.com/api/v1/channels?external_ref=customer_4821" \
-H "Authorization: Bearer $EC_API_KEY"
curl "https://easycoexistence.com/api/v1/connections?external_ref=customer_4821" \
-H "Authorization: Bearer $EC_API_KEY"كيف تُفصل رموز العملاء عن بعضها؟
يحتفظ كل اتصال بـ token عميله الخاص. token رقم واتساب هو token النشاط التجاري الذي تصدره Meta عبر Embedded Signup، ومحصور بأصول ذلك العميل، أما token الحساب الاجتماعي فهو الذي منحه إياه مالكه. تأتي بيانات الاعتماد عبر مفتاحك فقط، ومن الخادم الخاص بك، ويجيب المعرّف غير الموجود في حسابك بالرمز 404 not_found. ابحث عن الاتصال الخاص بالعميل الذي تنتمي إليه المهمة قبل أن تجلب الـ token الخاص به، حتى لا تعمل مهمة عميل على حساب عميل آخر.
كيف تعمل webhooks لكل عميل؟
وجهة واحدة لكل حساب تختارها أنت. وجّه القنوات إلى عنوان URL واحد ثم وجّه الطلبات حسب account_id الوارد في النص، أو امنح كل عميل عنوان URL خاصًا به. توقّع كل قناة بسرها الخاص المضبوط عبر PUT /channels/{id}/webhook، لذلك يخبرك account_id بالسر الذي تتحقق به. تُرسل رسائل الرقم من Meta إلى webhook_url الخاص به، وهو مضبوط على WhatsApp Business Account، لذلك وجّهها حسب phone_number_id.
كيف تحدد أحداث الحالة العميل المعني؟
من خلال حملها external_ref الخاص بك. يستقبل عنوان الأحداث الواحد لكل حساب أحداث connection.* و channel.*، ويحمل كل منها عرض الاتصال أو القناة بداخله، بما فيه external_ref، ويحمل post.published و post.failed المنشور وقناته. توقَّع الأحداث بسر الحساب الخاص بها في X-EC-Signature، وتُعاد محاولتها عند فشل نقطة النهاية لديك، لذا عالج معرّف كل تسليم مرة واحدة فقط.
كم بسرعة يمكنك تأهيل عملاء كثيرين؟
عند 50 جلسة ربط مفتوحة و100 جلسة جديدة في الساعة لكل حساب. تحسب Meta كل تأهيل أولي لواتساب ضمن حد على مستوى التطبيق يشترك فيه كل حساب في easyCoexistence، وتمنع الحدود استيراد منصة واحدة من استنفاد هذا الحد. أنشئ كل جلسة حين يوشك عميلها على الربط، وعند بلوغ الحد يُرجع الخادم الاستجابة 429 مع cap_reached أو rate_limited.
ماذا لو كان حساب عميل متصلاً بالفعل في مكان آخر؟
يُرفض تسجيل الدخول. يُربط حساب التواصل الاجتماعي عبر حساب easyCoexistence واحد في كل مرة، فإذا كانت خدمة أخرى تستخدم easyCoexistence تمتلكه، يوضح last_error في الجلسة ذلك، فيزيله العميل من هناك أو يسجل الدخول بحساب مختلف. داخل حسابك، يمكن للعميل ربط أي عدد من الحسابات يحتاجه، يحمل كل منها external_ref نفسه.
كيف توقف خدمة عميل واحد؟
اعرض اتصالات العميل وقنواته بحسب external_ref، ثم احذف كلاً منها باستخدام DELETE. يؤدي حذف الرقم إلى إلغاء وصول easyCoexistence لدى Meta وإيقاف المراقبة، ويؤدي حذف القناة إلى إلغاء الوصول لدى الشبكة وإلغاء منشوراتها التي ما زالت في قائمة الانتظار. تتوقف الفوترة عن كل منها عند نهاية الدورة، ولا تتأثر الاتصالات الأخرى للعميل، ولا اتصالات العملاء الآخرين.
الأخطاء الشائعة
- استخدام البريد الإلكتروني كـ external_ref. البريد يتغير، والقيمة تُخزَّن على كل اتصال، لذا استخدم المعرّف الثابت من قاعدة بياناتك.
- التحقق من الأحداث المعاد توجيهها بسر العميل الخطأ. ابحث عن السر بواسطة account_id الوارد في النص، لأن كل قناة توقّع بسرها الخاص.
- إرسال روابط الربط إلى قاعدة عملائك كلها دفعة واحدة. لا يمكن أن تكون مفتوحة سوى 50 جلسة لكل حساب، لذا ادعُ العملاء على دفعات.
- حذف العميل من قاعدة بياناتك فقط. تبقى اتصالاته في حسابك وفي فاتورتك حتى يُزال كل منها عبر API.
تتيح easyCoexistence لمفتاح API واحد أن يخدم قاعدة عملائك كلها: أرقام واتساب الخاصة بهم، وحسابات Instagram وFacebook وTikTok وYouTube وLinkedIn، وقنوات أخرى، كل منها موسوم بمعرّف عميلك، ويملك token وwebhook وأحداثاً موقّعة خاصة به، وتُراقَب كل الاتصالات على مدار الساعة طوال أيام الأسبوع. من US$ 9 إلى US$ 0.75 لكل اتصال في الشهر، ينخفض السعر كلما أضفت اتصالات، مع فترة تجريبية مجانية مدتها 3 أيام.
الأسئلة الشائعة
هل أحتاج إلى حساب easyCoexistence لكل عميل؟
لا. يمكن لحساب واحد ومفتاحه أن يحملا اتصالات عملاء كثيرين، ويُميَّز بينهم بواسطة external_ref. الحسابات المنفصلة مطلوبة فقط حين تريد فواتير منفصلة.
هل يرى عملائي حسابات بعضهم؟
ليس عبر easyCoexistence. لا يحملون مفتاحك أبدًا، ولا يفتحون سوى روابط الربط الخاصة بهم. ما يراه كل عميل داخل منتجك يحدده كودك أنت.
هل يمكنني منح كل عميل عنوان URL مختلفاً لـ webhook؟
نعم. يأخذ كل رقم وكل قناة وجهته الخاصة، لذا يعمل عنوان URL خاص بالعميل، كما يعمل عنوان URL مشترك واحد يُوجَّه حسب account_id.
كيف تُحتسب فوترة حساب متعدد العملاء؟
لكل اتصال عبر جميع عملائك معاً: من US$ 9 إلى US$ 0.75 لكل اتصال شهرياً، يحدده النطاق الذي يقع فيه إجمالي عددها، مع فترة تجريبية مجانية مدتها 3 أيام.
تابع القراءة
اربط قناتك الأولى في دقيقتين.
لا حاجة لانتظار مراجعات المنصات. اربط WhatsApp أو Instagram أو TikTok أو أي قناة أخرى، ثم اطلب من الذكاء الاصطناعي النشر أو الرد أو إعداد التقارير، وشاهده يعمل.
- 3 أيام مجانًا
- إلغاء في أي وقت
- واجهات API الرسمية فقط
- مراقبة على مدار الساعة 24/7
تم التحقق في