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

واجهة برمجة وسائل التواصل بعلامتك: أضف النشر والتعليقات والرسائل المباشرة إلى تطبيق SaaS تحت علامتك التجارية

تتيح Partner API من easyCoexistence لتطبيق SaaS إضافة النشر والرد على التعليقات والرسائل المباشرة إلى منتجه الخاص، مع ظهور اسمه على صفحة الربط. يفتح عملاؤك صفحة ربط مستضافة تعرض اسمك، ثم ينشر خادمك عبر POST /channels/{id}/posts، وتصل التعليقات والرسائل المباشرة إلى خطاف الويب (webhook) الخاص بك، فيرد منتجك عبر واجهة برمجة التطبيقات (API) لكل شبكة. وتبقى شاشات تسجيل الدخول لدى الشبكات وحاشية واحدة في تلك الصفحة تذكر easyCoexistence بالاسم.

80 characters

أطول اسم منتج يمكن أن يضعه partner_name على صفحة الربط المستضافة؛ يظهر اسم حسابك افتراضيًا.

90 days

المدة القصوى التي يمكن أن يجدول فيها POST /channels/{id}/posts منشورًا، مع أن يكون publish_at بعد دقيقة واحدة على الأقل من الآن.

24 hours

نافذة الرسائل القياسية في Instagram بعد رسالة الشخص، لمعظم إجراءات المستخدم؛ يجب أن يكتب الشخص أولًا.

7 days

المدة التي يمكن بعدها لحساب Instagram أن يرسل ردًا خاصًا واحدًا إلى الشخص الذي كتب التعليق.

ماذا يمكن لتطبيق SaaS أن يضعه تحت علامته التجارية؟

كل ما يستخدمه عملاؤك يوميًا. منشئ المحتوى وصندوق الوارد والتنبيهات شاشات خاصة بك، مبنية على مفتاحك ec_live_ وبيانات اعتماد الشبكات التي يجلبها، ولا ينشئ عملاؤك حساب easyCoexistence أبدًا. ويقابل كل جزء وظيفة واحدة في Partner API، كما يلي:

ConnectA hosted link per customer, with your name from partner_name
PostingPOST /channels/{id}/posts from your composer, now or at publish_at
CommentsForwarded to your webhook, replied to through the network's API
DMsInstagram and Messenger DMs, and WhatsApp messages, to your backend
AlertsYour own notices, built on signed status events
BillingYour price to your customers; easyCoexistence bills you per connection

ماذا يرى عميلك، وأين يظهر easyCoexistence؟

تحمل صفحة الربط المستضافة اسمك ولا تحمل شعار easyCoexistence. تبقى أربعة مواضع تذكر easyCoexistence، لأن الشبكة تُظهر دائمًا التطبيق الذي يطلب الوصول، ولا ينبغي أن يصادف العميل هذا الاسم دون شرح:

  • نافذة Embedded Signup من Meta لرقم WhatsApp، وهي تُظهر التطبيق الطالب للوصول ولا يمكن إعادة تسميتها.
  • شاشة الموافقة في Instagram وFacebook وTikTok وYouTube وLinkedIn، وهي تسمي تطبيق easyCoexistence.
  • حاشية واحدة في الصفحة المستضافة، تشرح هذا الاسم قبل أن تعرضه الشبكة.
  • عنوان الصفحة المستضافة، وهو على النطاق easycoexistence.com

كيف يعمل النشر من منشئ المحتوى الخاص بك؟

يرسل منشئ المحتوى طلبًا واحدًا لكل قناة إلى POST /channels/{id}/posts، يحمل النص والوسائط كروابط HTTPS أو كقيم media_id من POST /media، وpublish_at لوقت لاحق. تُفحص قواعد كل شبكة قبل أي جدولة، فيعود المنشور الذي ترفضه Instagram أو TikTok فورًا مع سبب رفضه. أرسل ترويسة Idempotency-Key، فيعيد الطلب المعاد إرساله المنشور نفسه بدلًا من نشره مرتين. تخرج منشورات LinkedIn عندما يوافق شخص في منتجك على كل منشور.

Schedule a post on a customer's channel
curl -X POST https://easycoexistence.com/api/v1/channels/$CHANNEL_ID/posts \
  -H "Authorization: Bearer $EC_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: post_8812" \
  -d '{
    "text": "Our autumn menu starts Friday.",
    "media": [{ "url": "https://cdn.example.com/menu.jpg", "type": "image" }],
    "publish_at": "2026-11-07T09:00:00-03:00"
  }'

كيف تصل التعليقات والرسائل المباشرة إلى منتجك؟

عبر webhook، وجهة واحدة لكل حساب. يوجّه PUT /channels/{id}/webhook حساب التواصل إلى نقطة النهاية (endpoint) الخاصة بك، ويعيد مفتاح توقيع خاص به، ثم ترسل easyCoexistence كل حدث فور وصوله، موقّعًا بالترويسة X-EC-Signature، دون الاحتفاظ بأي نسخة. ترسل Instagram التعليقات والإشارات والرسائل المباشرة، وترسل صفحات Facebook أحداث الخلاصة وMessenger والإشارات، وترسل TikTok الحدث comment.update. أما رسائل رقم WhatsApp فتنتقل من Meta مباشرة إلى webhook_url الخاص به.

كيف يرد منتجك؟

