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

# رمز QR لرقم هاتف

> إنشاء رمز QR يتصل برقم هاتف.

## الغرض منه

يفتح رمز QR لرقم الهاتف أداة الاتصال في الجهاز مع تعبئة رقم مسبقًا، بحيث يكون مسحه طريقة بضغطة واحدة للاتصال بعمل تجاري، أو خط دعم، أو جهة اتصال. إنه **Quick Code** — رمز QR ذو إجراء مباشر بدون صفحة هبوط.

<Note>
  في التطبيق، تُقرأ بطاقة هذا النوع وعنوان صفحته **"Phone Call"** بدلًا من "Phone Number" — لا تزال الفئة الأساسية (وهذه الصفحة) تسميها Phone Number، بما يطابق قيمة `name` التي تُعيدها نقطة نهاية API الخاصة بـ `/qr/category/` لهذه الفئة.
</Note>

<Note>
  Phone Number **ثابت (static) فقط** — لا يوجد خيار Dynamic لهذا النوع. بعد النشر، لا يمكن تعديل الرقم المُرمّز أو تتبعه؛ لتغييره، أنشئ رمز QR جديدًا.
</Note>

## إنشاء رمز QR لرقم هاتف

<Steps>
  <Step title="فتح Create QR Code واختيار Quick Code">
    من الشريط الجانبي، انتقل إلى **QR Codes**، ثم انقر على **Create QR Code** (أو انتقل إلى `/qr/create`). انقر على بطاقة **Quick Code**.
  </Step>

  <Step title="اختيار Phone Call">
    في شبكة أنواع **Quick Code**، انقر على **Configure** أسفل **Phone Call**، في قسم **Static Only** — والذي يُوصف هناك بـ "Open the dialer pre-filled with your number." سيفتح هذا النموذج على المسار `/qr/quick/phone`.
  </Step>

  <Step title="إدخال رقم الهاتف">
    اكتب الرقم في حقل **Phone number** الوحيد (نص نائب: `+1 415 555 0100`). هذا هو الحقل الوحيد في النموذج وهو مطلوب للنشر.

    يُتحقق من الحقل عند فقدان التركيز: يقبل الأرقام، والمسافات، والأقواس، والشرطات، وعلامة `+` اختيارية في البداية، ويحتاج بين 6 و15 رقمًا إجمالًا (بما يطابق الحد الأقصى لتنسيق E.164). إدخال مثل `123` يفشل مع الرسالة **"Please enter a valid phone number."**

    <Frame caption="رقم هاتف غير صالح يعرض خطأ التحقق الضمني">
      <img src="https://mintcdn.com/scanova-api/q8t3kzcRTgAP7jV0/images/v2/qr-codes/create/phone-number/phone-number-validation-error.png?fit=max&auto=format&n=q8t3kzcRTgAP7jV0&q=85&s=9614634b21ac100a876329af7b3c9b73" alt="نموذج Phone Call Quick Code يعرض حقل رقم الهاتف بالقيمة 123 مظللًا بالأحمر، ورسالة الخطأ Please enter a valid phone number أسفله" width="1440" height="900" data-path="images/v2/qr-codes/create/phone-number/phone-number-validation-error.png" />
    </Frame>

    <Frame caption="نموذج Phone Call Quick Code مع إدخال رقم صالح">
      <img src="https://mintcdn.com/scanova-api/q8t3kzcRTgAP7jV0/images/v2/qr-codes/create/phone-number/phone-number-form-filled.png?fit=max&auto=format&n=q8t3kzcRTgAP7jV0&q=85&s=34231c948a14c0a22ac76ed6bd4234ff" alt="نموذج Phone Call Quick Code مع تعبئة حقل رقم الهاتف بـ +1 415 555 0142 ومعاينة حية لرمز QR ظاهرة على اليمين" width="1440" height="900" data-path="images/v2/qr-codes/create/phone-number/phone-number-form-filled.png" />
    </Frame>
  </Step>

  <Step title="النشر">
    انقر على **Publish**. تنفتح لوحة لتأكيد رمز QR أو إعادة تسميته (يكون افتراضيًا "Call \<number>")، وتعيين مجلد أو وسوم، وضبط تصميم رمز QR قبل التأكيد.
  </Step>
</Steps>

## إنشاؤه عبر الـ API

لإنشاء رمز QR لرقم هاتف عبر الـ API بدلًا من الواجهة، استخدم معرّف الفئة `4` (المسمّى **Phone Number**، حيث `allowed_qr_types: "st"` — القيمة `"st"` فقط صالحة لـ `qr_type`)، مع حمولة `info` بالشكل التالي:

```json theme={null}
{
  "type": "phoneNumber",
  "data": {
    "number": "+14155550142"
  }
}
```

تقبل الواجهة الخلفية أي نص لحقل `number` (لا يوجد تحقق من التنسيق من جانب الخادم) — فحص تنسيق الهاتف الموصوف أعلاه هو من جانب العميل فقط، لضمان قدرة أجهزة المسح فعليًا على الاتصال بالنتيجة. راجع [Create QR Code](/v1/api-reference/endpoint/qr_manager/create) للاطلاع على مخطط الطلب الكامل.

<Note>
  لا يُدرج جدول مرجع [Category List](/v1/api-reference/references/category-list) حاليًا Phone Number (أو غيرها من فئات Quick Code الحصرية في هذه الصفحة) — جرى تأكيد المعرّف أعلاه مباشرة من نقطة النهاية الحية `/qr/category/`.
</Note>

## ذات صلة

* [رمز QR للرسائل النصية](/ar/qr-codes/create/text-message) — يستخدم نفس تحقق رقم الهاتف لتعبئة رسالة SMS مسبقًا بدلًا من مكالمة.
* [إنشاء أول رمز QR لك](/ar/getting-started/first-qr-code) — دليل كامل لسير عمل Quick Code الذي ينتمي إليه هذا النوع.
* [المجلدات والوسوم والعمليات المجمّعة](/ar/qr-codes/manage/folders-tags-bulk-operations) — تنظيم رمز QR بعد نشره.