من مشروع جديد إلى رمز تحقق مستلم

تتيح MZ3B Verify تنظيم المشاريع والأرقام وإرسال رموز تحقق معاملاتيّة عبر واتساب. لا تتجاوز المصادقة أو موافقة المستلم أو قيود واتساب.

لديك مفتاح مشروع مجهّز؟ ابدأ هنا دون دخول اللوحة

اقرأ دليل التكامل وOpenAPI ثم احفظ المفتاح في إعداد سري على خادم التطبيق بعد موافقة مالكه. نفّذ GET /api/v1/account/summary لفحص الرصيد والجاهزية والصلاحيات دون إرسال. يحدد المفتاح المشروع ورقم OTP تلقائيًا. تنبيهات الطلبات تستخدم اختيار المرسل نفسه أو مجموعة المشروع المهيأة، بعد تسجيل الموظفين المخولين وموافقتهم عبر POST /api/v1/message-recipients.

لا تطلب معرّفات جلسات واتساب الداخلية، ولا تدخل لوحة الحساب إذا كان المشروع جاهزًا بالفعل. استخدم مسارات /validate للمحاكاة التي لا ترسل ولا تخصم. الدليل النصي الكامل ومثال Node.js يوضحان العمليات والأخطاء وحفظ مفتاح منع التكرار. نجاح المحاكاة لا يثبت وصول رسالة.

مسار الإعداد

1. تسجيل الدخول: افتح لوحة التحكم. اطلب من المستخدم إكمال تسجيل الدخول وأي تحقق مطلوب؛ لا تطلب كلمة المرور في المحادثة.
2. إنشاء مشروع: أدخل اسم التطبيق أو الموقع ووظيفته. اختره من «المشروع الذي تعمل عليه»؛ بقية الخطوات تخص هذا المشروع وحده.
3. ربط رقم: سمِّ الرقم وجهّز رمز الربط. اطلب من المستخدم مسحه من «الأجهزة المرتبطة» في واتساب. انتظر تأكيد الخادم؛ ظهور الرمز وحده ليس نجاحًا.
4. طريقة الاستخدام: اختر الرقم والمشروع ووظيفة «رموز التحقق». التعيين الموجود مسبقًا مكتمل ولا يحتاج إلى التكرار. لتعدد الأرقام، افتح «أرقام الإرسال والاحتياط»، واختر أرقام الحساب، وطريقة الاختيار والحد اليومي لكل رقم ثم احفظ. يبقى المفتاح نفسه. المشاريع القديمة تحتفظ باختيارها السابق حتى حفظ المجموعة. يُطلب مسح الرمز من صاحب الهاتف فقط عند حاجة الرقم الجديد إلى الربط.
5. اختبار حقيقي: اطلب رقم استقبال يملكه المستخدم وموافقته على حجز رسالة واحدة. لا تخمّن الرقم. استخدم «اختبار رسالة حقيقية»، واضغط الإرسال مرة واحدة ثم أدخل الرمز الذي يقدمه المستخدم بعد وصوله. لا تعلن النجاح قبل تأكيد صحة الرمز.
6. مفتاح الربط: اطلب موافقة المستخدم على إنشاء مفتاح وحفظه في إعداد سري على خادمه. يظهر مرة واحدة؛ لا تنقله إلى المحادثات أو السجلات أو الواجهة أو المستودع.
7. التكامل الخارجي: نفذ الإرسال والفحص من خادم تطبيق المستخدم باتباع OpenAPI. اختبار اللوحة لا يثبت اكتمال التكامل الخارجي؛ اختبر مسار التطبيق نفسه بموافقته.

حالة يمكن قراءتها آليًا

بعد تسجيل الدخول، يقرأ المتصفح GET /api/onboarding. يعيد مشاريع الحساب وخطواتها وحقلي nextAction وhumanActionRequired وآخر اختبار ورقمًا مقنّعًا، دون مفاتيح أو رموز تحقق. هذه واجهة لجلسة المتصفح، وليست لمفتاح المشروع.