عبر واجهة كل شبكة نفسها، باستخدام رمز الوصول (token) من GET /channels/{id}?credentials=1، فيحمل الرد حساب العميل بوصفه الكاتب. هذه الاستدعاءات التي يجريها زر الرد لديك:

  • تعليق Instagram: POST /<IG_COMMENT_ID>/replies مع حقل message
  • رسالة Instagram المباشرة: POST /<IG_ID>/messages مع معرّف الشخص والنص، خلال 24 ساعة من آخر رسالة منه
  • رد خاص على تعليق Instagram: نقطة النهاية نفسها مع recipient comment_id، مرة واحدة لكل تعليق، خلال 7 أيام من التعليق
  • تعليق TikTok: ينشر ردًا عامًا عبر business/comment/reply/create/
  • WhatsApp: send_endpoint للرقم، مع رمز النشاط التجاري الخاص بالعميل

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

  • الوعد بأن يرى عملاؤك اسمك داخل نافذة Meta. تعرض Meta التطبيق الذي يطلب الوصول، وهو تطبيق easyCoexistence، لذا أخبر عملاءك بما سيرونه قبل الربط.
  • عرض زر رد على رسائل Instagram المباشرة الأقدم من 24 ساعة. انتهت النافذة، لذا تحقق من وقت آخر رسالة للشخص قبل أن يسمح منتجك لأحد بالرد.
  • نشر منشورات LinkedIn من جدول لا يراجعه أحد. تقيّد شروط API الخاصة بـ LinkedIn النشر الآلي، لذا يوافق شخص على كل منشور من LinkedIn قبل أن يرسله منتجك.
  • التحقق من أحداث كل القنوات بمفتاح واحد. يوقّع كل حساب تواصل أحداثه المُعاد توجيهها بمفتاحه الخاص، الذي تعيده PUT /channels/{id}/webhook مرة واحدة.
إنجاز ذلك باستخدام EasyCoexistence

تضع easyCoexistence النشر والرد على التعليقات والرسائل المباشرة داخل منتجك، على أرقام WhatsApp لعملائك وحساباتهم في Instagram وFacebook وTikTok وYouTube وLinkedIn، وقنوات أخرى، عبر واجهة كل شبكة الرسمية، مع اسمك على صفحة الربط ومراقبة كل اتصال على مدار الساعة. من US$ 9 إلى US$ 0.75 لكل اتصال شهريًا، ينخفض كلما أضفت اتصالات، مع فترة تجريبية مجانية لأول 3 أيام.

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

هل تعمل صفحة الربط المستضافة على نطاقي الخاص؟

لا. تعمل على easycoexistence.com وتعرض اسمك من partner_name. يصل إليها عملاؤك بإعادة توجيه أو تبويب جديد من تطبيقك، ويعودون إلى redirect_url الخاص بك عند الانتهاء.

هل يحتاج عملائي إلى حساب easyCoexistence؟

لا. يفتحون الرابط الذي يقدمه منتجك لهم، ويسجلون الدخول عبر الشبكة، ثم يعودون إلى تطبيقك. ينتمي كل اتصال إلى حسابك، وتُحتسب تكلفته على حسابك.

هل يمكن لعملائي مواصلة استخدام تطبيقات الشبكات الأصلية؟

نعم. يضيف الربط وصولًا عبر API لمنتجك، ويبقى الحساب يعمل في Instagram وTikTok والتطبيقات الأخرى، ويبقى رقم WhatsApp داخل تطبيق WhatsApp Business عبر ميزة Coexistence التي تتيح ذلك.

كم تكلف easyCoexistence داخل منتجك؟

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

تابع القراءة

واجهة برمجة التطبيقات (API) الموحدة لوسائل التواصل الاجتماعي في SaaS: تكامل واحد لـ WhatsApp وInstagram وFacebook وTikTok وYouTube وLinkedIn وقنوات أخرىتكامل واحد لحسابات WhatsApp وInstagram وFacebook وTikTok وYouTube وLinkedIn لعملائك: ما يتوحد، وما تقرره كل شبكة، والاستدعاءات.واجهة برمجة التطبيقات (API) لوسائل التواصل الاجتماعي متعددة العملاء: مفتاح واحد لحسابات كثيرةمفتاح API واحد لحسابات عملائك على وسائل التواصل وواتساب: صنف كل حساب بـ external_ref، وافصل الرموز، ووجه webhook والأحداث لكل عميل.كيف تتيح لعملائك ربط Instagram بتطبيقكرابط مستضاف لحسابات Instagram لعملائك: استدعاء الجلسة، والرمز الذي تحصل عليه، وكيف ينشر تطبيقك ويرد على التعليقات والرسائل المباشرة.كيف تتيح لعملائك ربط حسابات WhatsApp وInstagram وTikTok بتطبيقكروابط اتصال مستضافة لأرقام WhatsApp وحسابات التواصل لعملائك: طلب الجلسة، إعادة التوجيه، الحالة، الانتهاء وإعادة المحاولة.كيف تستقبل عبر خطاف الويب (webhook) رسائل عملائك على WhatsApp وتعليقات مواقع التواصلwebhook لكل اتصال: رسائل WhatsApp مباشرة من Meta موثّقة بسر في عنوان URL، وتعليقات ورسائل مباشرة من منصات التواصل موقّعة بترويسة X-EC-Signature لكل حساب.تسعير واجهة برمجة التطبيقات (API) الموحدة لمنصات SaaS: US$ 9 إلى US$ 0.75 لكل اتصالكيف تدفع المنصة ثمن قنوات عملائها: US$ 9 إلى US$ 0.75 لكل اتصال، محسوبة لـ 10 و100 و1,000 عميل، مع بقاء رسوم Meta منفصلة.

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

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

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

تم التحقق في