تسجيل الدخولابدأ الفترة التجريبية المجانية
Meta Tech Provider

أنشئ بوت WhatsApp مع Claude Code أو Codex، على الرقم الذي تحتفظ به في التطبيق

أضف خادم WhatsApp MCP إلى Claude Code أو Codex، ودع وكيل البرمجة يتولى الإعداد: يقرأ بيانات اعتماد Cloud API الخاصة بالرقم، ويُنشئ مستقبِل خطاف الويب (webhook)، ويوجّه الرسائل الواردة إليه، ويرسل ردًا تجريبيًا إلى من راسلك خلال آخر 24 ساعة. ما ستحصل عليه في النهاية هو وكيلك الخاص، يعمل ككودك على خادمك.

يربط easyCoexistence رقم WhatsApp Business الذي تحتفظ به في التطبيق بـ Cloud API من Meta عبر Coexistence، ويمنح Claude Code و Codex أكثر من 30 أداة MCP للبناء بها: بيانات الاعتماد والتوجيه والقوالب وإرسال الرسائل التجريبية والأتمتة.

--scope user

الخيار في Claude Code الذي يحمّل الخادم في جميع مشاريعك؛ فالنطاق المحلي الافتراضي يحمّله فقط حيث أُضيف.

codex mcp login

أمر في Codex يخزّن تسجيل الدخول عبر OAuth للخادم؛ ومن دون بيانات اعتماد يستطيع Codex الاتصال دون مصادقة.

HTTPS

ما يجب أن تستخدمه وجهة webhook المباشرة، وعليها إعادة hub.challenge في مصافحة GET التي تجريها Meta للتحقق منها.

20 seconds

المدة التي تنتظر فيها خطوة «Call my webhook» ردّ نقطة النهاية (endpoint) الخاصة بك بالصيغة {"reply"} قبل أن تفشل الخطوة.

24 hours

نافذة خدمة العملاء تبدأ بعد آخر رسالة من المستخدم؛ وخارجها لا يقبل Meta إلا رسائل القوالب.

20 msg/s

الإنتاجية الثابتة لرقم يُستخدم مع تطبيق WhatsApp Business و Cloud API معًا.

ما الذي يحتاجه وكيل البرمجة لبناء وكيل WhatsApp؟

أربعة أشياء. رقم WhatsApp Business مربوط بـ Cloud API من Meta عبر Coexistence، فيبقى التطبيق على الهاتف بينما يستطيع الكود الإرسال والاستقبال. واتصال MCP من Claude Code أو Codex بهذا الرقم، وهو ما يتيح لوكيل البرمجة قراءة بيانات الاعتماد وتغيير التوجيه وإرسال رسائل تجريبية دون أن تفتح لوحة التحكم. وعنوان HTTPS عام للمستقبِل، من خادم تنشر عليه أو من نفق أثناء التطوير. ومفتاح لنموذج الذكاء الاصطناعي الخاص بالوكيل الذي تبنيه.

فرّق بين الوكيلين في ذهنك. Claude Code أو Codex هو البنّاء: يعمل فقط حين تعمل معه في الطرفية. أما البرنامج الذي يكتبه فهو الذي يجيب العملاء، ويستمر في العمل بعد أن تغلق الجلسة.

كيف تضيف أدوات WhatsApp إلى Claude Code و Codex؟

تأخذ كل منهما عنوان URL واحدًا من الطرفية، وتسجّل الدخول عبر OAuth، فلا يُحفظ أي مفتاح في ملف. في Claude Code، أضف الخادم مع --scope user ليُحمَّل في كل مشروع، ثم شغّل claude، ونفّذ /mcp، واختر easycoexistence، وسجّل الدخول في المتصفح. أما في Codex فأضف الخادم ونفّذ codex mcp login، فيُخزَّن تسجيل الدخول، ويعرض codex mcp list ما هو مُعدّ. ويحفظ Codex الإدخال في ~/.codex/config.toml، الذي يقرؤه تطبيق ChatGPT لسطح المكتب وإضافة Codex لبيئات IDE أيضًا.

تأكد من نجاح الإعداد بطلب شيء لا تستطيع الإجابة عنه إلا الأدوات، مثل «اعرض أرقام WhatsApp الخاصة بي». فيستدعي الوكيل list_numbers ويحصل على connection_id لكل رقم، وهو ما تحتاجه كل أداة أخرى.

Add the server, then sign in
# Claude Code: then start claude and run /mcp to sign in
claude mcp add --transport http easycoexistence --scope user https://easycoexistence.com/api/mcp

# Codex: add, store the OAuth sign-in, check
codex mcp add easycoexistence --url https://easycoexistence.com/api/mcp
codex mcp login easycoexistence
codex mcp list

أي مسار يجب أن يبنيه الوكيل؟

