قوالب رموز التحقق OTP على واتساب: الإعداد والأزرار والأسعار بالأمثلة

آخر تحديث: 4 نوفمبر 2026 · إعداد: فريق مظبوت (MazBot) · المصدر الأساسي: وثائق Meta لقوالب المصادقة (Authentication) وصفحة الأسعار الرسمية

الإجابة المختصرة: رموز التحقق (OTP) على واتساب API تُرسل فقط بقالب من فئة Authentication: نص ثابت تكتبه Meta («الرمز هو رمز التحقق الخاص بك») مع تنبيه أمان ومدة صلاحية اختياريين، وزر نسخ الرمز أو الملء التلقائي على أندرويد، بلا روابط أو صور أو إيموجي، والرمز حتى 15 حرفاً. سعر الرسالة المُسلَّمة من 1 أكتوبر 2026: 0.0036$ لرقم مصري و0.0107$ لرقم سعودي.

محتوى المقال:

ما هو قالب OTP على واتساب؟ ومتى يلزمك؟

قالب OTP هو قالب من فئة Authentication (مصادقة) يرسل رمزاً لمرة واحدة يثبت أن الرقم ملك صاحبه: عند إنشاء حساب، أو تسجيل الدخول، أو استعادة الحساب، أو تأكيد طلب. وتقول Meta إن التطبيقات التي ترسل رموز التحقق عبر واتساب «يجب أن تستخدم قالب مصادقة».

  • لا ترسل الرمز في قالب Utility أو Marketing: حسب إرشادات التصنيف، يتلقى هذا القالب إشعاراً ثم تصبح حالته REJECTED في أول يوم من الشهر التالي ولا يُرسل به.
  • يُرسل في أي وقت: كبقية القوالب لا يحتاج نافذة خدمة مفتوحة، لأن العميل غالباً لم يراسلك بعد. ما هو القالب أصلاً؟ اقرأ ما هو Template Message (رسالة القالب)؟

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

قواعد فئة Authentication: المسموح والممنوع

هي أشد فئات القوالب تقييداً لأن Meta تكتب نصها بنفسها. القواعد حسب وثائق Meta (اطّلعنا عليها في 4 نوفمبر 2026):

الجزءالقاعدة
نص الرسالةثابت من Meta ولا يُعدَّل: «<الرمز> هو رمز التحقق الخاص بك» بلغة القالب، فلا مقدمة ولا اسم متجر ولا شرح
تنبيه الأماناختياري: «لأمانك، لا تشارك هذا الرمز»
مدة الصلاحيةاختيارية في التذييل، من 1 إلى 90 دقيقة: «تنتهي صلاحية هذا الرمز خلال 5 دقائق»
الرمزحتى 15 حرفاً، أرقاماً أو حروفاً
الروابط والوسائط والإيموجيغير مسموحة: لا رابط دخول ولا صورة ولا شعار
الزرمن نوع OTP: نسخ الرمز، أو الملء بلمسة، أو بدون لمس. ونص زر النسخ حتى 25 حرفاً، وإن تركته تضع Meta نصاً جاهزاً بلغة القالب
مدة محاولة التسليم (TTL)10 دقائق افتراضياً، وتُضبط من 30 ثانية إلى 15 دقيقة، وبعدها تُسقط الرسالة إن لم تُسلَّم
الأجهزة المرتبطةتُسلَّم على الموبايل الأساسي للعميل فقط، وتظهر محجوبة على الأجهزة المرتبطة مثل واتساب ويب (ميزة أمان في Cloud API لا تُعطَّل)

شكل الرسالة عند العميل تقريباً:

482913 هو رمز التحقق الخاص بك. لأمانك، لا تشارك هذا الرمز.

تنتهي صلاحية هذا الرمز خلال 5 دقائق.

[ نسخ الرمز ]

الصياغة العربية الفعلية تولّدها Meta حسب لغة القالب، وقد تختلف قليلاً عن هذا المثال.

أزرار OTP الثلاثة: أيها تختار؟

الزركيف يعمل؟ماذا يحتاج؟إذا لم يعمل
نسخ الرمز (Copy code)ينسخ العميل الرمز ويلصقه في موقعك أو تطبيقك، على كل الأجهزةلا شيء إضافي—
الملء بلمسة (One-tap)يضغط العميل فيفتح تطبيقك ويصله الرمز، على أندرويد فقطاسم حزمة التطبيق، وبصمة التوقيع (11 حرفاً)، و«مصافحة» من تطبيقك قبل الإرساليظهر زر نسخ الرمز بدلاً منه
بدون لمس (Zero-tap)يصل الرمز لتطبيقك تلقائياً دون أن يضغط العميل شيئاً، على أندرويد فقطالموافقة على شروط Zero-tap، مع اسم الحزمة والبصمة والمصافحةيرجع للملء بلمسة ثم لنسخ الرمز، فتضع الزرين في القالب

