امنح مساعداً ذكياًرقم WhatsApp حقيقياً.
يتيح خادم MCP لـ Claude أو ChatGPT أو Cursor استخدام WhatsApp مباشرةً: عرض أرقامك، وفحص حالتها، وإرسال الرسائل والقوالب، وتوجيه خطافات الويب (webhooks) إلى أنظمتك الخاصة. يعمل خادمنا على Cloud API الرسمي من Meta، لذلك لا يتعرض للخطر أبداً الرقم الذي يراسله عملاؤك بالفعل.
{
"mcpServers": {
"easycoexistence": {
"url": "https://easycoexistence.com/api/mcp"
}
}
}ما الذي يتصل به الموصل فعلياً
خادم بعيد واحد، يُوصل إليه عبر OAuth، ويستدعي Cloud API الموثّق من Meta على رقم لا يزال يعمل في تطبيق WhatsApp Business. لا تُحتفظ أي جلسة في أي مكان، ولا يعمل شيء على جهازك.
- 1مساعدكClaude أو ChatGPT أو Cursor أو Claude Code، عبر MCP
- 2easycoexistence.com/api/mcpخادم بعيد، مُصرّح له عبر OAuth. لا يُلصق أي مفتاح في أي مكان
- 3Meta Cloud APIنقاط النهاية (endpoints) الموثّقة في Graph، برمز الوصول (token) الخاص بالحساب نفسه
- 4رقم النشاط التجاريمتصل عبر Coexistence، والتطبيق لا يزال يعمل على الهاتف
الطريق البديل الذي تسلكه معظم أدوات أتمتة WhatsApp هو تسجيل الدخول كجهاز مرتبط والتحكم في جلسة WhatsApp Web. وهذا يخالف شروط WhatsApp، وتكتشفه Meta من نمط حركة البيانات لا من الشيفرة التي ترسلها، ولهذا فإن أي ادعاء بمنع الحظر يصف شيئاً لا يتحكم فيه المورّد. لا شيء هنا يستخدم تلك الآلية.
طريقة التثبيت
نقطة نهاية بعيدة واحدة، هي نفسها لكل رقم في الحساب. لا توجد حزمة للتثبيت ولا مفتاح للإنشاء: يسجّل كل تطبيق الدخول عبر OAuth في أول مرة يستدعي فيها أداة.
- افتح الإعدادات وانتقل إلى الموصلات.
- اختر إضافة موصل مخصص والصق نقطة النهاية أدناه.
- احفظ، ثم اطلب من Claude عرض أرقامك. ستُفتح نافذة تسجيل الدخول في المرة الأولى.
https://easycoexistence.com/api/mcp- افتح الإعدادات، وانتقل إلى الموصلات ثم متقدم، وفعّل وضع المطوّر.
- أضف موصلاً باستخدام نقطة النهاية أدناه.
- ابدأ محادثة واطلب منه عرض أرقامك لبدء تسجيل الدخول.
https://easycoexistence.com/api/mcp- شغّل الأمر أدناه في أي طرفية.
- شغّل /mcp داخل Claude Code ثم أكمل المصادقة.
- تصبح الأدوات متاحة في كل جلسة بعد ذلك.
claude mcp add --transport http easycoexistence --scope user https://easycoexistence.com/api/mcp- افتح الإعدادات وانتقل إلى قسم MCP في القائمة.
- أضف خادماً باستخدام الإعدادات أدناه.
- أعد التحميل، ثم اطلب من Cursor عرض أرقامك.
{
"mcpServers": {
"easycoexistence": {
"url": "https://easycoexistence.com/api/mcp"
}
}
}ربط رقم خطوة منفصلة تُنفَّذ مرة واحدة وتحتاج إلى متصفح، لأن عملية الإعداد لدى Meta تستخدم نافذتها المنبثقة الخاصة ومسح رمز QR. تعيد get_connect_link ذلك الرابط إذا فضّلت أن يسلّمه إليك المساعد.
قواعد تفرضها الأدوات، حتى لا يتعلمها المساعد بالطريقة الصعبة
تعمل send_message عندما يكون المستلم قد راسل الرقم خلال آخر 24 ساعة. وهذه الردود مجانية. خارج ذلك، تكون send_template مع قالب معتمد الوسيلة الوحيدة التي تصل، ووصف الأداة يذكر ذلك، فيلجأ المساعد إلى الأداة الصحيحة دون أن يُطلب منه.
لا يستطيع تطبيق الهاتف إرسال قالب على رقم Coexistence. فكل ما هو مجدول أو معاملاتي أو خارج النافذة يجب أن يمر عبر API، وهذا جزء كبير من سبب ربط الرقم أصلاً.
تحتسب Meta رسائل التسويق على وسيلة الدفع المسجلة في حساب WhatsApp Business، وهي وسيلة تُضبط في WhatsApp Manager نفسه. لا يمر ذلك عبرنا أبداً، ولا يمكننا عبر API إضافة بطاقة.
يلزم استخدام HTTPS، وعند طلب GET يحمل hub.mode=subscribe وقيمة hub.verify_token الخاصة بك، يجب أن تعيد نقطة النهاية قيمة hub.challenge كما هي. نتحقق من ذلك قبل الاستدعاء، فيفشل عنوان URL الخاطئ فوراً بدلاً من أن يبدو متصلاً.
أدوات WhatsApp الست عشرة، وما الغرض الفعلي من كل منها
يتيح موصل واحد هذه الأدوات لكل رقم في الحساب، إلى جانب أدوات القنوات الأخرى. تأتي list_numbers أولاً لأن كل أداة أخرى في WhatsApp تأخذ منها قيمة connection_id الخاصة بالرقم.
list_numbersالأرقام المتصلة مع حالتها وتقييم الجودة ومستوى المراسلة. نقطة البداية لكل شيء آخر.get_number_healthلقطة مباشرة من Meta مع سجل المراقبة الأخير: أحداث webhook وفحوصات الاستطلاع الدوري معاً.get_api_credentialsعنوان URL الأساسي لـ Graph API، وWABA id، وphone number id، ورمز الوصول الخاص بالحساب عند توفره.
send_messageنص حر، وفقط داخل نافذة خدمة العملاء البالغة 24 ساعة. الردود داخل هذه النافذة مجانية.send_templateالطريقة التي تبدأ بها محادثة مع شخص لم يراسلك أولاً.list_templatesالقوالب الموجودة في الحساب مع حالة مراجعتها.create_templateترسل القالب إلى Meta للمراجعة. UTILITY أو MARKETING أو AUTHENTICATION، مع متغيرات بنمط {{1}} تحتاج إلى قيم نموذجية.get_template_statusAPPROVED أو PENDING أو REJECTED، حسب اسم القالب.
set_webhook_destinationتوجّه الرسائل الواردة وأصداء تطبيق الهاتف من Meta مباشرةً إلى نظامك. مرّر null لإعادة ضبطها.get_connect_linkتعيد رابط لوحة التحكم وخطوات ربط رقم جديد، لأن الإعداد يحتاج إلى متصفح.get_docsتوثيق المنتج الكامل بصيغة markdown، ليجيب المساعد من توثيقنا بدلاً من التخمين.
get_partner_setupأين وصل إعداد Partner API: الفوترة، ومفتاح API، وعنوان URL للأحداث، والخطوة التالية.create_api_keyتُصدر مفتاح Partner API وتعرضه مرة واحدة فقط. لا تستبدل مفتاحاً موجوداً إلا بعد تأكيدك.revoke_api_keyتُلغي مفتاح Partner API بعد تأكيدك. ومن بعدها يفشل كل طلب يُرسل به.set_partner_events_urlتحدد وجهة أحداث حالة الاتصال وتعيد سرّ التوقيع، الذي يُعرض مرة واحدة فقط.create_connect_linkتنشئ رابط ربط مستضافاً لأحد عملائك، صالحاً لمدة ساعة واحدة. يُحتسب الرقم على حسابك.
ما الذي يستمر في العمل عند توقف الدفع
تُقيَّد الأدوات التي تؤثر في العالم الخارجي، ومعها get_api_credentials لأنها تسلّم رمز الوصول الذي يُرسَل به. أما قراءة الصحة والحالة فتبقى متاحة عن قصد.
list_numbersget_number_healthget_template_statuslist_templatesget_connect_linkget_docsget_partner_setupcreate_api_keyrevoke_api_keyset_partner_events_url
send_messagesend_templatecreate_templateset_webhook_destinationget_api_credentialscreate_connect_link
الحساب الذي لا يستطيع أن يرى سبب إيقافه، أو لا يستطيع التحقق من سلامة أرقامه، لا يملك طريقاً للعودة إلا تذكرة دعم. وهاتان القراءتان هما أيضاً ما تعتمد عليه مراقبة الحالة نفسها.
الزوج المهم إذا كنت تخدم أنشطة تجارية أخرى
تعيد get_connect_link الرابط الذي يفتحه العميل لإرفاق رقمه الخاص، وتوجّه set_webhook_destination ذلك الرقم إلى نظامك لحظة اتصاله. ومعاً تعنيان أن الوكيل يستطيع إعداد عميل من البداية إلى النهاية دون أن يفتح أحد لوحة التحكم.
يستوعب الحساب الواحد العدد الذي تحتاجه من الأرقام، ويُحتسب كل رقم على حدة، وتعيد list_numbers جميعها مع قيمة connection_id التي تأخذها كل أداة أخرى.
أدوات القراءة والإرسال والقوالب والربط والتوثيق وPartner API، وكلها مدرجة أدناه.
معدل إرسال ثابت لرقم Coexistence، تحدده Meta ولا يمكننا أو يمكنك زيادته.
المدة التي تبقي ردود العميل خلالها الجلسة مفتوحة. خارجها لا يمكن إرسال إلا قالب معتمد.
الخادم بعيد، لذلك لا يعمل شيء على جهازك ولا تُحتفظ جلسة في أي مكان.
الأسئلة الشائعة
هل يمكن حظر رقم عميلي بسبب هذا؟
لا. هذا هو Cloud API الرسمي من Meta، ويتم الوصول إليه عبر ميزة Coexistence الخاصة بـ Meta. يأتي خطر الحظر الذي يتحدث عنه الناس من بوابات غير رسمية تسجل الدخول كجهاز مرتبط، وهي آلية مختلفة تماماً.
مع أي مساعدين يعمل الموصل؟
مع كل ما يتحدث عبر MCP باستخدام HTTP وOAuth: Claude وChatGPT وCursor وClaude Code وCodex حالياً. إنها نقطة نهاية (endpoint) بعيدة واحدة، لذلك لا يعمل شيء على جهازك.
هل تمر محادثاتي عبر خوادمكم؟
ليس افتراضيًا. تنتقل الرسائل الواردة من Meta مباشرةً إلى خطاف الويب الذي تحدده، ولا نخزن محتوى المحادثات. نحتفظ فقط بالحساب وحالة الرقم وبيانات الاعتماد اللازمة لتشغيل الاتصال ومراقبته.
هل يمكنني استخدام موصل واحد لعدة عملاء؟
نعم. يمكن للحساب الواحد استيعاب العدد الذي تحتاجه من الأرقام، ويُحتسب كل رقم كاتصال مستقل، ويعرض الموصل جميع الأرقام. لا يوجد قيد على استخدامه مع الأنشطة التجارية التي تخدمها.
هل أنت مستعد للبدء؟
أعد إعداد WhatsApp Coexistence خلال دقائق، وليس أشهر. يواصل التطبيق العمل على الهاتف.
ابدأ الفترة التجريبية المجانية3 أيام مجاناً. لا يُخصم أي مبلغ حتى تنتهي الفترة التجريبية.