تجاوز إلى المحتوى الرئيسي

التحقّق برقم الجوّال · عبر واتساب

التحقّق من أرقام عملائك
عبر واتساب

رمز التحقّق لمرة واحدة هو كود مؤقّت يُرسَل إلى العميل في رسالة واتساب من رقم عملك الموثّق. يضغط العميل «نسخ الرمز» ويلصقه في نظامك، فيتحقّق نظامك منه عبر استدعاء واحد.

الاستدعاءات
اثنان فقط
خانات الرمز
٤ إلى ٨
الكود الصريح
لا يُخزَّن
محادثة واتساب تعرض رمز تحقّق من ٦ خانات مع زر «نسخ الرمز» وصلاحية محدودة
نظامك أنت
أدخل رمز التحقّق
أرسلنا رمزاً إلى +966 5•• ••• •29
بانتظار الرمز…
٢
استدعاء برمجي فقط
إرسال ثمّ تحقّق
٤–٨
خانات قابلة للضبط
حسب حساسيّة العملية
٣
طبقات حماية
تهدئة، سقف يومي، وحدّ للواجهة
٣٠
طلباً في الدقيقة
حدّ الواجهة لكل مفتاح
دورة حياة التحقّق

كيف تعمل خدمة التحقّق

تمرّ كل عملية تحقّق بخمس حالات تعيدها الواجهة البرمجية. الحالات الثلاث الأولى تخصّ تسليم الرسالة، والأخيرتان تخصّان إدخال العميل للكود.

  1. طلب التحقّق

    نظامك يستدعي ‎/v1/verify/start‎ برقم العميل. نولّد الكود ونخزّن بصمته فقط.

    pending
  2. أُرسل عبر واتساب

    يخرج الكود في قالب مصادقة معتمد من Meta، من رقم عملك الموثّق.

    sent
  3. وصل الجهاز

    واتساب يؤكّد وصول الرسالة إلى جهاز العميل. تظهر الحالة في ‎delivery_status‎.

    delivered
  4. قرأه العميل

    العميل فتح المحادثة وضغط «نسخ الكود». لا كتابة يدوية، لا أخطاء إملائية.

    read
  5. تحقّق ناجح

    نظامك يستدعي ‎/v1/verify/check‎ بالكود. المقارنة تتم بزمن ثابت.

    approved
رجل وامرأة يستخدمان خدمة التحقّق برمز OTP عبر واتساب: واجهة برمجية ترسل الرمز، ورسالة واتساب تحمل رمز تحقّق من ست خانات، وهاتف يعرض المحادثة مع زر «نسخ الرمز» وعلامة تحقّق ناجح
الإمكانات

إمكانات الخدمة

لا إضافات لاحقة ولا وحدات تُشترى منفصلة. اضبط ما يناسب حساسيّة عمليّاتك من لوحة التحكّم.

طول الكود ومدّة صلاحيته وعدد المحاولات تُضبط من لوحة التحكّم.

طول الكود من ٤ إلى ٨ خانات

أربع خانات لتجربة أسرع، ثماني خانات للحسابات البنكية. تتغيّر من الإعدادات فوراً دون نشر جديد.

code_length

مدّة صلاحية قابلة للضبط

حدّد كم ثانية يبقى الكود صالحاً. بعدها يصبح ‎expired‎ ولا يقبل أي محاولة تحقّق.

ttl_seconds

حدّ لمحاولات الإدخال

بعد عدد محدّد من المحاولات الخاطئة يصبح التحقّق ‎denied‎. هذا يمنع التخمين بالقوّة.

max_attempts

عربي وإنجليزي

اللغة تُحدَّد لكل عملية تحقّق على حدة، أو تُترك للإعداد الافتراضي للمنصّة.

locale
شكل الزر

زرّان، وفرق واحد: من يكتب الرمز؟

كل رسالة تحقّق تحمل زراً. اختر بين نسخ الرمز يدوياً، أو تعبئته في تطبيقك تلقائياً.

نسخ الرمزالافتراضي

COPY_CODE

يعمل على كل جهاز، وبلا أي إعداد مسبق.

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

  1. يصل الرمز على واتساب
  2. يضغط العميل «نسخ»
  3. يلصقه في موقعك أو تطبيقك
ما تحتاج تجهيزه
نص الزر فقط

تعبئة تلقائية

ONE_TAP

يُدخل الرمز في تطبيقك دون أن يكتب العميل شيئاً.

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

  1. يصل الرمز على واتساب
  2. يضغط العميل الزر مرة واحدة
  3. يفتح تطبيقك والرمز مُدخَل
