تسجيل الدخولابدأ الفترة التجريبية المجانية
Meta Tech Provider

إرسال رموز التحقق (OTP) عبر WhatsApp

لإرسال رمز تحقق (OTP) عبر WhatsApp، ينشئ النشاط التجاري قالب مصادقة، وهو التنسيق الثابت الذي تفرضه Meta، ويكون نصه “<code> هو رمز التحقق الخاص بك.” مع زر نسخ الرمز أو زر بنقرة واحدة. ثم يرسله خادمه الخلفي عبر Cloud API، ويملأ الرمز فيه مرتين: في النص وفي الزر. تصل الرموز إلى 15 حرفاً كحد أقصى، ويتراوح تنبيه انتهاء الصلاحية الاختياري بين دقيقة واحدة و90 دقيقة.

تربط easyCoexistence رقم WhatsApp Business الخاص بك بواجهة Meta Cloud API عبر Coexistence، وتزوّد خادمك بما يحتاجه لإرسال قوالب المصادقة: نقطة Send، ورمز الوصول (token)، وعبر مساعدك الذكي create_template وget_template_status.

15 characters

أطول معامل يقبله قالب المصادقة، ولا تُسمح الروابط والوسائط والرموز التعبيرية في محتواه أو في معاملاته.

1 to 90 minutes

نطاق code_expiration_minutes، الذي يضيف إلى الرسالة سطر “ينتهي هذا الرمز خلال N دقيقة.”

10 minutes

المدة الافتراضية لصلاحية قالب المصادقة (TTL)، ويمكن ضبطها من 30 ثانية إلى 15 دقيقة.

131062

الخطأ الذي يُعاد عند إرسال قالب مصادقة إلى معرّف المستخدم ضمن نطاق النشاط التجاري بدلاً من رقم هاتف.

Primary device

تُسلَّم رسائل المصادقة إلى الجهاز الأساسي لواتساب للمستخدم فقط، أما الأجهزة المرتبطة فتعرض تنبيهاً بدلاً منها.

20 msg/s

الإنتاجية الثابتة لرقم Coexistence، وهي الحد الأقصى لدفعة رموز الدخول المتزامنة.

ما هو قالب مصادقة WhatsApp؟

هو التنسيق الوحيد الذي تسمح به Meta لكلمات المرور لمرة واحدة ورموز التحقق. إذا كان التطبيق يرسل الرموز عبر WhatsApp، فيجب أن يستخدم هذا القالب، ولا يمكن لقوالب الخدمة أو التسويق أن تحمل رمز مرور. النص ثابت، “<code> هو رمز التحقق الخاص بك.”، مع سطرين اختياريين: “لأمانك، لا تشارك هذا الرمز.” و“ينتهي هذا الرمز خلال <N> دقيقة.”. أما الخيار الذي تختاره فهو الزر. يعطّل WhatsApp إعادة توجيه هذه الرسائل، وعلى iOS 26 والإصدارات الأحدث يُعرض الرمز أيضاً كاقتراح في لوحة المفاتيح دون أي عمل من جهتك.

Copy codeTapping copies the code to the clipboard; the user pastes it in your app or site
One-tap autofillAndroid: the button opens your app and hands it the code; needs app changes and a handshake
Zero-tapAndroid only, no button: your app receives the code through a broadcast receiver

كيف تنشئ قالب المصادقة؟

اختره من مكتبة القوالب في WhatsApp Manager، أو أرسله عبر API، ويستطيع مساعدك الذكي ذلك باستخدام create_template والفئة AUTHENTICATION. لا ترسل نص الرسالة، إذ تكتبه Meta من إعداداتك، باللغة التي تختارها، وتحوّل زر OTP إلى زر رابط عند الإنشاء. قالب واحد لكل لغة. لا تمرر دالة create_template في الموصل message_send_ttl_seconds، لذا تُطبَّق المدة الافتراضية البالغة 10 دقائق ما لم تغيّرها عبر واجهة Meta البرمجية.

create_template arguments for a copy-code template
{
  "connection_id": "<from list_numbers>",
  "name": "login_code",
  "language": "en_US",
  "category": "AUTHENTICATION",
  "components": [
    { "type": "BODY", "add_security_recommendation": true },
    { "type": "FOOTER", "code_expiration_minutes": 5 },
    { "type": "BUTTONS", "buttons": [
      { "type": "OTP", "otp_type": "COPY_CODE", "text": "Copy code" }
    ]}
  ]
}

كيف يرسل خادمك الرمز؟