ثلاثة مسارات توصل رسالة العميل إلى كودك، وتختلف في مقدار ما يجب على الكود أن يتعامل معه. للنسخة الأولى، خطوة Call my webhook هي الأقصر: يتجاهل easyCoexistence الرسائل المكررة، ويتراجع عندما ترد من الهاتف، ويتحقق من نافذة الـ24 ساعة قبل استدعاء نقطة النهاية الخاصة بك، فلا يكتب كودك إلا الرد. انتقل إلى Forward URL أو إلى وجهة مباشرة حين يحتاج الوكيل إلى كل الأحداث، لا إلى الرسائل التي تختارها الأتمتة وحدها.

Call my webhook stepAn automation POSTs the message and the chat's last 10 messages, signed; return {"reply": "..."} within 20 seconds
Forward URL (Automations on)A signed copy of each Meta event goes to your code; automations keep running; you send through the Graph API
Direct destinationMeta posts straight to your endpoint; easyCoexistence never sees the messages; automations stop for that number

ماذا تطلب من وكيل البرمجة أن يفعل؟

أعطه المسار واللغة والقواعد من البداية، واطلب خطة قبل أن يكتب أي كود. حدّد له استدعاءات الأدوات التي يجوز له تنفيذها بمفرده: قراءة بيانات الاعتماد والوثائق لا تضر، أما تغيير وجهة الرسائل فيؤثر على الرقم الحي. تعيد get_docs وثائق easyCoexistence، بما في ذلك طريقة مصادقة المستقبِل لعمليات التسليم، فيقرأ الوكيل القواعد بدل أن يخمّنها. يُنتج طلب بهذا الشكل مستقبِلًا يمكنك مراجعته في جلسة واحدة:

A request for Claude Code or Codex
Build a WhatsApp agent in Node.js for my number +55 11 4000 1234.
1. Call list_numbers, then get_api_credentials for that number.
   Put send_endpoint and access_token in .env, never in code.
2. Scaffold an HTTPS server with POST /wa/<long random path>.
   Verify X-EC-Signature (HMAC-SHA256 of "<t>.<raw body>").
   Skip message ids already handled.
   On smb_message_echoes, stay quiet on that chat for 4 hours.
3. Reply with my model only within 24 hours of the
   customer's last message.
4. Write tests for the signature check and the 24-hour rule.
Do not call set_inbound_mode or set_webhook_destination
until I say so.

كيف تربط المستقبِل وتختبره؟

شغّل الخادم في مكان تصل إليه Meta وeasyCoexistence عبر HTTPS، ثم دع الوكيل يتولى التوجيه. في مسار Forward URL يستدعي الوكيل set_inbound_mode مع عنوانك على رقم موجود في Automations بوضع on، فيُعاد السر (forward secret) مرة واحدة فقط، ويكتبه الوكيل في ملف .env. أما المسار المباشر فيجب أن تجيب نقطة النهاية أولًا على مصافحة GET من Meta، ثم يستدعي الوكيل set_webhook_destination بالعنوان، ومعه سر طويل عشوائي في مساره، ورمز التحقق (verify token) الخاص بك.

للاختبار، راسل رقم النشاط التجاري من هاتفك وراقب السجلات: يجب أن يلتقط المستقبِل الحدث، ويجيب النموذج، ويظهر الرد في المحادثة. ولأنك كتبت للتو، فنافذة الـ24 ساعة مفتوحة، فيمكن للوكيل أيضًا أن يجرب send_message إلى رقمك الخاص.

هل يحتاج الوكيل المنشور إلى خادم MCP؟

لا. خادم MCP أداة البنّاء، ويعمل باسمك. أما الوكيل الذي تنشره فيرسل عبر Graph API من Meta باستخدام send_endpoint وaccess_token اللذين أعادهما get_api_credentials، وهو رمز الوصول (token) الخاص بالنشاط التجاري ومحدّد النطاق بأصول WhatsApp الخاصة به، ويستقبل عبر المسار الذي أعددته. إذا عادت قيمة access_token فارغة null، فأعد ربط الرقم من لوحة التحكم ليصدر رمز جديد، دون أن يُستبدل رمز يعمل بالفعل.

أبقِ اتصال MCP للعمل المحيط بالوكيل: إنشاء القوالب بـ create_template، وفحص get_number_health عندما يبدو أن هناك خللًا، وقراءة سجل تشغيل أي أتمتة تسلّم الرسائل إلى كودك.

