كيف تحصل على رموز الوصول الخاصة بعملائك لـ WhatsApp وInstagram وTikTok
تعيد Partner API من easyCoexistence رمز الوصول (token) الخاص بالعميل المتصل ومعرّفاته بطلب GET واحد مع ?credentials=1. بالنسبة إلى رقم WhatsApp، يعطيك المسار /connections/{id} القيم waba_id وphone_number_id وقاعدة Graph API ونقطة النهاية (endpoint) للإرسال، ورمز النشاط التجاري الخاص بالعميل. أما الحساب الاجتماعي فيعطيك المسار /channels/{id} قاعدة API الخاصة بالشبكة، ومعرّف الحساب فيها، ورمز وصول يُجدَّد لك، لذلك اطلبه في بداية كل مهمة.
يضيف credentials إلى GET /connections/{id} لرقم WhatsApp، وإلى GET /channels/{id} لحساب اجتماعي.
مدة صلاحية رمز وصول مستخدم Google، الذي تستخدمه قناة YouTube في استدعاءاتها.
مدة صلاحية رمز وصول TikTok لحساب من API for Business، ورمز التحديث الخاص به صالح لمدة عام.
المدة التي يبقى فيها رمز Instagram طويل الأجل بعد تجديده صالحًا، محسوبةً من يوم التجديد.
لا تنتهي صلاحية رموز صفحات Facebook طويلة الأجل من Meta، وإن كانت شروط معينة قد تُبطلها.
أي طلب يعيد بيانات اعتماد الاتصال؟
الطلب GET الخاص بالمورد نفسه مع ?credentials=1، ويُصادَق عليه بمفتاحك ec_live_ كرمز Bearer. يقع رقم WhatsApp على المسار /connections/{id} والحساب الاجتماعي على /channels/{id}، ولكل منهما مساحة معرّفات خاصة به: يعطيك توجيه الربط connection_id للرقم، وchannel_id للحساب الاجتماعي. تسرد GET /connections وGET /channels الاتصالات، ويحصر ?external_ref= أيًّا من القائمتين على عميل واحد. وبدون هذا المعامل، يعيد الطلبان الاتصال نفسه دون أي رمز فيه.
# A WhatsApp number
curl "https://easycoexistence.com/api/v1/connections/$CONNECTION_ID?credentials=1" \
-H "Authorization: Bearer $EC_API_KEY"
# A social account
curl "https://easycoexistence.com/api/v1/channels/$CHANNEL_ID?credentials=1" \
-H "Authorization: Bearer $EC_API_KEY"ماذا يعيد طلب بيانات اعتماد رقم WhatsApp؟
الاتصال نفسه مع كائن credentials. يحدد waba_id وphone_number_id حساب WhatsApp Business ورقم الهاتف على Graph API الخاصة بـ Meta، ويخبرك token_ready ما إذا كان رمز العميل محفوظًا. داخل credentials، يحمل graph_api_base وsend_endpoint إصدار Graph API بالفعل، وأما access_token فهو رمز النشاط التجاري الذي أصدرته Meta عند اتصال العميل، ومقصور على ذلك العميل. ثم يتصل الخادم الخلفي لديك بـ Meta مباشرة للإرسال وإدارة القوالب ورفع الوسائط وتعديل ملف النشاط التجاري.
- status: الحالة، وتكون إحدى القيم connected أو degraded أو disconnected أو banned أو suspended أو removed أو unknown، أي غير معروفة.
quality_ratingوmessaging_tier: تقييم Meta وفئة الرقم، وأمثلتهما GREEN وTIER_1Kعلى الترتيب.webhook_url: عنوان الاستقبال الذي ترسل Meta إليه رسائل الرقم، وتكون القيمة null إن لم يكن محددًا.disconnected_reasonوlast_checked_atوlast_event_atوcreated_at: سبب قطع الاتصال الذي تسجله Meta إن وُجد، وأوقات بصيغة ISO 8601 المعتمدة.
{
"id": "<CONNECTION_ID>",
"external_ref": "customer_4821",
"connect_session_id": "cs_…",
"phone": "+55 11 9…",
"name": "Clínica Sorriso",
"waba_id": "<WABA_ID>",
"phone_number_id": "<PHONE_NUMBER_ID>",
"status": "connected",
"quality_rating": "GREEN",
"messaging_tier": "TIER_1K",
"platform_type": "…",
"token_ready": true,
"webhook_url": "https://hooks.example.com/wa/<long-random-secret>",
"disconnected_reason": null,
"last_checked_at": "2026-10-31T09:00:00.000Z",
"last_event_at": "2026-10-31T08:41:12.000Z",
"created_at": "2026-10-20T14:03:55.000Z",
"credentials": {
"graph_api_base": "https://graph.facebook.com/v25.0",
"send_endpoint": "https://graph.facebook.com/v25.0/<PHONE_NUMBER_ID>/messages",
"access_token": "EAAG…",
"note": "The customer's own business token, scoped to their assets. …"
}
}ماذا يعيد طلب بيانات اعتماد كل شبكة اجتماعية؟
عرض القناة نفسه الذي يعيده GET /channels/{id}، أي id وchannel وexternal_ref وname وusername وexternal_id وstatus وtoken_ready، إضافة إلى كائن credentials. تحمل credentials لكل شبكة platform وقاعدة API ومعرّف الحساب على تلك الشبكة وaccess_token وtoken_expires_at وtoken_note وأمثلة للاستدعاءات. ويختلف حقل المعرّف، وأي شيء آخر تحتاجه الشبكة، من شبكة إلى أخرى:
لماذا تجلب رمز الشبكة الاجتماعية لكل مهمة بدلًا من تخزينه؟
لأن بعضها يتجدد خلال يوم، وطلب بيانات الاعتماد يعيد دائمًا رمزًا صالحًا في تلك اللحظة. تنتهي صلاحية رمز Google في YouTube بعد ساعة، ورمز TikTok بعد يوم، ويجددهما easyCoexistence قبل انقضائهما. ويُجدَّد رمز Instagram، الذي تبلغ مدته 60 يومًا، قبل ذلك بوقت كافٍ فيصدر رمز جديد. ولا ينتهي رمز صفحة Facebook ما دامت الصفحة متصلة. يُرسل طلب واحد في بداية كل مهمة، فلا يستدعي كودك أبدًا أي شبكة برمز منتهٍ.
هل ينبغي تخزين رمز رقم WhatsApp؟
نعم. هو رمز النشاط التجاري الصادر عن Embedded Signup لدى Meta، ومقصور على العميل الذي أتمّ الإعداد، وتطلب الوثائق منك تخزينه لأن لوحة التحكم لا تعرضه. اقرأه من جديد بعد كل حدث connection.connected، لأن إعادة الربط قد تصدر رمزًا جديدًا. ولا يُقدَّم رمز رقم موقوف أو محذوف بعد الآن، وأي رمز للعميل ترفضه Meta بينما يظل الرقم يستجيب يُسحب، فيُضبط token_ready على false، أي غير متاح.
ماذا تعني token_ready وtoken_missing؟
تساوي token_ready القيمة true حين يكون رمز العميل محفوظًا والاتصال نشطًا. وقد تكون القيمة false مباشرة بعد الربط، لأن Meta تنهي أحيانًا Embedded Signup دون أن تصدر رمز العميل. عندها تطلب الصفحة المستضافة من العميل تشغيل الإجراء مرة أخرى، ويستقبل نقطة الأحداث لديك الحدث connection.token_missing. وإذا تجاوز العميل الخطوة، يستقبل الرقم الرسائل لأن معرّفاته صحيحة، لكنه لا يستطيع الإرسال. وتصدر جلسة ربط جديدة لذلك العميل الرمز، ولا تستبدل أبدًا رمزًا يعمل. لا يوجد token_missing للقنوات الاجتماعية، فتسجيل الدخول فيها يعيد دائمًا رمز العميل الخاص به، ولذلك تتبع token_ready حالة الاتصال.
ماذا يحدث عندما لا يكون لدى الاتصال رمز يعيده؟
تكون الاستجابة 200 يحمل فيها credentials القيمة access_token الفارغة null وملاحظة توضح ما يجب فعله، بدلًا من خطأ. ينطبق ذلك على رقم قيمة token_ready فيه false، وعلى رقم موقوف أو محذوف، وعلى قناة لا تكون حالتها connected، حيث تطلب الملاحظة جلسة ربط جديدة. ويعني الرد 404 not_found أن المعرّف غير موجود في حسابك، ويعني الرد 502 credentials_unavailable تعذر الحصول على رمز اجتماعي جديد في تلك اللحظة، فأعد المحاولة، وتحقق من حالة القناة إن تكرر ذلك.
الأخطاء الشائعة
- تخزين رمز YouTube أو TikTok في ملف إعدادات. تنتهي صلاحيتها خلال ساعة ويوم، لذا استدعِ نقطة بيانات الاعتماد في بداية كل مهمة، واترك التجديد للمنصة.
- الإرسال من رقم قيمة token_ready فيه false. لا يوجد رمز عميل تستدعي به Meta، فافتح جلسة ربط جديدة لذلك العميل، فتصدر لك رمزًا واحدًا.
- استدعاء TikTok بترويسة Authorization. تأخذ واجهة Business API الرمز في ترويسة Access-Token، مع business_id الحساب في كل طلب.
- استدعاء LinkedIn بالرمز Bearer وحده. يحتاج LinkedIn أيضًا إلى الترويستين LinkedIn-Version وX-Restli-Protocol-Version المذكورتين في required_headers، وإلى ترميز قيم URN في المسارات.
تربط easyCoexistence أرقام WhatsApp لعملائك وحساباتهم على Instagram وFacebook وTikTok وYouTube وLinkedIn، وقنوات أخرى، ثم تسلّم خادمك الخلفي بيانات اعتماد كل اتصال عند الطلب، مع تجديد الرموز الاجتماعية ومراقبة الاتصالات على مدار الساعة. من US$ 9 إلى US$ 0.75 لكل اتصال شهريًا، ويتناقص السعر كلما أضفت اتصالات، مع أول 3 أيام مجانًا.
الأسئلة الشائعة
هل رمز WhatsApp ملك للعميل؟
نعم. هو رمز النشاط التجاري الذي تصدره Meta عند اتصال العميل عبر Embedded Signup، ومقصور على ذلك العميل. لا يُكشف أبدًا رمز النظام الخاص بـ easyCoexistence، ولا يعيد الطلب رمزًا إلا حين تكون token_ready صحيحة.
كم تدوم رموز الوصول الاجتماعية؟
يدوم رمز YouTube ساعة، ورمز TikTok يومًا، ورمز Instagram حتى 60 يومًا، أما رمز صفحة Facebook فلا تنتهي صلاحيته. يجدّد easyCoexistence الرموز التي تتجدد، فيعيد كل طلب بيانات اعتماد رمزًا يعمل الآن.
هل أحتاج إلى تطبيق مطوّر خاص بي على كل شبكة؟
لا. يسجّل العملاء الدخول عبر تطبيق easyCoexistence نفسه على Meta وTikTok وGoogle وLinkedIn، ويسلّم طلب بيانات الاعتماد خادمك الخلفي الرمز اللازم لاستدعاء واجهة تلك الشبكة مباشرة.
هل يستطيع مساعد مثل Claude أو ChatGPT قراءة بيانات الاعتماد نفسها؟
نعم. إذا سجّل الدخول إلى حسابك عبر خادم MCP، يمكنه استدعاء get_api_credentials لرقم، وget_social_credentials لحساب اجتماعي، فيعيد القيم نفسها، كما في Partner API تمامًا.
تابع القراءة
اربط قناتك الأولى في دقيقتين.
لا حاجة لانتظار مراجعات المنصات. اربط WhatsApp أو Instagram أو TikTok أو أي قناة أخرى، ثم اطلب من الذكاء الاصطناعي النشر أو الرد أو إعداد التقارير، وشاهده يعمل.
- 3 أيام مجانًا
- إلغاء في أي وقت
- واجهات API الرسمية فقط
- مراقبة على مدار الساعة 24/7
تم التحقق في