طلب واحد إلى نقطة النهاية (endpoint) /messages الخاصة بالرقم لكل رمز، مع رمز الوصول (token) من get_api_credentials أو من بطاقة “Plug in your own system” في لوحة التحكم. يُرسل الرمز نفسه مرتين: في معامل النص، وفي معامل الزر الرابط عند الفهرس 0، ويجب أن يكون المستلم رقم هاتف. قبل الإرسال، يولّد الخادم الخلفي الرمز، ويخزّن قيمة تجزئته (hash) مع وقت انتهاء الصلاحية وعداد للمحاولات، ثم يقارن لاحقاً ما يكتبه المستخدم بهذه القيمة.

Sending a login code from your backend
POST https://graph.facebook.com/<VERSION>/<PHONE_NUMBER_ID>/messages
Authorization: Bearer <ACCESS_TOKEN>

{
  "messaging_product": "whatsapp",
  "to": "5511987654321",
  "type": "template",
  "template": {
    "name": "login_code",
    "language": { "code": "en_US" },
    "components": [
      { "type": "body",
        "parameters": [{ "type": "text", "text": "482913" }] },
      { "type": "button", "sub_type": "url", "index": "0",
        "parameters": [{ "type": "text", "text": "482913" }] }
    ]
  }
}

لماذا يأتي الرمز من خادمك وليس من أتمتة؟

لأن النظام الذي يسجّل دخول المستخدم هو الذي يجب أن ينشئ الرمز ويحفظه ويتحقق منه، وهو وحده يعرف متى يلزم الرمز. تردّ الأتمتات على الرسائل التي يرسلها العملاء، ولا تكتب شاشة تسجيل الدخول أي شيء إلى رقمك. والقالب نفسه يستبعدها: زر OTP يحمل الرمز كمتغير في الزر، وخطوة “إرسال قالب” تملأ متغيرات النص فقط، فلا يمكنها إرسال قالب مصادقة. يستطيع مساعدك الذكي إرسال واحد عبر send_template، الذي يمرّر مكوّنات الأزرار إلى Meta، لكن ذلك للاختبار وليس لتدفق تسجيل الدخول.

ما الذي يجعل تدفق OTP على WhatsApp آمناً؟

تتفق توصيات Meta وحدود التنسيق على القائمة نفسها. لا يحتاج أي بند منها إلى شيء يتجاوز خادمك وواجهة Cloud API:

  • أكّد رقم WhatsApp مع المستخدم قبل أول رمز، وأخبره أن الرمز سيصل عبر WhatsApp.
  • اضبط مدة الصلاحية عند مدة صلاحية الرمز أو دونها، حتى لا يعرض تأخر التسليم رمزاً منتهياً.
  • حدّد عدد المحاولات وإعادة الإرسال لكل رقم، وأنهِ صلاحية الرمز عند أول استخدام.
  • لا تجعل رمز WhatsApp العامل الوحيد لاستعادة الحساب، فأرقام الهواتف المعاد تخصيصها قد تصل إلى حساب WhatsApp قديم.
  • راقب خطاف الويب (webhook) الخاص بالحالة، واعرض SMS أو البريد الإلكتروني عند فشل تسليم الرمز.

ماذا يتغير عندما يعمل الرقم أيضاً في تطبيق WhatsApp Business؟

يعمل الإرسال كما في أي رقم Cloud API، بحد أقصى 20 رسالة في الثانية. تنسخ Meta الرسائل المرسلة عبر API إلى محادثات التطبيق، لذا على رقم Coexistence تظهر الرموز التي ترسلها أيضاً في تلك المحادثات على هاتف النشاط التجاري. احتفظ بهذا الهاتف مع أشخاص تثق بهم، أو أرسل الرموز من رقم منفصل. وتطلب ممارسات Meta الجيدة أيضاً أن يرسل كل نشاط تجاري قوالب المصادقة من رقمه الخاص، لا من رقم مشترك بين أنشطة تجارية. والمصادقة فئة قوالب مدفوعة تُحتسب لكل رسالة مُسلَّمة بحسب بلد المستلم، مع أسعار مصادقة دولية منفصلة في بعض الأسواق، ولا يضيف easyCoexistence أي هامش، أي صفر هامش.

كيفية إعداده

  1. Connect the numberConnect your WhatsApp Business number to easyCoexistence through Meta's Coexistence flow, or use a separate number reserved for codes.
  2. Create the authentication templateAsk your AI to submit login_code with create_template, category AUTHENTICATION, a copy-code button and an expiry, then check get_template_status for APPROVED.
  3. Store the credentials on your serverCall get_api_credentials or open "Plug in your own system" in the dashboard, and put the Send endpoint and access token in your backend's secrets.
  4. Build generate, send and verifyGenerate the code, store its hash with an expiry, send the template with the code in the body and button, then check the user's entry against the hash.
  5. Handle failuresRead failed statuses from the number's webhook, then offer SMS or email and show the user which number the code went to.

