WhatsApp API لوكلاء الذكاء الاصطناعي: وصول رسمي في دقائق دون أن تصبح Tech Provider
يحصل وكيل الذكاء الاصطناعي على وصول رسمي عبر Cloud API من Meta، ويُضاف إليه رقم يبقى في تطبيق WhatsApp Business عبر Tech Provider أو Solution Partner. يمكنك أن تصبح أحدهما عبر التحقق من النشاط التجاري وفيديوهات App Review وبناء Embedded Signup، أو أن تتصل عبر مزوّد يملك هذه الصفة بالفعل: ينضم الرقم في دقائق ويحصل الوكيل على أدوات MCP أو بيانات اعتماد واجهة برمجة التطبيقات (API).
easyCoexistence مزوّد Tech Provider مستقل لدى Meta: يربط رقم WhatsApp Business بـ Cloud API عبر Coexistence في دقائق، فيحصل وكيلك على وصول رسمي بينما يحتفظ النشاط التجاري بالتطبيق.
ما تشترطه Meta على من يضيف رقمًا يبقى في تطبيق WhatsApp Business: صفة Tech Provider أو Solution Partner.
تطلب App Review فيديو واحدًا لرسالة أُرسلت من تطبيقك، وآخر لتطبيقك وهو ينشئ قالبًا.
ما تمنحه App Review للصلاحيتين whatsapp_business_messaging وwhatsapp_business_management، وكلتاهما لازمة لتصبح Tech Provider.
حين أعلنت Meta إيقاف Embedded Signup v2 وv3، وطلبت من التكاملات الانتقال إلى v4.
معدل الإرسال الثابت لرقم يُستخدم مع تطبيق WhatsApp Business وCloud API معًا.
المدة التي يبقى فيها رابط الربط المستضاف صالحًا عندما تربط منصة رقم عميلها عبر Partner API.
ما الذي يحتاجه وكيل الذكاء الاصطناعي لاستخدام WhatsApp بشكل رسمي؟
أربعة أشياء من Cloud API الخاصة بـ Meta. معرّف رقم الهاتف، ورمز الوصول (token) مع صلاحية whatsapp_business_messaging، ليتمكن الوكيل من استدعاء نقطة النهاية (endpoint) الخاصة بالرسائل. ونقطة استقبال webhook تُسلّم إليها Meta الرسائل الواردة، إضافةً إلى smb_message_echoes في الرقم المشترك مع التطبيق، لتصل الردود التي يكتبها شخص من الهاتف. وقوالب معتمدة، لأن الرسالة المكتوبة لا تصل إلا إلى من راسلك خلال آخر 24 ساعة. وطريقة لمعرفة لحظة انقطاع الاتصال، لأن التطبيق على الهاتف يستمر في العمل حين يتوقف جانب API.
الاختصار الذي يجده الناس أولًا هو أتمتة WhatsApp Web، وهي تسجّل الدخول كجهاز مرتبط. وهذا يخالف شروط WhatsApp ويعرّض الرقم لخطر الحظر، مهما فعل الوكيل الذي يعمل فوقها.
ماذا يتضمّن مسار Tech Provider؟
تسلسل Meta نفسه، بهذا الترتيب. كل خطوة مجانية، ولا يمكن شراء أيٍّ منها لتتم أسرع: المراجعات تسير وفق جدول Meta، ولا تنشر Meta أي جدول زمني، لذا خطّط لأسابيع لا لأيام قبل أن يتصل رقم أول عميل. وبعد ذلك يجب أن تبقى الواجهة الخلفية تعمل: تبادل الرمز (token) بعد كل عملية تسجيل، ومستقبِل webhook، والتوجيه حسب الرقم، ومراقبة حالات الانقطاع، مثل قاعدة Meta الخاصة بعدم النشاط لمدة 14 يومًا.
ما هو المسار المختصر؟
اربط الرقم عبر مزوّد سبق أن أتمّ هذه العملية. مع easyCoexistence، ينفّذ النشاط التجاري Embedded Signup الخاص بـ Meta ويمسح رمز QR بتطبيق WhatsApp Business، وهذا يستغرق نحو دقيقتين، فينضم الرقم إلى Cloud API ضمن Business Portfolio الخاصة بالنشاط التجاري، ويستمر التطبيق في العمل. ثم يحصل الوكيل على الوصول بالصيغة التي يتعامل بها: أدوات MCP لمساعد مثل ChatGPT أو Claude أو Claude Code أو Codex، أو بيانات اعتماد الرقم وwebhooks للكود الذي تشغّله.
| Connect through easyCoexistence | Become a Tech Provider | |
|---|---|---|
| Meta app and App Review | Not needed: the number joins through ours | Yours to build and pass |
| Embedded Signup | Hosted, with the QR scan in the app | You integrate version 4 and host the flow |
| First number connected | Minutes after signing up | After verification and review |
| Webhook trust | A secret in your URL, or X-EC-Signature on forwarded messages | Your app secret signs Meta's deliveries |
| Disconnection alerts | Every number watched 24/7, 14-day rule included | Monitoring you build and run |
| Who owns the WhatsApp Business Account | The business, in its own portfolio | The business |
كيف يحصل الوكيل على بيانات اعتماد الرقم؟
عبر الأداة get_api_credentials، أو من صفحة الرقم في لوحة التحكم. تُعيد الأداة عنوان URL الأساسي لـ Graph API، ومعرّف حساب WhatsApp Business، ومعرّف رقم الهاتف، ونقطة نهاية الإرسال، وعند وجوده، رمز الوصول الخاص بالنشاط التجاري ضمن نطاق أصول WhatsApp الخاصة به. وإذا لم يُصدر رمز للعميل، يعود الرمز null مع ملاحظة أن إعادة ربط الرقم من لوحة التحكم تُصدر رمزًا، دون استبدال رمز يعمل. ولا يوجد سر تطبيق لاسترجاعه، لأن Meta توقّع تسليمات webhook بسر تطبيق easyCoexistence الذي لا يُشارك أبدًا. وتحتاج الأداة إلى خطة نشطة، لأن الرمز قادر على الإرسال.
curl -X POST "$SEND_ENDPOINT" \
-H "Authorization: Bearer $ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"messaging_product": "whatsapp",
"to": "5511999998888",
"type": "text",
"text": { "body": "Your order #1042 is ready for pickup." }
}'كيف تصل الرسائل الواردة إلى الوكيل؟
لكل رقم وضعان، يُبدَّل بينهما عبر الأداة set_inbound_mode أو من صفحة الرقم. الإرسال المباشر إلى خادمك: توجّه set_webhook_destination رسائل Meta مباشرة إلى نقطة نهاية HTTPS الخاصة بك، ويجب أن تستجيب لطلب GET الخاص بمصافحة Meta، ولا يرى easyCoexistence الرسائل أبدًا، لذلك تكون الأتمتات متوقفة. ولأن Meta توقّع هذه التسليمات بسر تطبيق easyCoexistence، ضع سرًا عشوائيًا طويلًا في مسار الرابط وارفض الطلبات التي لا تحمله.
الأتمتات مفعّلة: تُسلّم Meta الرسائل إلى easyCoexistence، ويمكن للأتمتات أن ترد، ويتلقى رابط Forward URL الاختياري الحمولة الأصلية من Meta تحت المفتاح "value"، موقّعة بالترويسة X-EC-Signature: t=<unix>,v1=<HMAC-SHA256 of "<t>.<body>">، باستخدام سر يظهر مرة واحدة فقط. وتمرّر خطوة "Call my webhook" في الأتمتة الرسالة وآخر 10 رسائل من المحادثة إلى وكيلك، وترسل ردّه عندما تكون إجابتك {"reply": "..."} خلال 20 ثانية.
ما الحدود التي على الوكيل احترامها؟
هي حدود Meta، وهي نفسها عبر أي مزوّد. الوكيل الذي يعرفها مسبقًا يتجنب الأعطال التي تبدو كأخطاء برمجية:
- 20 رسالة في الثانية لكل رقم، تحددها Meta للأرقام المشتركة مع تطبيق WhatsApp Business.
- الرسائل المكتوبة فقط خلال 24 ساعة من آخر رسالة للعميل؛ بعد ذلك، قالب معتمد.
- تُرسل القوالب عبر API وحدها، لأن التطبيق على رقم Coexistence لا يستطيع إرسالها.
- الردود التي يكتبها الشخص في التطبيق تصل كـ
smb_message_echoes؛ أوقف الوكيل في تلك المحادثة، وإلا تلقى العميل ردّين. - لا تُزامن محادثات المجموعات مع API، لذا يعمل الوكيل في المحادثات الفردية.
- تُستورد جهات الاتصال وحتى 6 أشهر من المحادثات الفردية مرة واحدة فقط، إذا حُفظت وجهة webhook مباشرة خلال 24 ساعة من الربط؛ والرقم الذي تعمل عليه الأتمتات لا يحصل على هذا الاستيراد.
- المكالمات الصوتية والمرئية تستمر في العمل داخل التطبيق، لكن Cloud API لا تنقل المكالمات على رقم Coexistence، لذا يعمل الوكيل بالنص.
هل يمكن لمنصة أن تربط أرقام عملائها بهذه الطريقة؟
نعم، عبر Partner API، وهي الطريقة التي تربط بها منصة SaaS أو وكالة أرقام عملائها دون أن تملك صفة Tech Provider خاصة بها. أنشئ المفتاح بالأداة create_api_key (يبدأ بـ ec_live_ ويظهر مرة واحدة)، ثم استدعِ POST /api/v1/connect-sessions من خادمك، أو create_connect_link من المساعد، لتحصل على رابط ربط مستضاف صالح لمدة ساعة واحدة. ينفّذ العميل نافذة Meta المنبثقة ومسح رمز QR هناك، ثم يعود إلى redirect_url الخاص بك مع connection_id. بعدها يُعيد الطلب GET /api/v1/connections/:id?credentials=1 رمز العميل الخاص به، وتصل أحداث الحالة مثل connection.disconnected موقّعة بالترويسة X-EC-Signature. يُحتسب كل رقم على حسابك وفق الشرائح نفسها لكل رقم.
الأخطاء الشائعة
- التحقق من X-Hub-Signature-256 على وجهة مباشرة. توقّع Meta بسر تطبيق easyCoexistence الذي لا يُشارك أبدًا، فتفشل التسليمات الصحيحة في هذا الفحص؛ فاعتمد على سر عشوائي طويل في الرابط، أو استخدم التمرير مع X-EC-Signature.
- الاستقبال بعقدة WhatsApp Trigger في n8n. تتوقع هذه العقدة تطبيق Meta الخاص بك؛ استخدم بدلها عقدة Webhook العامة مع سر في رابطها.
- تجاهل smb_message_echoes. فيرد الوكيل فوق شخص سبق أن ردّ من الهاتف، فيقرأ العميل ردّين.
- حفظ وجهة webhook المباشرة بعد أيام من الربط، أو ترك الرقم على الأتمتات. يحتاج الاستيراد الذي تجريه Meta مرة واحدة لجهات الاتصال وحتى 6 أشهر من المحادثات إلى وجهة مباشرة محفوظة خلال 24 ساعة من الربط.
يعمل الوكيل عبر أكثر من 30 أداة MCP، أو عبر بيانات اعتماد كل رقم وwebhooks الخاصة به، ويُراقَب كل رقم على مدار الساعة مع تنبيهات. من US$ 9 إلى US$ 0.75 لكل رقم شهريًا، ينخفض كلما أضفت أرقامًا، مع أول 3 أيام مجانًا.
الأسئلة الشائعة
هل أحتاج إلى تطبيق Meta خاص بي؟
لا. يُضاف الرقم عبر تطبيق Meta الخاص بـ easyCoexistence، ويبقى في Business Portfolio الخاصة بالنشاط التجاري وفي حساب WhatsApp Business الخاص به. يرسل كودك باستخدام رمز الوصول الخاص بالنشاط التجاري من get_api_credentials، فلا يدخل أي تطبيق خاص بك ما لم تبنِ واحدًا لاحقًا.
هل يمكن للوكيل والفريق استخدام الرقم في الوقت نفسه؟
نعم. تعكس Meta الرسائل بين Cloud API وتطبيق WhatsApp Business، فما يرسله الوكيل يظهر في سلسلة المحادثة داخل التطبيق على الهاتف، وما يكتبه الفريق في التطبيق يصل إلى نظامك كـ smb_message_echoes.
أي أطر عمل للوكلاء تعمل معه؟
أي عميل يتحدث MCP عبر HTTP مع OAuth، مثل ChatGPT وClaude وClaude Code وCodex وCursor، وأي كود يستدعي Graph API الخاصة بـ Meta: Node.js وPython وn8n وLangChain وOpenAI Agents SDK أو Vercel AI SDK. أما الواجهة التي تحته فهي من Meta نفسها، فلا يوجد أي عنصر مملوك لجهة بعينها داخل الوكيل.
هل يُسمح بمساعد ذكاء اصطناعي عام الأغراض على WhatsApp؟
تمنع المادة 4.7 من شروط حلول الأعمال الخاصة بـ Meta مزوّدي مساعدي الذكاء الاصطناعي عامّي الأغراض من تقديمهم على منصة WhatsApp Business حين يكون الذكاء الاصطناعي الوظيفة الأساسية، حسبما تقرره Meta، ويسري ذلك منذ 15 يناير 2026. ولا يستهدف ذلك نشاطًا تجاريًا يستخدم الذكاء الاصطناعي مع عملائه، في الدعم أو المبيعات أو الحجوزات، وقد أمرت الجهات التنظيمية في الاتحاد الأوروبي والبرازيل Meta بتعليق القاعدة أو التراجع عنها فيما يخص المساعدين المنافسين.
تابع القراءة
هل أنت مستعد للبدء؟
أعد إعداد WhatsApp Coexistence خلال دقائق، وليس أشهر. يواصل التطبيق العمل على الهاتف.
ابدأ الفترة التجريبية المجانيةتم التحقق في