وعلى آيفون؟ يظهر زر نسخ الرمز، ومنذ iOS 26 تقترح لوحة المفاتيح الرمز تلقائياً بلا أي برمجة منك.

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

كيف تنشئ قالب OTP وترسله عبر API؟

  1. أنشئ القالب: من WhatsApp Manager ← قوالب الرسائل ← إنشاء قالب واختر Authentication، أو ابدأ من قوالب المصادقة الجاهزة في مكتبة القوالب. جولة في اللوحة في دليل WhatsApp Manager الكامل.
  2. اختر الزر المناسب، وأدخل بيانات تطبيق أندرويد إن اخترت الملء بلمسة.
  3. فعّل تنبيه الأمان، واجعل مدة الصلاحية مساوية لصلاحية الرمز في نظامك، مثل 5 دقائق.
  4. اضبط TTL بحيث يساوي مدة الصلاحية أو أقل كما تنصح Meta، حتى لا يصل للعميل رمز منتهي.
  5. اختر اللغة (العربية ar مثلاً)؛ والنص تولّده Meta بلغة القالب.
  6. أرسل للمراجعة: تستغرق حتى 24 ساعة.
  7. أرسل الرمز مرتين في نفس الطلب: لقالب نسخ الرمز تشترط Meta وضع الرمز كمتغير للنص وكمتغير للزر معاً.
"components": [
  {"type": "body", "parameters": [{"type": "text", "text": "482913"}]},
  {"type": "button", "sub_type": "url", "index": "0",
   "parameters": [{"type": "text", "text": "482913"}]}
]

جزء الإرسال فقط من مثال Meta لقالب نسخ الرمز؛ ويسبقه اسم القالب ولغته ورقم العميل.

ومن جهة نظامك: ولّد الرمز عشوائياً، واحفظه بتاريخ انتهاء، واقبله مرة واحدة فقط، ثم أبلغ العميل بنجاح التحقق كما تنصح Meta.

كم تكلفة رسالة OTP على واتساب في مصر والسعودية؟

تحاسب Meta على كل رسالة مُسلَّمة بسعر فئة Authentication في دولة رقم العميل، وهو في مصر والسعودية نفس سعر Utility:

دولة العميلسعر رسالة OTPلكل 1,000 رمزمثال شهري
مصر (+20)0.0036$3.60$تطبيق توصيل يرسل 20,000 رمز = 72$
السعودية (+966)0.0107$10.70$متجر يرسل 8,000 رمز = 85.60$
الإمارات (+971)0.0157$15.70$5,000 رمز = 78.50$

أسعار Meta السارية من 1 أكتوبر 2026 بالدولار لكل رسالة مُسلَّمة، قبل الضرائب، حسب كود دولة رقم العميل.

  • لا تدفع إلا على المُسلَّم: الرمز الذي سقط بانتهاء TTL قبل تسليمه لا يُحاسب.
  • شرائح الكميات: لرسائل Authentication وUtility أسعار أقل كلما زاد حجمك الشهري في كل دولة، تُحسب على مستوى حافظة الأعمال وتبدأ من جديد كل شهر.
  • داخل نافذة الإعلانات المجانية تكون رسائل Authentication مجانية كبقية الفئات. التفاصيل في نافذة الإعلانات المجانية حتى 7 أيام.
  • وسيلة الدفع شرط لإرسال القوالب؛ الخطوات في إضافة وسيلة دفع في WhatsApp Manager.

وماذا عن سعر «المصادقة الدولية»؟

مصر والسعودية والإمارات ضمن أسواق لها سعر أعلى اسمه Authentication-International منذ 1 فبراير 2025، وانضمت إليها الكويت وعُمان والعراق والمغرب في 1 أكتوبر 2026. لكنه لا يخص أغلب الأنشطة: يُطبَّق فقط على شركة «مؤهلة» أرسلت أكثر من 750 ألف رسالة خارج نوافذ خدمة العملاء خلال 30 يوماً متحركة لمستخدمين في هذه الأسواق، وعندما تختلف دولة مقرها عن دولة رقم العميل؛ أما في دولة مقرك فتدفع السعر المحلي دائماً. وتبلغك Meta قبل التطبيق بـ 30 يوماً بالبريد وWebhook، والأهلية لا تزول بعد ثبوتها.

