هل أحتاج WhatsApp Business API لإرسال رمز تحقّق؟

لا. واجهة الإرسال في ربط تمشي على رقم WhatsApp عادي تربطه بمسح رمز QR، فلا تحتاج حساب أعمال معتمداً من Meta ولا قالب مصادقة معتمداً ولا تكلفة لكل رسالة.

هل يصل الرمز إلى نظامي؟

لا. الرمز يُولَّد عندنا ويُرسل إلى الزبون مباشرة، ونظامك يستلم معرّف طلب (challenge) يتحقّق به لاحقاً. الرمز لا يعود في ردّ الواجهة ولا يُخزَّن عندنا صريحاً.

كم يعيش الرمز وكم محاولة يُسمح بها؟

خمس دقائق افتراضياً (من دقيقة إلى ستين)، وخمس محاولات تحقّق. رمزٌ جديد لنفس الرقم يُلغي ما قبله، والرمز الصحيح لا يُقبل مرتين.

هل يُوقف WhatsApp رقمي؟

الرقم المربوط بمسح QR يعمل ببروتوكول الأجهزة المرتبطة لا بواجهة الأعمال، فالشكاوى المتكررة قد توقفه. رمزٌ يطلبه الزبون بنفسه في اللحظة نفسها استعمال سليم، والرشق إلى قوائم أرقام هو أسرع طريق إلى الإيقاف. لذلك للواجهة سقوف إرسال مفروضة.

واجهة إرسال رموز التحقّق — رمز WhatsApp بلا Business API

نظامك ينادي «أرسل رمزاً لهذا الرقم»، فنولّد الرمز ونرسله على WhatsApp من رقم شركتك المربوط بمسح QR، ونرجّع لك معرّف طلب. وحين يكتب الزبون الرمز، تنادي «تحقّق». الرمز لا يمرّ بنظامك ولا يُخزَّن عندنا صريحاً — ولا تحتاج حساب أعمال معتمداً من Meta ولا قالب مصادقة ولا كلفة لكل رسالة.

في هذه الصفحة

قبل أول نداء: اربط الرقم وأصدر مفتاحاً
فحص الاتصال
إرسال رمز
التحقّق من رمز
رسالة نصّية عادية
السقوف
الأخطاء
متى لا تستعمل هذا

قبل أول نداء

١. اربط رقم WhatsApp عادياً. من لوحة شركتك: الإعدادات ← القنوات ← «WhatsApp — رقم عادي» ← امسح الرمز من هاتف الرقم (WhatsApp ← الأجهزة المرتبطة ← ربط جهاز). الهاتف يبقى متصلاً بالإنترنت، لأن الربط يمرّ عبره.

٢. أصدر مفتاح إرسال. من التبويب نفسه ← «الويبهوك والمفاتيح» ← زر «مفتاح إرسال». يُعرض المفتاح مرة واحدة ولا يُقرأ بعدها. صلاحيته الإرسال وحده: لا يقرأ محادثاتك ولا دليل عملائك، ومفاتيح القراءة لا تفتح هذا الباب.

عنوان الواجهة هو نطاق مساحة عملك نفسه:

https://<شركتك>.rabetdesk.com/api/send/v1

والمفتاح في ترويسة كل نداء:

Authorization: Bearer rbs_XXXXXXXXXXXXXXXXXXXXXXXX Content-Type: application/json

فحص الاتصال

GET/ping

أول ما تناديه: هل المفتاح يعمل، وهل الرقم مربوط، وأين أنت من السقوف.

# الطلب curl -s https://acme.rabetdesk.com/api/send/v1/ping \ -H "Authorization: Bearer $KEY" # الرد {"ok": true, "integration": "تطبيق الشركة", "company": "أكمي", "channel": "whatsapp_qr", "linked": true, "number": "9647801112233", "state": "open", "usage": {"hour": 3, "hour_cap": 120, "day": 41, "day_cap": 500}}

linked:false أو state غير open تعني أن الرقم غير مربوط أو أن الهاتف مقطوع؛ وأي إرسال حينها يُرفض برمز channel.

إرسال رمز

POST/code

نولّد الرمز ونرسله، ونرجّع challenge — لا الرمز.

curl -X POST https://acme.rabetdesk.com/api/send/v1/code \ -H "Authorization: Bearer $KEY" \ -H "Content-Type: application/json" \ -d '{"to":"9647701234567","purpose":"login"}' {"ok": true, "challenge": "0cVQ…", "to": "9647701234567", "expires_at": "2026-09-16T18:45:00+00:00", "expires_in": 300, "chat_id": 12}