كيفية إعداده

  1. Connect your numberAt easycoexistence.com, run Meta's Embedded Signup and scan the code with the WhatsApp Business app; the app keeps its chats.
  2. Add the server to your coding agentRun the claude mcp add or codex mcp add command, then sign in with /mcp in Claude Code or codex mcp login in Codex.
  3. Ask for credentials and a planHave the agent call list_numbers and get_api_credentials, store the values in .env and propose the receiver before writing it.
  4. Expose the receiver over HTTPSDeploy it, or run a tunnel while developing, and confirm the URL answers from outside your machine.
  5. Route the messagesLet the agent call set_inbound_mode with a Forward URL, or set_webhook_destination for the direct route, once you approve.
  6. Test from your phoneSend the business number a message and check that your agent's reply arrives in the same chat.

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

  • حفظ نفق مؤقت كوجهة مباشرة خلال أول 24 ساعة. فاستيراد Meta لمرة واحدة لجهات الاتصال وما يصل إلى 6 أشهر من المحادثات يُرسل إلى هذا العنوان، ويضيع عند إغلاق النفق.
  • ضبط وجهة مباشرة على رقم يشغّل أتمتات. يتحوّل الرقم إلى المسار المباشر وتتوقف أتمتاته؛ استخدم Forward URL في Automations بوضع on للإبقاء على كليهما.
  • إيداع (commit) ملف .env الذي كتبه الوكيل في Git. أضفه إلى .gitignore أولًا، فكل من يحمل رمز الوصول يستطيع مراسلة العملاء باسم النشاط التجاري.
  • اختبار send_message مع جهة اتصال لم تكتب خلال 24 ساعة. ترفض Meta النص الحر خارج النافذة، لذا راسل الرقم من هاتفك أولًا.
إنجاز ذلك باستخدام EasyCoexistence

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

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

هل يعمل هذا مع Cursor أو أدوات البرمجة الأخرى؟

نعم. أي عميل MCP يتصل بالخوادم البعيدة عبر Streamable HTTP مع OAuth يستطيع استخدام عنوان URL نفسه، ومنه Cursor وVS Code وGemini CLI وAntigravity. يتغير شكل الإعداد فقط من عميل إلى آخر.

بأي لغة يجب أن يكتب الوكيل؟

بأي لغة تستطيع تقديم HTTPS وحساب HMAC-SHA256. Node.js وPython هما الخياران الشائعان، وتوجد عيّنات مختبرة لكليهما تشمل فحص التوقيع ومعالجة الرسائل المكررة والتوقف المؤقت عند الرد من الهاتف، ضمن صفحة وكيل Node.js وPython.

هل أحتاج إلى تطبيق خاص بي على Meta، أو إلى مراجعة من Meta للتطبيق؟

لا. ينضم الرقم إلى Cloud API عبر تطبيق Meta الخاص بـ easyCoexistence، ويبقى في Business Portfolio الخاصة بالنشاط التجاري نفسه. والرمز الذي يرسل به كودك هو رمز الوصول الخاص بالنشاط التجاري، ولا علاقة لتطبيق Meta خاص بك به.

هل يستطيع وكيل البرمجة إنشاء القوالب التي يحتاجها الوكيل؟

نعم، بـ create_template، ثم get_template_status حتى ترد Meta، وغالبًا خلال دقائق، وعلى الأكثر نحو 24 ساعة. يحتاج وكيلك إلى قالب معتمد لبدء محادثة أو للكتابة بعد إغلاق نافذة الـ24 ساعة.

تابع القراءة

بناء وكيل ذكاء اصطناعي لـ WhatsApp بـ Node.js وPython على رقم Coexistenceكود Node.js وPython لوكيل ذكاء اصطناعي على رقم Coexistence: التحقق من الأحداث الموقّعة، والتوقف عند رد شخص، وتجاهل التكرار، وفحص نافذة 24 ساعة.WhatsApp في أي عميل MCP: Gemini CLI وVS Code وCursor وDevin Desktop (Windsurf) وغيرهاأضف خادم WhatsApp MCP البعيد إلى Cursor وVS Code وGemini CLI وAntigravity وZed وCline وDevin: مفتاح الإعداد لكل عميل وتسجيل الدخول عبر OAuth.أدوات WhatsApp لا تظهر في ChatGPT أو Claude: الحلولحلول لاختفاء أدوات WhatsApp في ChatGPT وClaude وClaude Code وCodex: تسجيل الدخول، التفعيل لكل محادثة، حدود الخطة، قائمة قديمة ورفض الفوترة.أفضل الطرق لربط الذكاء الاصطناعي بـ WhatsApp في 2026مقارنة بين خمس طرق لربط الذكاء الاصطناعي برقم WhatsApp Business في 2026: موصل MCP، وردود بمفتاحك الخاص، وwebhook، وتطبيق Meta خاص بك، وأدوات غير رسمية.كيف تصل رسائل WhatsApp إلى خادمك: مباشرة أو مُدارة، والتحقق من التوقيعمباشرة: تنشر Meta إلى خادمك. مُدارة: ترد الأتمتة، وتصل نسخة موقّعة إلى عنوان URL للتوجيه. الحمولة، وتوقيع X-EC-Signature في Node وPython، وإعادة المحاولة.ربط WhatsApp بـ Claude Code عبر MCPأضف EasyCoexistence إلى Claude Code بأمر واحد، ليرسل الوكيل رسائل WhatsApp ويدير القوالب ويربط خطافات الويب من الطرفية.

هل أنت مستعد للبدء؟

أعد إعداد WhatsApp Coexistence خلال دقائق، وليس أشهر. يواصل التطبيق العمل على الهاتف.

ابدأ الفترة التجريبية المجانية

تم التحقق في