مثال: متجر مقره القاهرة يرسل الرموز لعملاء مصريين يدفع 0.0036$ للرسالة دائماً. أما منصة سعودية كبيرة ترسل ملايين الرسائل لعملاء في مصر فقد تُحاسب بالسعر الدولي بعد إشعار Meta، وقيمته في جدول أسعار Meta الرسمي. الأسعار المحلية في أسعار واتساب API في مصر وفي السعودية.

لم يصل رمز التحقق؟ نصائح التسليم والبديل عبر SMS

  1. تأكد من رقم واتساب قبل الإرسال، ووضّح للعميل أن الرمز سيصله على واتساب، خصوصاً إن كانت لديك أكثر من وسيلة (توصية Meta).
  2. تابع حالة الرسالة بالـ Webhook: مُرسلة ثم مُسلَّمة ثم مقروءة. وإن لم تصلك حالة «مُسلَّمة» قبل انتهاء TTL فاعتبر الرسالة أُسقطت، كما تقول Meta.
  3. جهّز بديلاً: زر «أرسل الرمز برسالة نصية SMS» يظهر إن لم يُسلَّم الرمز خلال 30 إلى 60 ثانية (توصيتنا).
  4. اعرف سبب الفشل: الخطأ 131026 يعني تعذر التسليم لأن الرقم ليس على واتساب، أو لم يقبل العميل أحدث الشروط، أو تطبيقه قديم؛ هنا البديل هو الحل. التفاصيل في خطأ 131026 ورسالة بعلامة صح واحدة ومش بتوصل.
  5. نبّه مستخدمي واتساب ويب أن الرمز يظهر على الموبايل الأساسي فقط.
  6. لا تكرر الإرسال بسرعة: حدّد إعادة الإرسال، مثلاً مرة كل 60 ثانية وبحد 3 محاولات (توصيتنا)، فالرسائل الكثيرة لنفس الرقم في وقت قصير قد تفشل كما في الخطأ 131056.

كيف يساعدك مظبوت؟

  • قوالب Authentication من لوحة مظبوت: تختار فئة Authentication عند إنشاء القالب بزر «نسخ الرمز» وتنبيه الأمان ومدة صلاحية حتى 90 دقيقة، وتتابع حالة الاعتماد.
  • إرسال من نظامك عبر واجهة API لإرسال القوالب: يمرر نظامك الرمز كقيمة للمتغير عند كل عملية دخول أو تسجيل. وجرّب القالب على رقمك قبل التشغيل الفعلي.
  • رقم واحد لكل خدماتك: نفس الرقم يرسل الرموز، ويرد عليه فريقك وموظف الذكاء الاصطناعي في صندوق وارد مشترك.
  • بدون أي عمولة على رسائل Meta: تدفعها لـ Meta مباشرة بالسعر الرسمي. جرّب أول شهر مجاناً.. وبعده الباقات بخصم 50%: Start بـ 6$ بدلاً من 12$.

أسئلة شائعة

هل أستطيع كتابة نص رسالة رمز التحقق بنفسي؟

لا. نص قالب Authentication ثابت تكتبه Meta بلغة القالب، وتختار أنت فقط تنبيه الأمان ومدة الصلاحية ونوع الزر.

هل رسائل OTP على واتساب مجانية؟

لا. تُحاسب كل رسالة مُسلَّمة بسعر Authentication: 0.0036$ لرقم مصري و0.0107$ لرقم سعودي (أسعار 1 أكتوبر 2026)، إلا داخل نافذة الإعلانات المجانية.

هل أرسل الرمز في قالب Utility إذا كان السعر نفسه؟

لا. Meta تقصر رموز التحقق على قوالب Authentication، والقالب الخدمي أو التسويقي الذي يرسل رموزاً يُرفض في أول الشهر التالي بعد إشعار.

هل يعمل زر الملء التلقائي على آيفون؟

لا، الملء بلمسة وبدون لمس لأندرويد فقط، ويظهر لمستخدمي آيفون زر نسخ الرمز، ومنذ iOS 26 تقترح لوحة المفاتيح الرمز تلقائياً.

ماذا يحدث لو كان موبايل العميل مغلقاً؟

تحاول Meta التسليم طوال مدة TTL، وهي 10 دقائق افتراضياً لقوالب المصادقة، ثم تُسقط الرسالة دون أن تُحاسب عليها. لذلك اجعلها مساوية لصلاحية الرمز أو أقل.

المصادر

رموز التحقق والمحادثات من رقم واحد

أنشئ قالب Authentication وأرسله من نظامك عبر واجهة API، وخلّ فريقك وموظف الذكاء الاصطناعي يردوا على نفس الرقم، بدون أي عمولة على أسعار Meta. جرّب أول شهر مجاناً.. وبعده الباقات بخصم 50%.

ابدأ تجربتك المجانية