إرسال كود التحقق على واتساب عبر الواجهة البرمجية: العنوان والحقول والرد
مرجع عنوان إرسال كود التحقق في واجهة عربي بوت: حقول الطلب، مثال ورد، كل حالات الرفض بأكوادها، ومن أي رقم يخرج الكود وكيف يُحاسَب.
في هذه الصفحة 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بتوقيت الخادم.
ما قسناه على هذه الواجهة
نصف المستخدمين كتبوا الكود خلال 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 بالثواني.
دليل واجهة كود التحقق · كل الواجهات للمطورين
الأسئلة الشائعة
من أي رقم يخرج كود التحقق؟
من رقم واتساب الخاص بك إن ربطته، أو من رقم عربي بوت المشترك ويُخصم ثمن الرسالة من محفظتك. في الحالتين يخرج الكود بقالب تحقق معتمد من ميتا.
هل أتحقق من الكود برقم الهاتف؟
لا. تتحقق بمعرّف الطلب request_id الذي عاد عند الإرسال، لا برقم الهاتف. احفظه في جلسة المستخدم على خادمك.
اقرأ بعدها
جرّب الوكيل قبل أن تدفع شيئًا
الوكيل الذي يرد على عملائك هو نفسه الذي يرد عليك الآن: اسأله من زر الدردشة هنا أو على واتساب. وحسابك مجاني بلا بطاقة ائتمان، والتجربة المجانية على رقمك أو صفحتك تُفعَّل بعد التواصل مع الإدارة على واتساب خدمة العملاء.