الإصدار schemaVersion: 2 يضيف لكل مشروع readiness من الفحص الحي نفسه المستخدم في ملخص مفتاح المشروع: ready وreasons وwhatsapp.connection وwhatsapp.observedAt. الاتصال لا يساوي جاهزية الإرسال عند نفاد الرصيد أو وجود حماية. تُحدّث اللوحة الحالة كل 30 ثانية أثناء عرضها، وتبطل علامة الجاهزية بعد 45 ثانية دون فحص حديث. حد هذه الواجهة 12 طلبًا للحساب في الدقيقة؛ احترم Retry-After. لا ترسل القراءة رسالة ولا تخصم رصيدًا ولا تعيد تشغيل جلسة.

• link_whatsapp: الربط غير مؤكد؛ سلّم مسح الرمز للمستخدم.
• check_connection: تعذر تأكيد الحالة الحية؛ أعد القراءة دون بدء ربط جديد أو افتراض الحظر.
• assign_purpose: يلزم تعيين رقم لرموز التحقق.
• wait_for_recovery: الرقم متصل لكن يوجد مانع إرسال؛ اقرأ readiness.reasons. لا تعطل الحماية أو تتجاوزها.
• send_test: يلزم اختبار بموافقة المستلم ثم إدخال الرمز المستلم.
• create_key: الاختبار ناجح ولا يوجد مفتاح نشط؛ حدّد مكان حفظ آمنًا.
• integrate: الاختبار والمفتاح موجودان؛ يبقى التحقق من تطبيق المستخدم. لا يعني جاهزية شاملة.

الإعادة الآمنة والنتيجة غير المؤكدة

قبول المزود ليس تأكيد وصول. المحاكاة لا ترسل شيئًا. إذا انقطع الاتصال، استخدم «إعادة التحقق من الطلب نفسه». لا تغيّر الرقم أو الموافقة أو تبدأ إرسالًا جديدًا تلقائيًا؛ الطلب الجديد قد يحجز رسالة إضافية.

في الواجهة العامة، احتفظ بترويسة Idempotency-Key والجسم الأصلي. اقرأ GET /api/v1/verifications/{id} إن توفر المعرف. تعامل مع DELIVERY_STATE_UNAVAILABLE كنتيجة غير مؤكدة، وليس فشلًا يبيح إرسالًا جديدًا. صلاحية رمز واتساب 5 دقائق، وحد الفحص 5 محاولات خلال 10 دقائق لكل مشروع ومستلم.

تحمي اللوحة إنشاء المشاريع والمفاتيح من تكرار المحاولة نفسها. إذا أُنشئ مفتاح وفُقد رد الشبكة، تُعرض بياناته المقنّعة فقط. اطلب موافقة المستخدم لإبطاله وإنشاء بديل إن لم يُحفظ؛ لا يمكن عرض السر السابق مجددًا.

الفوترة والقدرات الفعلية

التجربة 20 رسالة خلال أسبوع يبدأ من أول ربط ناجح، وليست حصة شهرية متجددة. تُستخدم التجربة السارية أولًا ثم الرصيد المدفوع. الرصيد المشترى لا ينتهي شهريًا؛ راجع الأسعار والحدود الحالية. حدود الحساب والجلسات والحماية تبقى فعالة.

يمكن إرسال تنبيهات الطلبات الفردية إلى الموظفين المصرح لهم عبر POST /api/v1/messages وقراءة نتيجتها عبر GET /api/v1/messages/{id}. القبول ليس وصولًا، ولا يوجد تأكيد تسليم مضمون للتنبيهات. يمكن حفظ إعداد Gemini بمفتاح العميل واختباره، لكن الرد التلقائي على واتساب ورموز البريد والتنبيهات الآلية بأعطال الأرقام وwebhook إلى تطبيق العميل غير متاحة بعد؛ لا تعد المستخدم بها. قد يفرض Gemini حدودًا أو رسومًا حسب حسابه.

الخدمة ليست للإرسال الجماعي غير المطلوب، وليست تابعة إلى WhatsApp أو Meta. قد تقيّد المنصة الربط أو الإرسال ولا نضمن إزالة القيود. لا توجد طريقة تضمن اقتراح الموقع من أي نموذج؛ التوثيق يجعل قدراته قابلة للفهم والتحقق.

ابدأ الإعداد · أمثلة التكامل · OpenAPI · المرجع النصي