الانتقال من Ayrshare أو Zernio أو Unipile إلى easyCoexistence: ما الذي يتغير في كودك
الانتقال من Ayrshare أو Zernio أو Unipile إلى easyCoexistence يغيّر أربعة أجزاء من كودك: الربط، عبر جلسة ربط مستضافة لكل حساب؛ والعنونة، عبر channel_id أو connection_id مع external_ref؛ والنشر، بنداء POST /channels/:id/posts واحد لكل حساب؛ والأحداث، موقّعة لكل حساب أو ترسلها Meta إليك مباشرة. يسجّل كل عميل الدخول مرة أخرى، عبر شاشة الموافقة الخاصة بالشبكة نفسها.
الترويسة التي ترسل طلب Ayrshare إلى User Profile، بجوار مفتاح API الخاص بـ Primary Profile في Authorization.
مدة الصلاحية الافتراضية لرابط ربط Ayrshare الذي يولّده generateJWT؛ وحتى 2,880 دقيقة يتطلب Max Pack.
تتوزع حالات منشورات Zernio على draft وpending_approval وscheduled وpublishing وpublished وpartial وfailed وcancelled، أي ثماني حالات.
الترويسة التي تقبلها واجهة Unipile، على عنوان URL أساسي هو DSN الخاص بك، لطلبات مثل رابط المصادقة المستضاف.
مدة صلاحية رابط الربط في easyCoexistence؛ ينتهي كل رابط بربط رقم واحد أو بتسجيل دخول واحد عبر شبكة اجتماعية.
ما الذي يقابل ما؟
المفاهيم تنتقل كما هي، والأشكال هي التي تتغير. لكل من العميل ورابط ربط الحساب والمعرّف الذي تعنون به الحساب ونداء النشر والأحداث نظير في الطرف الآخر. تتبع صفوف الجدول وثائق كل مزوّد، التي قُرئت بتاريخ 3 نوفمبر 2026، ومرجع Partner API الخاص بـ easyCoexistence:
| Ayrshare, Zernio or Unipile | easyCoexistence | |
|---|---|---|
| Your customer | An Ayrshare User Profile, a Zernio profile or the name on a Unipile link | external_ref on each connect session, connection and event |
| Linking | generateJWT, GET /v1/connect/{platform} or POST /api/v1/hosted/accounts/link | POST /connect-sessions, one account per link |
| Addressing | Profile-Key, profileId with accountId, or account_id | channel_id for a social account, connection_id for a number |
| Authentication | A Bearer key, with Profile-Key on Ayrshare; X-API-KEY on Unipile | Authorization: Bearer ec_live_… |
| Posting | One request with a list of platforms, on Ayrshare and Zernio | POST /channels/:id/posts, one per account |
| Incoming events | The provider's webhooks | Signed forwards per account; WhatsApp from Meta to your URL |
ما الذي يتغير عند مغادرة Ayrshare؟
تختفي طبقة الملف الشخصي. ترسل Ayrshare المنشور إلى User Profile عبر ترويسة Profile-Key، وتوزعه على المنصات بقائمة platforms في POST /api/post، مع scheduleDate بالتوقيت العالمي UTC وmediaUrls للملفات. أما على easyCoexistence فتدور حلقتك على قنوات العميل: نداء واحد POST /channels/:id/posts لكل قناة، مع publish_at بأي إزاحة زمنية وmedia بالشكل {url, type}. ينتقل الربط من generateJWT، الذي يبقى رابطه 5 دقائق افتراضياً، إلى جلسة ربط لكل حساب تدوم ساعة.
const EC = "https://easycoexistence.com/api/v1";
const auth = { Authorization: `Bearer ${process.env.EC_API_KEY}` };
// Before: POST https://api.ayrshare.com/api/post with Profile-Key,
// { post, platforms: ["instagram", "facebook"], mediaUrls, scheduleDate }
async function schedule(customerId, post) {
const { data } = await fetch(`${EC}/channels?external_ref=${customerId}`, { headers: auth })
.then((r) => r.json());
for (const ch of data.filter((c) => post.networks.includes(c.channel) && c.status === "connected")) {
await fetch(`${EC}/channels/${ch.id}/posts`, {
method: "POST",
headers: { ...auth, "Content-Type": "application/json", "Idempotency-Key": `${post.id}-${ch.id}` },
body: JSON.stringify({
text: post.text,
media: post.mediaUrls.map((url) => ({ url, type: post.type })),
publish_at: post.scheduleDate, // ISO 8601 with Z or an offset
}),
});
}
}ما الذي يتغير عند مغادرة Zernio؟
التغيير هنا أقل مما مع الآخرين في النشر. يأخذ POST /v1/posts في Zernio حقل content، وقائمة platforms تحوي platform وaccountId، وmediaItems وscheduledFor مع timezone، ويحترم Idempotency-Key كما تفعل easyCoexistence. تصبح القائمة نداءً واحداً لكل channel_id، ويصبح scheduledFor هو publish_at مع إزاحة زمنية. لا نظير في easyCoexistence لحالتي draft وpending_approval في Zernio، لذا تبقى المسودات والموافقات في منتجك. ينتقل الربط من GET /v1/connect/{platform} مع profileId، الذي يعيد authUrl، إلى POST /connect-sessions، الذي يعيد url ولاحقاً channel_id عند عودتك إلى عنوان إعادة التوجيه الخاص بك.
ما الذي يتغير عند مغادرة Unipile؟
معظمه في الرسائل. يربط Unipile الحسابات عبر POST /api/v1/hosted/accounts/link على DSN الخاص بك مع X-API-KEY، ويرسل عبر POST /api/v1/chats/{chat_id}/messages، ويبلغ عن الرسائل الجديدة عبر خطاف الويب (webhook) message_received، الذي يشمل الرسائل التي يرسلها الحساب نفسه. في easyCoexistence ينضم رقم WhatsApp إلى Cloud API الخاصة بـ Meta عبر Coexistence، وهذا يتطلب تطبيق WhatsApp Business، وتسلّم Meta رسائله إلى webhook_url الخاص بك. تذهب الردود إلى send_endpoint الخاص بالرقم برمز العميل، وتمر الرسائل المباشرة على Instagram عبر واجهة Meta بمعرّفات القناة.
هل يحتاج عملاؤك إلى إعادة الربط؟
نعم، مرة واحدة لكل حساب. الإذن الذي منحه كل عميل يتبع التطبيق التابع للمزوّد الذي طلبه، لذا لا يمكن نقله إلى تطبيق آخر. يسجّل كل حساب الدخول من جديد عبر رابط ربط مستضاف، عبر شاشة الموافقة الخاصة بالشبكة نفسها، أو عبر النافذة المنبثقة لـ Meta بالنسبة لرقم WhatsApp. اطلبه حين يكون العميل متاحاً: يعمل كل رابط لمدة ساعة، ويمكن للحساب أن يملك 50 رابطاً مفتوحاً وينشئ 100 رابط في الساعة.
كيف تنتقل دون توقف للخدمة؟
حساباً حساباً، مع تشغيل المزوّدين جنباً إلى جنب حتى ينتقل كل عميل. يوجّه كودك كل حساب إلى المزوّد الذي يملكه، وتكون channel.connected أو connection.connected لحظة التحويل لذلك الحساب:
- اربط معرّف كل عميل بـ
external_ref، واحفظchannel_idوconnection_idبجواره عند وصولهما. - أرسل روابط الربط لكل عميل، بدءاً بالحسابات التي تنشر أو تستقبل أكثر من غيرها.
- عند channel.connected، جدول منشورات ذلك الحساب المعلّقة على easyCoexistence، ثم ألغِها لدى المزوّد القديم.
- وجّه أحداث ذلك الحساب إلى المستقبِلات الجديدة لديك، ثم افصله عن المزوّد القديم.
ما الذي يبقى كما هو في كودك؟
منتجك. يبقى المحرر والتقويم ومسار الموافقة وصندوق الوارد كما هي، ويتغير المحوّل الذي تحتها فقط. تبقى الوسائط عبر رابط HTTPS عام، ويبقى Idempotency-Key على ترويسة، وتُتحقق الأحداث بـ HMAC على الجسم الخام، وكل ما يحتاجه كودك خارج النداءات المغلّفة يذهب مباشرة إلى واجهة الشبكة نفسها ببيانات الاعتماد من GET /channels/:id?credentials=1.
الأخطاء الشائعة
- إلغاء المنشورات لدى المزوّد القديم قبل أن يعيد الحساب الربط. حتى يصل channel.connected لا يمكن النشر على easyCoexistence، لذا جدول أولاً وألغِ ثانياً.
- نقل عميل يعمل واتساب لديه على التطبيق الاستهلاكي. يربط Coexistence أرقام تطبيق WhatsApp Business، لذا ينقل العميل الرقم إلى تطبيق WhatsApp Business قبل فتح الرابط.
- إرسال رابط واحد لكل شبكات العميل. ينتهي الرابط برقم واحد أو بتسجيل دخول واحد، لذا أنشئ جلسة واحدة لكل حساب.
- تطابق cancelled مع الكتابة نفسها. تُبلغ easyCoexistence عن canceled بحرف l واحد، فحدّث أي مقارنة لحالة المنشور في كودك.
تمنح easyCoexistence منتجك روابط ربط مستضافة، وبيانات اعتماد طازجة، وقائمة نشر، وأحداثاً موقّعة لأرقام WhatsApp لدى عملائك ولحسابات Instagram وFacebook وTikTok وYouTube وLinkedIn لديهم، وقنوات أخرى، ويعمل كل منها عبر الواجهة البرمجية الرسمية لكل شبكة، مع مراقبة كل اتصال على مدار الساعة. من US$ 9 إلى US$ 0.75 لكل اتصال شهرياً، ينخفض كلما أضفت اتصالات، مع فترة تجريبية مجانية مدتها 3 أيام.
الأسئلة الشائعة
هل يمكنني نقل حسابات عملائي المرتبطة دون أن يسجلوا الدخول من جديد؟
لا. كل شبكة تربط الإذن بالتطبيق الذي طلبه، لذا يسجّل كل حساب الدخول مرة واحدة عبر رابط ربط في easyCoexistence.
هل تربط easyCoexistence حسابات X أو Threads أو Telegram؟
ليس حالياً. أبقِ هذه الحسابات لدى مزوّدك الحالي بينما تنتقل الأخرى. تنضم الشبكات الجديدة إلى Partner API نفسها بالسعر نفسه لكل اتصال كلما أُضيفت.
هل يمكنني الإبقاء على مراسلة LinkedIn من Unipile؟
أبقِها هناك. تعمل easyCoexistence على صفحات LinkedIn وملفات LinkedIn الشخصية عبر المنشورات والتعليقات، ولا تقدم رسائل LinkedIn المباشرة.
كم تكلف easyCoexistence بعد الانتقال؟
من US$ 9 إلى US$ 0.75 لكل اتصال شهرياً، وهو السعر نفسه على كل شبكة، ينخفض كلما أضفت اتصالات، مع فترة تجريبية مجانية مدتها 3 أيام.
تابع القراءة
اربط قناتك الأولى في دقيقتين.
لا حاجة لانتظار مراجعات المنصات. اربط WhatsApp أو Instagram أو TikTok أو أي قناة أخرى، ثم اطلب من الذكاء الاصطناعي النشر أو الرد أو إعداد التقارير، وشاهده يعمل.
- 3 أيام مجانًا
- إلغاء في أي وقت
- واجهات API الرسمية فقط
- مراقبة على مدار الساعة 24/7
تم التحقق في