ما تحتاج تجهيزه
اسم حزمة التطبيق (package_name)بصمة توقيع التطبيق (signature_hash)
إعدادات تنطبق على الاثنين
نص الزر
حتى ٢٥ حرفاً

النص الذي يظهر على الزر داخل الرسالة.

button_text
مدة صلاحية الرمز
من ١ إلى ٩٠ دقيقة

تظهر داخل الرسالة نفسها، فيعرف العميل متى ينتهي الرمز.

code_expiration_minutes
سطر التنبيه الأمني
اختياري

يضيف تحذير «لا تشارك هذا الرمز مع أحد» إلى نصّ الرسالة.

show_security_recommendation
الربط البرمجي

الربط البرمجي

أرسل الرمز، ثمّ تحقّق منه. لوحة التحكّم تولّد لك هذه الأمثلة بمفتاحك ورقمك الحقيقيين جاهزة للنسخ.

أرسل الرمز
POST /v1/verify/start
curl -X POST https://api.saei.automize.sa/v1/verify/start \
  -H "Authorization: Bearer sk_live_<your_key>" \
  -H "Content-Type: application/json" \
  -d '{"to":"+9665XXXXXXXX","locale":"ar"}'
تحقّق من الرمز
POST /v1/verify/check
curl -X POST https://api.saei.automize.sa/v1/verify/check \
  -H "Authorization: Bearer sk_live_<your_key>" \
  -H "Content-Type: application/json" \
  -d '{"verification_id":123,"code":"123456"}'
استقبل النتيجة على خادمك (اختياري)
otp.verification.updated
POST /your/webhook            HTTP/1.1
X-OTP-Event:      otp.verification.updated
X-OTP-Timestamp:  1786600000
X-OTP-Signature:  sha256=9f2c…

{
  "verification_id": 123,
  "status":          "approved",
  "to":              "+9665XXXXXXXX",
  "channel":         "whatsapp",
  "delivery_status": "read",
  "attempts":        1
}

كل إشعار يحمل توقيع X-OTP-Signature محسوباً بمفتاحك السرّي. احسب التوقيع على جسم الطلب وقارنه، فترفض أي طلب لم يصدر منّا.

واتساب مقابل الرسائل النصّية

واتساب مقابل الرسائل النصية

نقول لك الصورة كاملة، بما فيها الحالة الوحيدة التي تتفوّق فيها الرسائل النصّية.

عبر واتسابرسالة نصّية
التكلفة لكل تحقّقرسالة مصادقة واحدة بسعر ثابت ومعروف مسبقاًيُحاسب بالمقاطع، والنص العربي يُحتسب ثلاثة مقاطع
إدخال الكودزر «نسخ الكود» بضغطة واحدة، دون كتابة يدويةقراءة الرسالة ثمّ كتابة الكود يدوياً
تأكيد الوصولأُرسل، ثمّ وصل، ثمّ قُرئ، لكل رسالة على حدةتقرير تسليم فقط، ودقّته تختلف من مشغّل لآخر
هويّة المُرسِلاسم نشاطك الموثّق مع العلامة الخضراءاسم مُرسِل نصّي يسهل انتحاله
التغطيةكل من لديه تطبيق واتساب على جهازهأي رقم جوّال، حتى بلا إنترنت
حالات الاستخدام

حالات الاستخدام

أربع لحظات يتكرّر فيها السؤال نفسه: هل هذا الرقم يخصّ صاحبه؟ اختر الأقرب لحالتك.

تحقّق من الرقم قبل أن يصبح حساباً.

التسجيل بلا تحقّق يملأ قاعدة بياناتك بأرقام خاطئة وحسابات وهمية. رمز واحد قبل إنشاء الحساب يضمن أن الرقم حقيقي ويملكه صاحبه، ويمنحك قناة وصول مؤكّدة من اليوم الأول.

  • أرقام صحيحة في قاعدة بياناتك بدل الأخطاء المطبعية
  • انخفاض الحسابات الوهمية والتسجيل الآلي
  • قناة تواصل مُثبتة قبل أول رسالة تسويقية
متاجر إلكترونيةتطبيقات الجوّالمنصّات تعليميةالجمعيات
قبل التفعيل

من يستطيع تفعيل خدمة التحقّق؟

خدمة التحقّق تعمل على منصّة واتساب للأعمال، لذلك تحكمها شروط حساب Meta نفسها. راجع النقاط الثلاث التالية قبل أن تبدأ.

توثيق النشاط التجاري

يجب أن يكون نشاطك مُوثّقاً (Business Verification) داخل Meta Business Manager بمستندات سجلك التجاري. هذا شرط Meta وليس شرطنا، وهو ما يفتح المستويات الأعلى من حدود الإرسال.

