واجهة برمجة التطبيقات (API) الموحدة لوسائل التواصل الاجتماعي في SaaS: تكامل واحد لـ WhatsApp وInstagram وFacebook وTikTok وYouTube وLinkedIn وقنوات أخرى
توفر واجهة Partner API من easyCoexistence لبرنامج SaaS تكاملًا واحدًا لحسابات عملائه على WhatsApp وInstagram وFacebook وTikTok وYouTube وLinkedIn وقنوات أخرى. يربط مفتاح API واحد واستدعاء جلسة ربط واحد الحسابات كلها، وتعرض الاستدعاءات نفسها قائمتها، وتعيد بيانات اعتماد محدّثة، وتضبط خطافات الويب (webhooks) وترسل أحداث حالة موقّعة، وتنشر نقطة نهاية واحدة للمنشورات على Instagram وFacebook وTikTok وLinkedIn. تمرّ الردود عبر واجهة كل شبكة الخاصة باستخدام رمز الوصول (token) الخاص بالعميل.
مفاتيح Partner API لكل حساب في easyCoexistence؛ وكل رقم وحساب تواصل اجتماعي يربطه ينتمي إلى ذلك الحساب.
السعر الشهري لكل اتصال، وهو نفسه لرقم WhatsApp ولحساب التواصل الاجتماعي، ويتناقص كلما زاد العدد.
المنشورات التي يمكن لحساب Instagram نشرها عبر API خلال 24 ساعة متحركة؛ ويُحسب ألبوم الصور (carousel) منشورًا واحدًا.
مقاطع الفيديو التي ينشرها TikTok لكل حساب عبر واجهته البرمجية، بحد أقصى ستة في الدقيقة.
نافذة خدمة العملاء في WhatsApp بعد رسالة المستخدم؛ وبعد إغلاقها لا يُرسل إلا القوالب المعتمدة.
ما الذي يغطيه التكامل الواحد؟
العمل المشترك بين الشبكات، من https://easycoexistence.com/api/v1 بمفتاح ec_live_ واحد. يتعلم كودك هذه الاستدعاءات مرة واحدة، ويُتعامَل مع حساب TikTok لدى العميل كما يُتعامَل حساب Instagram الخاص به، بالأخطاء نفسها والمعرّفات نفسها والأحداث الموقّعة نفسها:
ما الذي تقرره كل شبكة؟
ما تسمح به واجهتها البرمجية. تربط easyCoexistence كل حساب وتجدّده وتراقبه بالطريقة نفسها، لكن الميزات التي يمكن لمنتجك تقديمها تتبع قواعد كل شبكة، لذا تختلف الرسائل المباشرة (DMs) وأحداث التعليقات وأنواع المنشورات من شبكة إلى أخرى:
لماذا تُعد الأرقام وحسابات التواصل الاجتماعي موارد منفصلة؟
لأنها تحمل أشياء مختلفة. للرقم هاتف وحساب WhatsApp Business وتقييمات Meta؛ أما حساب التواصل الاجتماعي فله اسم مستخدم ومعرّف شبكة. لذلك تُدار الأرقام عبر /connections وحسابات التواصل عبر /channels، ولكل منهما معرّفاته الخاصة، ومعامل إعادة التوجيه الخاص به، أي connection_id أو channel_id، وأسماء أحداثه الخاصة. لا يصادف تكامل WhatsApp فقط أي قناة ما لم يطلبها، والربط هو الاستدعاء الوحيد الذي يتشاركانه.
كيف يعمل استدعاء المنشورات عبر الشبكات؟
جسم الطلب واحد في كل مكان: text وmedia وlink وpublish_at، إضافةً إلى حقول قليلة تقرؤها شبكة بعينها، مثل ig_type على Instagram، وtitle وdisable_comment على TikTok، وimage_alt على LinkedIn. تُفحص حدود كل شبكة قبل وضع المنشور في الطابور:
- Instagram: صورة أو فيديو واحد، أو ألبوم صور (carousel) من 2 إلى 10؛ صور JPEG؛ لا حقل للرابط؛ نص حتى 2,200 حرف.
- Facebook: نص ورابط وصورة واحدة أو فيديو واحد؛ نص حتى 63,206 حرفًا.
- TikTok: فيديو واحد، أو منشور صور من 1 إلى 35 صورة بصيغة JPEG أو WebP؛ لا رابط؛ نص حتى 2,200 حرف.
- LinkedIn: نص مع صورة واحدة أو رابط واحد، ويحتاج الرابط إلى عنوان؛ لا فيديو؛ نص حتى 3,000 حرف.
هل تقع easyCoexistence بين كودك والشبكات؟
فقط حيث يوفر لك العمل: الربط وتجديد الرموز وتمرير أحداث التعليقات والرسائل المباشرة وتشغيل طابور المنشورات. أما الردود والقراءات وأي شيء آخر فيذهب من خادمك مباشرة إلى واجهة الشبكة باستخدام token الخاص بالعميل، وتسلّم Meta رسائل الرقم مباشرة إلى خادمك. وأي ميزة تضيفها شبكة تكون متاحة لكودك فور إطلاقها، دون انتظار غلاف برمجي.
ماذا يحدث عند انضمام شبكة جديدة؟
تصل كقيمة قناة (channel) جديدة في الاستدعاءات نفسها. تسمّيها جلسات الربط لديك، وتظهر حساباتها في GET /channels، وتستخدم أحداثها أسماء channel.*، ويكلّف كل اتصال ما يكلّفه أي اتصال آخر. أما القناة التي لا يستطيع حسابك استخدامها بعد فيُجاب عليها بالخطأ 400 channel_unavailable، وتسرد الرسالة القنوات المتاحة له.
كيفية إعداده
- Create a keyIn the dashboard under Profile, Developers, create the ec_live_ key and store it in your backend's secrets.
- Save a cardAdd a card to the account, since connect sessions answer 402 billing_required until one is saved.
- Connect each customerCreate a connect session with the channel and your customer's id as external_ref, and send the customer to its url.
- Set the webhooksGive each number a webhook_url and each social account a destination with PUT /channels/{id}/webhook.
- Post and replyPublish with POST /channels/{id}/posts and reply through each network's API with fresh credentials.
الأخطاء الشائعة
- بناء رسائل مباشرة لـ TikTok أو YouTube أو LinkedIn. هذه الاتصالات لا تملك رسائل مباشرة، لذا خطط للردود على التعليقات هناك، والردود على الرسائل المباشرة لـ WhatsApp وInstagram وMessenger.
- إرسال منشور على Instagram بلا وسائط. يحتاج Instagram إلى صورة أو فيديو، ويُرفض الطلب قبل وضعه في الطابور، لذا أرفق الوسائط لكل شبكة على حدة.
- تخزين channel_id وconnection_id في عمود واحد دون تحديد النوع. إنهما موردان منفصلان بمعرّفين مستقلين، فاحفظ أي نوع تمثله كل قيمة.
- النشر على LinkedIn من تغذية بلا مراجعة. تقيّد شروط واجهة LinkedIn البرمجية النشر الآلي، لذا اجعل شخصًا يوافق على كل منشور على LinkedIn أولًا.
تمنح easyCoexistence برنامج SaaS لديك تكاملًا واحدًا لأرقام WhatsApp لعملائك ولحسابات Instagram وFacebook وTikTok وYouTube وLinkedIn، وقنوات أخرى: روابط الربط وبيانات الاعتماد وwebhooks وأحداث الحالة والمنشورات، عبر واجهة كل شبكة الرسمية، مع مراقبة كل اتصال على مدار الساعة. من US$ 9 إلى US$ 0.75 لكل اتصال شهريًا، ويتناقص كلما أضفت اتصالات، مع أول 3 أيام مجانًا.
الأسئلة الشائعة
هل يمكن لنقطة نهاية واحدة استقبال أحداث من كل الشبكات؟
نعم. وجّه وجهة كل قناة إلى عنوان URL نفسه، ثم وجّه الأحداث حسب platform وaccount_id في الجسم. تأتي رسائل الرقم من Meta إلى webhook_url الخاص به، ويمكن أن يكون الخادم نفسه.
هل أسجّل تطبيقي الخاص لدى Meta وTikTok وGoogle وLinkedIn؟
لا. يسجّل العملاء الدخول عبر تطبيقات easyCoexistence على تلك الشبكات، ويتسلّم خادمك token الذي يحتاجه لاستدعاء واجهة كل شبكة.
ما الشبكات التي ينشر إليها نقطة نهاية المنشورات؟
Instagram وصفحات Facebook وTikTok وLinkedIn. تُرفع مقاطع YouTube عبر واجهة YouTube البرمجية نفسها باستخدام بيانات اعتماد القناة.
كم تكلّف واجهة easyCoexistence الموحدة؟
السعر نفسه على كل شبكة: من US$ 9 إلى US$ 0.75 لكل اتصال شهريًا، يحدده نطاق إجماليك، مع أول 3 أيام مجانًا.
تابع القراءة
اربط قناتك الأولى في دقيقتين.
لا حاجة لانتظار مراجعات المنصات. اربط WhatsApp أو Instagram أو TikTok أو أي قناة أخرى، ثم اطلب من الذكاء الاصطناعي النشر أو الرد أو إعداد التقارير، وشاهده يعمل.
- 3 أيام مجانًا
- إلغاء في أي وقت
- واجهات API الرسمية فقط
- مراقبة على مدار الساعة 24/7
تم التحقق في