الحقل	إلزامي	الافتراضي	ملاحظة
`to`	نعم	—	كامل مع مفتاح الدولة
`purpose`	لا	—	وسمٌ لك يرجع مع التحقّق (٤٠ حرفاً)
`ttl_minutes`	لا	5	من ١ إلى ٦٠
`length`	لا	6	من ٤ إلى ١٠ خانات
`text`	لا	قالب شركتك	يقبل `{code}` و`{minutes}` و`{company}`

احفظ challenge عندك واربطه بالجلسة أو الطلب. الرمز يُهشّ عندنا ولا يُخزَّن صريحاً، ورمزٌ جديد لنفس الرقم يُلغي ما قبله.

التحقّق من رمز

POST/verify

curl -X POST https://acme.rabetdesk.com/api/send/v1/verify \ -H "Authorization: Bearer $KEY" \ -H "Content-Type: application/json" \ -d '{"challenge":"0cVQ…","code":"481902"}' {"ok": true, "phone": "9647701234567", "purpose": "login", "verified_at": "2026-09-16T18:41:12+00:00"}

النجاح يستهلك الرمز فلا يُقبل مرتين. والفشل يرجع الحالة ومعها code:

الرمز	المعنى
`bad_code`	رمز خاطئ — والرسالة تقول كم محاولة بقيت
`too_many`	خمس محاولات خاطئة؛ الرمز مات، أصدر غيره
`expired`	انتهت المهلة
`used`	استُعمل، أو ألغاه رمزٌ أحدث لنفس الرقم
`no_challenge`	معرّف طلبٍ غير معروف

رسالة نصّية عادية

POST/message

لما ليس رمزاً: «طلبك جاهز»، «سائقك وصل»، «فاتورتك صدرت».

curl -X POST https://acme.rabetdesk.com/api/send/v1/message \ -H "Authorization: Bearer $KEY" \ -H "Content-Type: application/json" \ -d '{"to":"9647701234567","text":"طلبك جاهز للاستلام"}' {"ok": true, "chat_id": 12, "message_id": 340, "to": "9647701234567"}

الحد الأعلى ٤٠٠٠ حرف. والرسالة تفتح المحادثة في صندوق شركتك، فإذا ردّ الزبون يكمل عليها فريقك من الشاشة نفسها — وهذا أهم ما يفرق هذه الواجهة عن بوابة رسائل: الرسالة الصادرة ومحادثة الزبون شيء واحد.

السقوف

السقف	الافتراضي
تهدئة بين رسالتين لنفس الرقم	٦٠ ثانية
حصّة الرقم الواحد باليوم	١٠ رسائل
سقف الشركة بالساعة	١٢٠
سقف الشركة باليوم	٥٠٠

التجاوز يرجع 429 ومعه retry_after بالثواني. والسقوف تُحسب من سجلٍّ دائم لا من ذاكرة، فإعادة تشغيل الخدمة لا تصفّرها. تُرفع بالاتفاق لمن يحتاج أعلى.

الأخطاء

الحالة	الرمز	المعنى
401	`bad_key`	مفتاح خاطئ أو ملغى أو ليس مفتاح إرسال
400	`bad_phone`	رقم ناقص أو بلا مفتاح دولة
429	`too_soon` · `phone_cap` · `hourly_cap` · `daily_cap`	فوق سقف
502	`channel`	الرقم غير مربوط، أو الهاتف مقطوع

كل خطأ يرجع {"error": "نصّ بالعربية", "code": "…", "retry_after": 0} — النصّ لتعرضه، والرمز لتتفرّع عليه.

متى لا تستعمل هذا

الرقم المربوط بمسح QR يعمل ببروتوكول الأجهزة المرتبطة، لا بواجهة الأعمال. هذا يعني بلا كلفة رسالة وبلا قوالب وبلا انتظار مراجعة — ويعني أيضاً أن الشكاوى المتكررة قد توقف الرقم، وأن الهاتف يجب أن يبقى متصلاً.

رمزٌ يطلبه الزبون بنفسه في اللحظة نفسها: استعمالٌ سليم. حملة إلى قائمة أرقام اشتريتها: أسرع طريق إلى إيقاف رقم شركتك. إن كان إرسالك تسويقياً أو بأحجام كبيرة، فمكانه WhatsApp Business API بقوالبه المعتمدة — و«ربط» يشغّلها أيضاً على القناة نفسها والصندوق نفسه.

جرّبها على رقمك

اربط رقمك بمسح رمز، أصدر مفتاحاً من الشاشة، وأرسل أول رمز خلال دقيقة — ومن الصندوق نفسه يكمل فريقك المحادثة إذا ردّ الزبون.

جرّب مجاناً 14 يوماً

واجهة الإرسال: رمز تحقّق على WhatsApp بلا Business API