واجهة برمجة وسائل التواصل بعلامتك: أضف النشر والتعليقات والرسائل المباشرة إلى تطبيق SaaS تحت علامتك التجارية
تتيح Partner API من easyCoexistence لتطبيق SaaS إضافة النشر والرد على التعليقات والرسائل المباشرة إلى منتجه الخاص، مع ظهور اسمه على صفحة الربط. يفتح عملاؤك صفحة ربط مستضافة تعرض اسمك، ثم ينشر خادمك عبر POST /channels/{id}/posts، وتصل التعليقات والرسائل المباشرة إلى خطاف الويب (webhook) الخاص بك، فيرد منتجك عبر واجهة برمجة التطبيقات (API) لكل شبكة. وتبقى شاشات تسجيل الدخول لدى الشبكات وحاشية واحدة في تلك الصفحة تذكر easyCoexistence بالاسم.
أطول اسم منتج يمكن أن يضعه partner_name على صفحة الربط المستضافة؛ يظهر اسم حسابك افتراضيًا.
المدة القصوى التي يمكن أن يجدول فيها POST /channels/{id}/posts منشورًا، مع أن يكون publish_at بعد دقيقة واحدة على الأقل من الآن.
نافذة الرسائل القياسية في Instagram بعد رسالة الشخص، لمعظم إجراءات المستخدم؛ يجب أن يكتب الشخص أولًا.
المدة التي يمكن بعدها لحساب Instagram أن يرسل ردًا خاصًا واحدًا إلى الشخص الذي كتب التعليق.
ماذا يمكن لتطبيق SaaS أن يضعه تحت علامته التجارية؟
كل ما يستخدمه عملاؤك يوميًا. منشئ المحتوى وصندوق الوارد والتنبيهات شاشات خاصة بك، مبنية على مفتاحك ec_live_ وبيانات اعتماد الشبكات التي يجلبها، ولا ينشئ عملاؤك حساب easyCoexistence أبدًا. ويقابل كل جزء وظيفة واحدة في Partner API، كما يلي:
ماذا يرى عميلك، وأين يظهر 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 عندما يوافق شخص في منتجك على كل منشور.
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 النشر والرد على التعليقات والرسائل المباشرة داخل منتجك، على أرقام 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 أيام. أنت تحدد سعرك الخاص لعملائك.
تابع القراءة
اربط قناتك الأولى في دقيقتين.
لا حاجة لانتظار مراجعات المنصات. اربط WhatsApp أو Instagram أو TikTok أو أي قناة أخرى، ثم اطلب من الذكاء الاصطناعي النشر أو الرد أو إعداد التقارير، وشاهده يعمل.
- 3 أيام مجانًا
- إلغاء في أي وقت
- واجهات API الرسمية فقط
- مراقبة على مدار الساعة 24/7
تم التحقق في