الأخطاء الشائعة

  • كتابة الرمز داخل قالب خدمة مثل “رمزك هو {{1}}”. تسمح Meta برموز المرور في قوالب المصادقة فقط، وترفض قوالب الخدمة أو التسويق التي تحملها.
  • إرسال الرمز في النص فقط. يحتاج زر نسخ الرمز إلى القيمة نفسها كمعامل له، إذ تتوقع Meta الرمز مرتين في الطلب.
  • الإبقاء على مدة صلاحية 30 يوماً في قالب مصادقة قديم. هاتف غير متصل لمدة ساعة يستلم رمزاً منتهياً، لذا اضبطها عند مدة صلاحية الرمز أو دونها.
  • توجيه الرمز إلى معرّف مستخدم ضمن نطاق النشاط التجاري. قوالب المصادقة تُرسل إلى أرقام الهواتف فقط، وتعيد Meta الخطأ 131062.
إنجاز ذلك باستخدام EasyCoexistence

يُراقَب الرقم على مدار الساعة، فيصلك بالبريد الإلكتروني أي انقطاع قد يوقف رموز الدخول. من US$ 9 إلى US$ 0.75 لكل رقم شهرياً، ويتناقص كلما أضفت أرقاماً، مع فترة تجريبية مجانية مدتها 3 أيام.

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

هل رمز OTP عبر WhatsApp أرخص من رمز SMS؟

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

هل هذا هو نفسه رمز PIN للتحقق بخطوتين في WhatsApp؟

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

هل يحتاج المستخدمون إلى الموافقة المسبقة لتلقي الرموز؟

نعم. تشترط سياسة Meta الحصول على إذن قبل أن يراسل النشاط التجاري أي شخص، وترشد إرشاداتها لرموز OTP إلى عرض خيار بين القنوات، مثل WhatsApp أو SMS أو البريد الإلكتروني. واختيار WhatsApp في شاشة تسجيل الدخول، بجانب الرقم، هو هذا الإذن.

هل يمكن لوكالة إرسال الرموز لعدة عملاء من رقم واحد؟

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

تابع القراءة

تأكيدات طلبات WhatsApp وتحديثات الشحن، تلقائياًأرسل تأكيدات طلبات WhatsApp وتحديثات الشحن تلقائياً: قوالب utility، وحدث المتجر وراء كل منها، وروابط التتبع والردود والحالات.تأمين أتمتة WhatsApp: المفاتيح وخطاف الويب (webhook) والتوقيعاتتأمين أتمتة WhatsApp: مفاتيح الذكاء الاصطناعي مشفّرة ولا تُعرض مجددًا، وتوقيع X-EC-Signature على طلبات webhook، وأسرار تُعرض مرة واحدة وتُدوَّر.إنشاء قوالب WhatsApp بالذكاء الاصطناعي وإصلاح حالات الرفضاطلب من ChatGPT أو Claude كتابة قوالب WhatsApp وتقديمها ومتابعتها: الفئات والمتغيرات مع أمثلة ومدة المراجعة وأسباب رفض Meta وإعادة التقديم.إرسال رسائل WhatsApp تلقائياً من أنظمتك الخاصةأرسل رسائل WhatsApp تلقائياً من متجرك أو CRM أو n8n عبر Cloud API من Meta: القوالب وقاعدة الـ24 ساعة وبيانات الاعتماد والردود والحدود.فئات القوالب: المنفعة والتسويق والتحققتعرّف إلى فئات القوالب الثلاث، وما يندرج تحت كل منها، وفروق الفوترة والمراجعة، ولماذا يؤدي اختيار الفئة الخطأ إلى الرفض.أسماء مستخدمي WhatsApp ومعرّفات BSUID: ما يتغيّر في خطّاف الويب (webhooks) لـ Cloud APIكيف تغيّر أسماء مستخدمي WhatsApp مضمون webhooks في Cloud API: معرّف BSUID في user_id، ومتى يختفي wa_id وfrom، والرد عبر recipient، وتغييرات Coexistence.

هل أنت مستعد للبدء؟

أعد إعداد WhatsApp Coexistence خلال دقائق، وليس أشهر. يواصل التطبيق العمل على الهاتف.

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

تم التحقق في