واتساب API للمطورين: إرسال بـREST، واستقبال الأحداث بويب هوك، ومفتاح بصلاحيات — من غير أن تكلّم ميتا
في هذه الصفحة 6
الإجابة المختصرة
بمفتاح API تولّده من اللوحة بصلاحيات تحددها، ثم طلب REST واحد يرسل رسالة نصية أو قالبًا معتمدًا إلى رقم، ونقاط لقراءة المشتركين والقوالب المعتمدة، وويب هوك صادر يُرسل إلى عنوانك حدث الرسالة الواردة وما تختاره من أحداث — وكل ذلك فوق الواجهة الرسمية من ميتا، فلا رقم يُحظر بسبب أداة غير رسمية. لا تحتاج أن تكلّم ميتا مباشرة: الاعتماد والقوالب والنافذة والأسعار تُدار من المنصة، ونظامك يرى واجهة واحدة.
الإجابة المختصرة
بمفتاح API تولّده من اللوحة بصلاحيات تحددها، ثم طلب REST واحد يرسل رسالة نصية أو قالبًا معتمدًا إلى رقم، ونقاط لقراءة المشتركين والقوالب المعتمدة، وويب هوك صادر يُرسل إلى عنوانك حدث الرسالة الواردة وما تختاره من أحداث — وكل ذلك فوق الواجهة الرسمية من ميتا، فلا رقم يُحظر بسبب أداة غير رسمية. لا تحتاج أن تكلّم ميتا مباشرة: الاعتماد والقوالب والنافذة والأسعار تُدار من المنصة، ونظامك يرى واجهة واحدة.
يُسأل عنها أيضًا: «واتساب api للمبرمجين» · «webhook واتساب» · «ازاي ابعت رسالة واتساب من الكود» · «ربط واتساب api بالنظام»
الأبواب الأربعة المفتوحة اليوم — وما ليس مفتوحًا
| الباب | الاتجاه | المصادقة | يفعل |
|---|---|---|---|
| ويب هوك استقبال الطلبات | نظامك ← المنصة | مفتاح في العنوان | يشغّل تأكيد الطلب ورسائل الحالة لمتجر على أي منصة |
| ويب هوك أحداث السلة | نظامك ← المنصة | سر + توقيع HMAC، أو مفتاح | يشغّل تذكير السلة المتروكة |
| واجهة OTP | نظامك ← المنصة | مفتاح عام + سر للتطبيق | إرسال رمز التحقق على واتساب والتحقق منه وإعادة إرساله |
| أدوات الوكيل: ويب هوك وMCP | المنصة ← نظامك | ترويسات تحددها أنت (مشفّرة عندنا) | الوكيل يقرأ الطلبات والمخزون والمواعيد الحية من نظامك ويجيب منها |
| واجهة REST عامة (إرسال، مشتركون، بث، قوالب) | — | — | ليست مفتوحة بعد — على خارطة الطريق، بلا مفاتيح تُصدر |
١. استقبال الطلبات من أي نظام
للمتاجر التي ليست على شوبيفاي أو ووكومرس: نظامك يرسل حدث الطلب إلى عنوان استقبال خاص بحسابك، فتعمل رسائل التأكيد قبل الشحن وتحديثات الحالة كما تعمل للمتاجر المربوطة. العنوان والمفتاح من صفحة إعدادات تأكيد الطلبات، وشكل الحقول بدقة في تبويب مرجع API داخل اللوحة.
POST https://app.arabybot.com/wa_notify_webhook/api/{api_key}
Content-Type: application/json
{ "order_id": "1042", "status": "created",
"customer": { "name": "…", "phone": "+2010…" },
"items": [ { "name": "…", "qty": 1, "price": 350 } ],
"total": 350, "currency": "EGP" }
الأسماء الدقيقة للحقول ومتى يُرسل كل حدث (إنشاء، تأكيد، شحن، تسليم، إلغاء) في المرجع داخل اللوحة — لا ننسخها هنا لئلا تتقادم.
٢. أحداث السلة
حدث «سلة أُنشئت» و«سلة تُركت» من متجرك يشغّل رسائل الاسترجاع بالتوقيت الذي تحدده. طريقتان: عنوان بسرّ وتوقيع HMAC للمنصات التي نوفّر لها إضافة، أو عنوان بمفتاح لنظامك الخاص. استرجاع السلة.
٣. واجهة OTP
ثلاث نقاط: إرسال الرمز، والتحقق منه، وإعادة إرساله — بمفتاح عام وسر لتطبيقك من صفحة OTP. الرمز يصل بقالب مصادقة معتمد بسعر ميتا لبلد المستلم، وهو أرخص من الرسائل النصية في أغلب دولنا. OTP على واتساب أم SMS.
POST https://app.arabybot.com/wa_otp_api/send { "phone": "+9665…", "app_key": "…", "secret": "…" }
POST https://app.arabybot.com/wa_otp_api/verify { "phone": "+9665…", "code": "482913", … }
POST https://app.arabybot.com/wa_otp_api/resend { "phone": "+9665…", … }
٤. الوكيل يقرأ نظامك: أدوات ويب هوك وخوادم MCP
- عرّف الأداة
من الوكيل ← الأدوات ← إضافة: الاسم («حالة_الطلب»)، الوصف الذي يقرؤه النموذج («يعيد حالة طلب برقمه»)، عنوان URL عام، الطريقة GET أو POST. الوصف هو ما يقرر متى يستدعيها الوكيل، فاكتبه كما تشرحه لموظف.
- أعد JSON بسيطًا
حقول مسماة بوضوح وقيم نصية: {"status":"shipped","eta":"الخميس"}. الوكيل يصوغ الرد منها؛ لا تُعد HTML ولا صفحات.
- أو اربط خادم MCP
من الوكيل ← خوادم MCP ← ربط سريع: العنوان ورمز الدخول والترويسات. تُقرأ قائمة أدوات الخادم وتختار المسموح منها؛ الرموز تُحفظ مشفّرة.
- اعرف الحدود
العنوان عام فقط (لا 10.x ولا localhost)، يُحَل مرة ويُثبَّت على عنوان IP واحد، لا تُتبع التحويلات، http/https فقط، ومعدل استدعاء محدود لكل عميل. هذه حماية لنظامك ولنا معًا.
واجهة REST عامة تُرسل بها رسالة أو قالبًا من نظامك، وتقرأ المشتركين، وتنشئ بثًا، وتدير القوالب — موثّقة في اللوحة كخارطة طريق، وغير موجّهة بعد، ولا تُصدر لها مفاتيح. من يحتاج إرسالًا من نظامه اليوم يستخدم ويب هوك الطلبات (يشغّل رسائل التأكيد) أو واجهة OTP (يرسل الرمز)، أو يدع الوكيل يرد من نظامه عبر الأدوات. حين تُفتح الواجهة العامة سيتغيّر هذا الدليل والصفحة معًا.
الأسئلة الشائعة
هل توجد واجهة REST عامة لإرسال رسالة من نظامي؟
ليست مفتوحة بعد. ما يعمل اليوم أربعة أبواب: ويب هوك استقبال الطلبات، وويب هوك أحداث السلة، وواجهة OTP، واستدعاء الوكيل الذكي لنظامك (أدوات ويب هوك وخوادم MCP). واجهة الإرسال العامة على خارطة الطريق، وشاشة المطور في اللوحة تعرضها بوضوح كـ«لم تُطلق بعد» ولا تصدر لها مفاتيح.
كيف يقرأ الوكيل الذكي بيانات حية من نظامي؟
تعرّف له أداة: اسم ووصف وعنوان URL عام وطريقة (GET أو POST). حين يحتاج الوكيل ما تصفه الأداة («حالة الطلب رقم…») يستدعيها بالمعاملات ويقرأ الرد JSON ويجيب العميل منه. العنوان يجب أن يكون عامًا (لا شبكة داخلية)، ويُحَل مرة واحدة ويُثبَّت، ولا تُتبع التحويلات، والاستدعاءات محدودة المعدل لكل عميل.
ما MCP، ومتى أستخدمه بدل أداة الويب هوك؟
بروتوكول يعرض به خادمك قائمة أدواته للنموذج بصيغة واحدة. تربط عنوان الخادم ورمز الدخول من اللوحة، تُقرأ أدواته وتختار المسموح منها للوكيل. اختره حين عندك أكثر من أداتين أو نظامًا يدعمه أصلًا؛ وأداة الويب هوك حين عندك نقطة واحدة بسيطة.
متجري على منصة لا تكامل لها — كيف أرسل الطلبات؟
بويب هوك استقبال الطلبات: نظامك يرسل حدث الطلب (رقم الطلب، العميل ورقمه، الأصناف، المبلغ، الحالة) إلى عنوانك الخاص بمفتاحك، فتُشغَّل رسائل التأكيد والحالة كما لو كان المتجر مربوطًا. شكل الطلب بدقة في تبويب مرجع API داخل اللوحة.
هل تكلف الاستدعاءات شيئًا؟
الويب هوكات والاستدعاءات نفسها لا شيء. ما يُحاسَب هو ما ينتج عنها: رسالة واتساب تبدؤها أنت بقالب بسعر ميتا لبلدك، ورد الوكيل الذكي بحسب باقتك. الأسعار.
اقرأ بعدها
جرّب الوكيل قبل أن تدفع شيئًا
الوكيل الذي يرد على عملائك هو نفسه الذي يرد عليك الآن: اسأله من زر الدردشة هنا أو على واتساب. وحسابك مجاني بلا بطاقة ائتمان، والتجربة المجانية على رقمك أو صفحتك تُفعَّل بعد التواصل مع الإدارة على واتساب خدمة العملاء.