> ## Documentation Index
> Fetch the complete documentation index at: https://knowledge.flowella.io/llms.txt
> Use this file to discover all available pages before exploring further.

# قوالب المصادقة في WhatsApp لرموز المرور

> كيف ترسل قوالب المصادقة في WhatsApp رموز المرور: صياغة ثابتة، وأزرار النسخ والنقرة الواحدة ودون نقر، ومدة الصلاحية، والإرسال من Flowella.

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

> [!NOTE]
>
> **في Flowella.** مدعوم جزئيًا. يمكن لـ Flowella إرسال قوالب المصادقة عبر [Flowella API](https://knowledge.flowella.io/ar/hubspot/workflows/authentication-otp.md)، برمز مختلف لكل مستلم. لا يستطيع محرر Flowella إضافة أزرار رموز المرور، لذا أنشئ القالب في WhatsApp Manager. لا يمكن لسير عمل HubSpot إرسال رموز المرور.

## محتوى الرسالة

| الجزء | المحتوى | هل يمكنك تغييره |
| - | - | - |
| المتن | نص Meta المعدّ مسبقًا: الرمز متبوعًا بعبارة "is your verification code"، مترجمة إلى لغة القالب | الرمز فقط |
| سطر الأمان | "For your security, do not share this code." | تشغيل أو إيقاف |
| سطر انتهاء الصلاحية | "This code expires in N minutes"، من 1 إلى 90 دقيقة | تشغيل أو إيقاف، وعدد الدقائق |
| الزر | نسخ الرمز أو الملء التلقائي بنقرة واحدة أو zero-tap | النوع، وتفاصيل التطبيق لخيار النقرة الواحدة |

لا يمكن أن تحتوي قوالب المصادقة على روابط أو وسائط أو رموز تعبيرية، ويقتصر كل متغير على 15 حرفًا. استخدم الأرقام والحروف فقط في الرمز.

## أنواع الأزرار

| النوع | طريقة العمل | يعمل على |
| - | - | - |
| **Copy code** | ينقر الشخص على الزر، فينسخ WhatsApp الرمز، ثم يلصقه في تطبيقك أو موقعك | أي هاتف، دون أي عمل من جانبك |
| **One-tap autofill** | ينقر الشخص على الزر فيسلّم WhatsApp الرمز مباشرة إلى تطبيق Android الخاص بك | Android، مع تعديلات على تطبيقك |
| **Zero-tap** | يمرر WhatsApp الرمز إلى تطبيق Android الخاص بك دون أي نقرة | Android، مع تعديلات على تطبيقك وقبول شروط zero-tap من Meta |

في iOS 26 والإصدارات الأحدث، يقترح iOS الرمز على لوحة المفاتيح من الإشعار، لكل قوالب المصادقة، دون أي عمل من جانبك. لا تملأ إصدارات iOS الأقدم الرمز تلقائيًا، لذا يبقى زر نسخ الرمز الخيار الآمن إذا لم تكن تبني تطبيق Android أصليًا.

> [!WARNING]
>
> إذا كان تطبيق Android الخاص بك يبدأ مصافحة النقرة الواحدة أو zero-tap باستخدام `PendingIntent`، فانتقل إلى OTP Android SDK من Meta قبل 31 يناير 2027، وهو موعد إيقاف Meta لطريقة `PendingIntent`.

## الأجهزة المرتبطة

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

## مدة الصلاحية

| | القيمة |
| - | - |
| القيمة الافتراضية لدى Meta | 10 دقائق. القوالب المنشأة قبل 23 أكتوبر 2024 قيمتها الافتراضية 30 يومًا. |
| النطاق الذي يمكنك ضبطه | من 30 ثانية إلى 15 دقيقة |

اضبط مدة الصلاحية بحيث لا تتجاوز مدة صلاحية رمزك، حتى لا يتلقى أحد رمزًا منتهي الصلاحية. لا يوفر Flowella إعدادًا لمدة الصلاحية. إذا احتجت إلى قيمة مخصصة، فاضبطها على القالب في WhatsApp Manager.

## السعر

تُحتسب رسوم رسائل المصادقة لكل رسالة مُسلّمة، مع [شرائح الحجم](https://knowledge.flowella.io/ar/whatsapp/pricing/whatsapp-pricing.md#volume-tiers-for-utility-and-authentication). في بعض الأسواق، تحتسب Meta سعرًا أعلى هو **authentication-international** عندما يرسل نشاط تجاري مؤهل رموزًا إلى أرقام في ذلك السوق. راجع [أسعار WhatsApp](https://knowledge.flowella.io/ar/whatsapp/pricing/whatsapp-pricing.md).

## إنشاء قالب في WhatsApp Manager

**1. ابدأ قالبًا**

في [WhatsApp Manager](https://business.facebook.com/latest/whatsapp_manager/message_templates)، انقر على **Create template** واختر **Authentication**. يمكنك أيضًا البدء من قالب مصادقة في مكتبة Meta.

**2. اختر الخيارات**

اختر نوع الزر، وفعّل سطر الأمان وسطر انتهاء الصلاحية إذا أردتهما. لخيار النقرة الواحدة أو zero-tap، أضف اسم حزمة تطبيق Android وتجزئة التوقيع.

**3. أرسل القالب**

اختر اللغات وأرسل القالب. تكتب Meta الصياغة، لذا تكون المراجعة سريعة عادةً.

يظهر القالب بعد ذلك في صفحة **Templates** في Flowella، جاهزًا للإرسال عبر الـ API.

## إرسال رموز المرور من Flowella

ينشئ تطبيقك الرمز ويخزّنه مع مدة انتهاء، ثم يستدعي `POST /v1/templates/send` مع الرمز كمتغير المتن وقيمة الزر. يرفض Flowella أي رمز يزيد على 15 حرفًا قبل أن يصل إلى Meta. للاطلاع على شرح كامل يتضمن قواعد إعادة الإرسال والقفل، راجع [إرسال رموز المرور لمرة واحدة](https://knowledge.flowella.io/ar/hubspot/workflows/authentication-otp.md).

## الممارسات الجيدة

* **تحقق من الرقم أولًا.** تأكد من أن رقم WhatsApp يخص الشخص قبل أن ترسل إليه رمزًا.
* **أخبر الأشخاص بأن الرمز سيصل عبر WhatsApp**، خاصة إذا كنت تتيح أيضًا الرسائل النصية أو البريد الإلكتروني.
* **أظهر أنك استلمته.** عندما يلصق الشخص الرمز أو يستلمه تطبيقك، أكّد ذلك على الشاشة.
* **لا ترسل الرموز في قوالب Marketing أو Utility.** ترفض Meta القوالب التي تحمل رموز مرور في الفئة الخطأ، بدءًا من اليوم الأول من الشهر التالي. راجع [فئات القوالب](https://knowledge.flowella.io/ar/whatsapp/templates/template-categories.md#when-meta-changes-a-category-after-approval).

## ذو صلة

> [card] [إرسال رموز المرور لمرة واحدة](https://knowledge.flowella.io/ar/hubspot/workflows/authentication-otp.md)
>
> شرح Flowella API خطوة بخطوة.

> [card] [مكتبة القوالب](https://knowledge.flowella.io/ar/whatsapp/templates/template-library.md)
>
> قوالب Meta الجاهزة.

> [card] [أساسيات القوالب](https://knowledge.flowella.io/ar/whatsapp/templates/template-fundamentals.md)
>
> الأسماء واللغات والحالات والحدود.

> [card] [أسعار WhatsApp](https://knowledge.flowella.io/ar/whatsapp/pricing/whatsapp-pricing.md)
>
> أسعار المصادقة والسعر الدولي.

تمت المراجعة مقابل وثائق Meta في 18 نوفمبر 2026: [Authentication templates](https://developers.facebook.com/documentation/business-messaging/whatsapp/templates/authentication-templates/authentication-templates) و[Template categorization](https://developers.facebook.com/documentation/business-messaging/whatsapp/templates/template-categorization) و[Time-to-live](https://developers.facebook.com/documentation/business-messaging/whatsapp/templates/time-to-live).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.