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

إرسال كود التحقق على واتساب عبر الواجهة البرمجية: العنوان والحقول والرد

مرجع عنوان إرسال كود التحقق في واجهة عربي بوت: حقول الطلب، مثال ورد، كل حالات الرفض بأكوادها، ومن أي رقم يخرج الكود وكيف يُحاسَب.

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

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

بطلب POST إلى العنوان send في واجهة كود التحقق، فيه رقم الهاتف بصيغة دولية، ومعه المفتاح العام للتطبيق في الترويسة. يولّد النظام كودًا رقميًّا ويرسله على واتساب بقالب تحقق معتمد من ميتا، ويعود الرد بمعرّف الطلب ومدة صلاحية الكود. احتفظ بمعرّف الطلب، فالتحقق لاحقًا يكون به لا برقم الهاتف.

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

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

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

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

الحقول

  • phone (مطلوب) الرقم بصيغة دولية، أرقامًا فقط أو بعلامة + في أوله، مثل 966501234567. وتُقبل الأرقام المصرية المحلية التي تبدأ بـ 01.
  • lang (اختياري) لغة القالب، مثل ar أو en. الافتراضي لغة التطبيق.
  • length (اختياري) طول الكود. لا يقل عن الطول المضبوط في التطبيق.
  • expiry_seconds (اختياري) مدة صلاحية الكود بالثواني. الافتراضي إعداد التطبيق.
  • metadata (اختياري) مفاتيح وقيم من نظامك تُحفَظ مع الطلب.

مثال طلب

cURL

curl -X POST https://app.arabybot.com/wa_otp_api/send \
  -H "X-Public-Key: ab_otp_YOUR_PUBLIC_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "phone": "966501234567", "lang": "ar", "length": 6, "expiry_seconds": 300,
        "metadata": { "user_id": "u_1042" } }'

PHP

$ch = curl_init('https://app.arabybot.com/wa_otp_api/send');
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([
        'phone' => '966501234567',
        'lang' => 'ar',
        'length' => 6,
        'expiry_seconds' => 300,
        'metadata' => [
            'user_id' => 'u_1042',
        ],
    ]),
]);
$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/send',
    headers={
        "X-Public-Key": "ab_otp_YOUR_PUBLIC_KEY",
    },
    json={
        "phone": "966501234567",
        "lang": "ar",
        "length": 6,
        "expiry_seconds": 300,
        "metadata": {
            "user_id": "u_1042",
        },
    },
    timeout=30,
)
print(r.status_code, r.json())

Node.js

// Node.js 18+
const r = await fetch('https://app.arabybot.com/wa_otp_api/send', {
  method: 'POST',
  headers: {"X-Public-Key": "ab_otp_YOUR_PUBLIC_KEY", "Content-Type": "application/json"},
  body: JSON.stringify({
    "phone": "966501234567",
    "lang": "ar",
    "length": 6,
    "expiry_seconds": 300,
    "metadata": {
      "user_id": "u_1042"
    }
  }),
});
console.log(r.status, await r.json());

الرد

200
{ "success": true, "request_id": "3f6c2a9e-41b7-4c0d-9a51-7e2b8d4f1c60",
  "expires_in": 300, "expires_at": "2026-11-16 18:09:10" }
  • request_id معرّف الطلب؛ به تتحقق من الكود وتعيد إرساله وتسأل عن حالته.
  • expires_in بالثواني، وexpires_at بتوقيت الخادم.
واجهة عربي بوت كما تعمل اليوم، مقروءة من النظام نفسهقياس 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 missing_key / invalid_key: المفتاح العام غائب أو خاطئ.
  • 401 missing_signature / bad_signature: التطبيق يطلب توقيع الطلبات والتوقيع غائب أو لا يطابق.
  • 402 package_expired / subscription_expired / module_not_entitled: الاشتراك منتهٍ أو الباقة لا تشمل كود التحقق.
  • 402 quota_exceeded / insufficient_balance: انتهت الحصة، أو رصيد المحفظة لا يكفي عند الإرسال من الرقم المشترك.
  • 403 origin_blocked / ip_blocked / pool_access_denied: مصدر الطلب أو عنوانه غير مسموح به في إعدادات التطبيق، أو الرقم المشترك غير متاح للحساب.
  • 422 missing_phone / invalid_phone: الرقم غائب أو غير صحيح.
  • 429 rate_limit_phone / cooldown / rate_limit_app / rate_limit_app_day: حد زمني للرقم أو للتطبيق؛ انتظر retry_after ثانية.
  • 429 pool_daily_cap / pool_min_gap: حد الرقم المشترك اليومي أو الفاصل بين رسالتين منه.
  • 502 wa_send_failed: رفضت واتساب الإرسال؛ وما خُصم للرقم المشترك يُردّ.
  • 503 pool_unavailable / pool_disabled: الرقم المشترك غير متاح الآن.

الحدود

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

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

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

1

من أي رقم يخرج كود التحقق؟

من رقم واتساب الخاص بك إن ربطته، أو من رقم عربي بوت المشترك ويُخصم ثمن الرسالة من محفظتك. في الحالتين يخرج الكود بقالب تحقق معتمد من ميتا.

2

هل أتحقق من الكود برقم الهاتف؟

لا. تتحقق بمعرّف الطلب request_id الذي عاد عند الإرسال، لا برقم الهاتف. احفظه في جلسة المستخدم على خادمك.

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

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

شارك الدليل

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

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

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