واجهة كود التحقق

التحقق من كود واتساب الذي كتبه المستخدم عبر الواجهة البرمجية

مرجع عنوان التحقق من الكود في واجهة عربي بوت: الحقول، الرد، الكود الخاطئ وعدد المحاولات، الكود المنتهي، وحالات الرفض.

4 دقائق قراءة آخر تحديث 16 نوفمبر 2026 فريق عربي بوت
فريق عربي بوتشريك Meta الرسمي · نكتب من بيانات منصتنا
في هذه الصفحة 8
  1. العنوان والتوثيق
  2. الحقول
  3. مثال طلب
  4. الرد
  5. ما قسناه على هذه الواجهة
  6. حالات الرفض
  7. الحدود
  8. الأسئلة الشائعة

الإجابة المختصرة

بطلب POST إلى العنوان verify فيه معرّف الطلب والكود الذي كتبه المستخدم. إن طابق الكود عاد الرد بنجاح ومعه رقم الهاتف ووقت التحقق. الكود يُقبل مرة واحدة، والكود الخاطئ يعود معه عدد المحاولات الباقية، وبعد استنفادها يطلب المستخدم كودًا جديدًا.

يُسأل عنها أيضًا: «اتحقق من كود الواتساب في الكود ازاي» · «التحقق من رمز otp واتساب»

العنوان والتوثيق

POST https://app.arabybot.com/wa_otp_api/verify

أرسل المفتاح العام لتطبيق كود التحقق في الترويسة X-Public-Key: ab_otp_…. تنشئ التطبيق من قسم كود التحقق في اللوحة، فيعطيك المفتاح العام وسرًّا يُعرض مرة واحدة. وإن فعّلت توقيع الطلبات في التطبيق أضفت الترويسة X-Signature: sha256=…، وقيمتها HMAC-SHA256 لجسم الطلب الخام بسر التطبيق.

الحقول

  • request_id (مطلوب) معرّف الطلب الذي عاد عند إرسال الكود.
  • code (مطلوب) الكود الذي كتبه المستخدم.

مثال طلب

cURL

curl -X POST https://app.arabybot.com/wa_otp_api/verify \
  -H "X-Public-Key: ab_otp_YOUR_PUBLIC_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "request_id": "3f6c2a9e-41b7-4c0d-9a51-7e2b8d4f1c60", "code": "482913" }'

PHP

$ch = curl_init('https://app.arabybot.com/wa_otp_api/verify');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POST           => true,
    CURLOPT_HTTPHEADER     => ['X-Public-Key: ab_otp_YOUR_PUBLIC_KEY', 'Content-Type: application/json'],
    CURLOPT_POSTFIELDS     => json_encode([
        'request_id' => '3f6c2a9e-41b7-4c0d-9a51-7e2b8d4f1c60',
        'code' => '482913',
    ]),
]);
$answer = json_decode(curl_exec($ch), true);
$status = curl_getinfo($ch, CURLINFO_RESPONSE_CODE);
curl_close($ch);

Python

import requests

r = requests.post(
    'https://app.arabybot.com/wa_otp_api/verify',
    headers={
        "X-Public-Key": "ab_otp_YOUR_PUBLIC_KEY",
    },
    json={
        "request_id": "3f6c2a9e-41b7-4c0d-9a51-7e2b8d4f1c60",
        "code": "482913",
    },
    timeout=30,
)
print(r.status_code, r.json())

Node.js

// Node.js 18+
const r = await fetch('https://app.arabybot.com/wa_otp_api/verify', {
  method: 'POST',
  headers: {"X-Public-Key": "ab_otp_YOUR_PUBLIC_KEY", "Content-Type": "application/json"},
  body: JSON.stringify({
    "request_id": "3f6c2a9e-41b7-4c0d-9a51-7e2b8d4f1c60",
    "code": "482913"
  }),
});
console.log(r.status, await r.json());

الرد

200
{ "success": true, "request_id": "3f6c2a9e-41b7-4c0d-9a51-7e2b8d4f1c60",
  "phone": "966501234567", "verified_at": "2026-11-16 18:05:02" }
  • الكود يُقبل مرة واحدة؛ طلب التحقق نفسه مرة ثانية يعود بالحالة 410.