حدّ إرسال ٢٬٠٠٠ محادثة فأعلى

نُفعّل خدمة التحقّق للأرقام التي وصلت إلى شريحة ٢٬٠٠٠ محادثة يومياً أو أعلى. توثيق النشاط وحده يرفعك عادةً إلى هذه الشريحة، وسلّم Meta هو: ٢٥٠ ← ٢٬٠٠٠ ← ١٠٬٠٠٠ ← ١٠٠٬٠٠٠.

تقييم جودة سليم

حافظ على تقييم جودة «عالٍ» أو «متوسط» لرقمك. التقييم المنخفض لا يمنع الترقية فحسب، بل قد يُنزل رقمك إلى شريحة أدنى ويؤثّر على وصول رموز التحقّق.

تعرف شريحتك الحالية من: Meta Business Suite ← WhatsApp Manager ← Account tools ← Messaging limits.

الأدلّة الكاملة

أسئلة شائعة

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

كم يستغرق ربط خدمة التحقّق بنظامي؟

استدعاءان فقط: ‎/v1/verify/start‎ لإرسال الكود، و‎/v1/verify/check‎ للتحقّق منه. لوحة التحكّم تولّد لك أمثلة جاهزة للنسخ بمفتاحك ورقمك الحقيقيين، ويمكنك تجربة الإرسال والتحقّق من داخل المنصّة قبل كتابة أي كود. الربط الفعلي عادةً أقل من ساعة.

هل تحفظون كود التحقّق؟

لا. الكود الصريح يُولَّد ويُسلَّم لمسار الإرسال فقط، ولا يُخزَّن ولا يُسجَّل في أي مكان. ما يُحفظ في قاعدة البيانات هو بصمة HMAC-SHA256 فقط، والمقارنة عند التحقّق تتم بزمن ثابت. حتى لو تسرّبت قاعدة البيانات، لا يمكن استخراج أي كود منها.

ماذا يحدث إن لم يصل الكود للعميل؟

ترى حالة التسليم الحقيقية لكل عملية: أُرسل، وصل، أو قُرئ. هذا يفصل بوضوح بين «العميل لم يُدخل الكود» و«الرسالة لم تصل أصلاً». كما يمكنك استقبال إشعار مُوقَّع على خادمك لحظة تغيّر الحالة، فتتّخذ قرارك تلقائياً: إعادة إرسال أو تحويل العميل لمسار آخر.

كيف تحمون حسابي من هجمات استنزاف الرسائل؟

ثلاث طبقات تعمل قبل إرسال أي رسالة: فترة تهدئة بين الطلبات لنفس الرقم، سقف يومي لكل رقم خلال ٢٤ ساعة، وحدّ عام على الواجهة البرمجية يبلغ ٣٠ طلباً في الدقيقة لكل مفتاح. لأنّ الفحص يسبق الاستدعاء، الطلب المرفوض لا يكلّفك رسالة ولا يؤثّر على تقييم جودة رقمك لدى Meta.

هل أحتاج رقم واتساب أعمال موثّقاً؟

نعم. خدمة التحقّق ترسل عبر قالب مصادقة معتمد من Meta من رقم عملك الموثّق، وهذا بالضبط ما يجعل العميل يثق بالرسالة: اسم نشاطك الحقيقي بدل اسم مُرسِل مجهول. المنصّة ترافقك في خطوات التوثيق وإنشاء القالب واعتماده.

هل يمكنني استخدام أكثر من رقم أو أكثر من قالب؟

نعم. إن كان لديك عدّة أرقام واتساب، يمكنك تحديد رقم المُرسِل والقالب لكل عملية تحقّق على حدة عبر الحقلين ‎from‎ و‎template_id‎، أو تركهما فارغين لتختار المنصّة الإعداد الافتراضي. المنصّة تمنع مسبقاً أي محاولة لدمج رقم مع قالب من حساب أعمال مختلف.

ما الفرق بين التحقّق عبر واتساب والرسائل النصية؟

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

هل الخدمة متاحة في كل الباقات؟

خدمة التحقّق متاحة ضمن باقة Pro. تشمل الواجهة البرمجية الكاملة، وإدارة المفاتيح وتدويرها، وإشعارات النتائج المُوقَّعة، ولوحة متابعة عمليات التحقّق.

جرّب إرسال رمز حقيقي إلى رقمك خلال دقائق.

أنشئ حسابك، فعّل خدمة التحقّق، وأرسل رمزاً من لوحة التحكّم قبل أن تكتب سطر برمجة واحد.