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

واجهة برمجة التطبيقات (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) الخاص بالعميل.

1 key

مفاتيح Partner API لكل حساب في easyCoexistence؛ وكل رقم وحساب تواصل اجتماعي يربطه ينتمي إلى ذلك الحساب.

US$ 9 to US$ 0.75

السعر الشهري لكل اتصال، وهو نفسه لرقم WhatsApp ولحساب التواصل الاجتماعي، ويتناقص كلما زاد العدد.

100 posts

المنشورات التي يمكن لحساب Instagram نشرها عبر API خلال 24 ساعة متحركة؛ ويُحسب ألبوم الصور (carousel) منشورًا واحدًا.

15 a day

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

24 hours

نافذة خدمة العملاء في WhatsApp بعد رسالة المستخدم؛ وبعد إغلاقها لا يُرسل إلا القوالب المعتمدة.

ما الذي يغطيه التكامل الواحد؟

العمل المشترك بين الشبكات، من https://easycoexistence.com/api/v1 بمفتاح ec_live_ واحد. يتعلم كودك هذه الاستدعاءات مرة واحدة، ويُتعامَل مع حساب TikTok لدى العميل كما يُتعامَل حساب Instagram الخاص به، بالأخطاء نفسها والمعرّفات نفسها والأحداث الموقّعة نفسها:

ConnectPOST /connect-sessions, with channel set to the network
ListGET /connections for numbers, GET /channels for social accounts
Credentials?credentials=1 on either, with tokens renewed for you
WebhooksPUT /connections/{id}/webhook or PUT /channels/{id}/webhook
Status eventsconnection.* and channel.*, signed, with your external_ref
PostsPOST /channels/{id}/posts, now or at publish_at
RemoveDELETE on the connection or the channel

ما الذي تقرره كل شبكة؟

ما تسمح به واجهتها البرمجية. تربط easyCoexistence كل حساب وتجدّده وتراقبه بالطريقة نفسها، لكن الميزات التي يمكن لمنتجك تقديمها تتبع قواعد كل شبكة، لذا تختلف الرسائل المباشرة (DMs) وأحداث التعليقات وأنواع المنشورات من شبكة إلى أخرى:

WhatsAppMessages and replies on the Cloud API, templates outside the 24-hour window
InstagramPosts, carousels, Reels and Stories; comments; replies to DMs
FacebookPage posts; comments; replies to Messenger DMs
TikTokVideo and photo posts; public replies to comments; no DMs
YouTubeUploads and comments through YouTube's own API; no DMs
LinkedInPosts a person approves, text with an image or a link; no 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، وتسرد الرسالة القنوات المتاحة له.

كيفية إعداده

  1. Create a keyIn the dashboard under Profile, Developers, create the ec_live_ key and store it in your backend's secrets.
  2. Save a cardAdd a card to the account, since connect sessions answer 402 billing_required until one is saved.
  3. Connect each customerCreate a connect session with the channel and your customer's id as external_ref, and send the customer to its url.
  4. Set the webhooksGive each number a webhook_url and each social account a destination with PUT /channels/{id}/webhook.
  5. 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

تمنح 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 أيام مجانًا.

تابع القراءة

واجهة برمجة وسائل التواصل بعلامتك: أضف النشر والتعليقات والرسائل المباشرة إلى تطبيق SaaS تحت علامتك التجاريةأضف النشر والتعليقات والرسائل المباشرة إلى تطبيقك: ما يراه عملاؤك، وأين يظهر اسم easyCoexistence، والاستدعاءات خلفه.واجهة برمجة التطبيقات (API) لوسائل التواصل الاجتماعي متعددة العملاء: مفتاح واحد لحسابات كثيرةمفتاح API واحد لحسابات عملائك على وسائل التواصل وواتساب: صنف كل حساب بـ external_ref، وافصل الرموز، ووجه webhook والأحداث لكل عميل.كيفية إضافة WhatsApp إلى SaaS باستخدام Embedded Signup و Coexistenceأضف WhatsApp إلى SaaS: اربط أرقام العملاء بـ Embedded Signup وCoexistence، واستقبل الرسائل، وردّ داخل نافذة 24 ساعة، وأرسل القوالب.كيف تضيف النشر على TikTok إلى منتج SaaS الخاص بكأضف النشر على TikTok إلى SaaS: اربط حساب كل عميل، وانشر فيديوهات أو صورًا الآن أو لاحقًا بطلب واحد، وتابع كل منشور حتى يُنشر.كيف تحصل على رموز الوصول الخاصة بعملائك لـ WhatsApp وInstagram وTikTokما يعيده طلب credentials لرقم WhatsApp لعميلك ولكل حساب اجتماعي، حقلاً حقلاً، وكيف يعمل تجديد الرموز وحالة الجاهزية.انشر على Instagram وTikTok وFacebook وYouTube وLinkedIn بواجهة API واحدةانشر وجدول منشورات Instagram وReels وStories وفيديوهات TikTok ومنشورات صفحات Facebook ورفع YouTube ومنشورات LinkedIn من Claude أو ChatGPT أو من كودك.

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

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

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

تم التحقق في