واجهة عربي بوت كما تعمل اليوم، مقروءة من النظام نفسهقياس 16 نوفمبر 2026

ما قسناه على هذه الواجهة

17 ثانيةوسيط ما بين إرسال الكود وكتابته صحيحًا
98%ممن أكّدوا كتبوا الكود صحيحًا من أول محاولة
ثانية واحدةوسيط زمن رد عنوان الإرسال
قياس عربي بوت على واجهة كود التحقق: 169 كودًا مؤكَّدًا بين 9 و16 نوفمبر 2026، و4,159 إرسالًا ناجحًا منذ 25 أغسطس 2026قياس 16 نوفمبر 2026

نصف المستخدمين كتبوا الكود خلال 13 إلى 25 ثانية، وتسعة من كل عشرة خلال 46 ثانية؛ فصلاحية من دقائق قليلة تكفي. ومن كل مئة كود أُرسل أُكِّد نحو 75. وحدود هذا القياس أن تطبيقًا واحدًا يحمل 91% من الإرسال؛ فهي أرقام هذه التطبيقات لا متوسط عام.

حالات الرفض

كل رفض يعود JSON فيه "success": false وerror_code وmessage، ومعه retry_after بالثواني حين يكون السبب حدًّا زمنيًّا:

  • 401 invalid_code: الكود خاطئ؛ عدد المحاولات الباقية في attempts_remaining.
  • 401 missing_key / invalid_key: المفتاح العام غائب أو خاطئ.
  • 401 missing_signature / bad_signature: التطبيق يطلب توقيع الطلبات والتوقيع غائب أو لا يطابق.
  • 404 not_found: لا طلب بهذا المعرّف.
  • 410 expired / already_resolved: انتهت صلاحية الكود، أو حُسم الطلب من قبل.
  • 422 missing_fields: معرّف الطلب أو الكود غائب.
  • 429 too_many_attempts: استُنفدت المحاولات؛ اطلب كودًا جديدًا.

الحدود

كل كود رسالة واتساب مدفوعة بسعر ميتا لقوالب التحقق في بلد المستلم. وللحماية حدود على عدد الطلبات للرقم الواحد وللتطبيق في الدقيقة وفي اليوم؛ تجاوزها يعيد الحالة 429 ومعها retry_after بالثواني.

دليل واجهة كود التحقق · كل الواجهات للمطورين

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

1

كم مرة يستطيع المستخدم أن يخطئ في الكود؟

مع كل كود خاطئ يعود عدد المحاولات الباقية في attempts_remaining. حين تُستنفد يعود الطلب بالكود too_many_attempts، فتطلب كودًا جديدًا.

2

من أين أستدعي التحقق: من المتصفح أم من الخادم؟

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

فريق عربي بوتشريك Meta الرسمي للأعمال في الشرق الأوسط 264 دليلًا أرقام من منصتنا كل الأدلة

كيف نكتب هذه الأدلة الأرقام من منصتنا وفواتير ميتا الفعلية ومؤرّخة بعيّنتها، والوصف لما يعمل اليوم لا لما نعد به، ونذكر ما لا نفعله ومتى يكون غيرنا الخيار الأفضل. راجعه فريق عربي بوت في 16 نوفمبر 2026.

شارك الدليل

جرّب الوكيل قبل أن تدفع شيئًا

الوكيل الذي يرد على عملائك هو نفسه الذي يرد عليك الآن: اسأله من زر الدردشة هنا أو على واتساب. وحسابك مجاني بلا بطاقة ائتمان، والتجربة المجانية على رقمك أو صفحتك تُفعَّل بعد التواصل مع الإدارة على واتساب خدمة العملاء.

وتديره كله من موبايلككل ما في هذه الصفحة تديره من تطبيق عربي بوت على جوالك — الردود والطلبات والحملات وتقارير الذكاء الاصطناعي. لا لوحة تحكم على الويب فحسب.