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

# نماذج التقاط العملاء

> صمّم النموذج الذي يملؤه الزائر، وأبقِه مرتبطاً بالـ CRM بشكل صحيح.

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

## الـ `label` والـ `name`

لكل حقل معرّفان، والخلط بينهما هو أكثر أخطاء الإعداد شيوعاً في Tap.

<CardGroup cols={2}>
  <Card title="label" icon="eye">
    النص الذي يقرؤه الزائر. شكلي بحت — غيّره متى شئت.
  </Card>

  <Card title="name" icon="key">
    المفتاح الثابت الذي تُحفظ به الإجابة، وهو ما يشير إليه ربط الـ CRM. بنيوي.
  </Card>
</CardGroup>

<Warning>
  تغيير الـ **`label`** آمن دائماً. تغيير الـ **`name`** يكسر بصمت كل ربط بالـ CRM يشير إلى المفتاح القديم — يستمر الحقل في جمع البيانات ويتوقف عن الوصول إلى الـ CRM.
</Warning>

عند إضافة حقل مخصّص، يولّد Tap الـ `name` من الـ `label`. وبما أن المفتاح يُشتق عند الإنشاء، فإن تعديل الـ `label` لاحقاً **لا** يغيّر المفتاح — وهذا بالضبط ما يبقي الربط مستقراً.

## النموذج الافتراضي

الحساب الجديد بلا نموذج محفوظ يجمع أربعة حقول بهذا الترتيب:

<Steps>
  <Step title="الاسم الكامل">
    `full-name` — نص
  </Step>

  <Step title="البريد الإلكتروني">
    `email` — بريد
  </Step>

  <Step title="الجوال">
    `phone-mobile` — هاتف
  </Step>

  <Step title="ملاحظة">
    `note` — نص طويل
  </Step>
</Steps>

<Note>
  إن حفظت نموذجاً بلا أي حقول، يعيد Tap إنشاء هذه الأربعة بدل عرض نموذج فارغ على الزوار. إفراغ النموذج ليس وسيلة لتعطيل الالتقاط.
</Note>

## الحقول الجاهزة

هذه الحقول لها مفاتيح محجوزة معروفة المعنى، وهو ما يتيح لـ Tap ربطها تلقائياً بخصائص الـ CRM القياسية. فضّلها على الحقول المخصّصة كلما أمكن.

### الهوية والتواصل

| التسمية | المفتاح | النوع |
| - | - | - |
| الاسم الكامل | `full-name` | text |
| البريد الإلكتروني | `email` | email |
| المسمّى الوظيفي | `job-title` | text |
| LinkedIn | `linkedin` | url |

### الشركة

| التسمية | المفتاح | النوع |
| - | - | - |
| اسم الشركة | `company-name` | text |
| موقع الشركة | `company-website` | url |

### الهواتف

| التسمية | المفتاح | النوع |
| - | - | - |
| رقم الهاتف | `phone-number` | tel |
| الجوال | `phone-mobile` | tel |
| هاتف العمل | `phone-work` | tel |
| هاتف المكتب | `phone-office` | tel |
| الفاكس | `phone-fax` | tel |

### الموقع

| التسمية | المفتاح | النوع |
| - | - | - |
| الموقع | `lead-location` | text |
| الدولة | `lead-location-country` | text |
| المدينة | `lead-location-city` | text |
| المنطقة | `lead-location-state` | text |
| العنوان ١ | `lead-location-street-1` | text |
| العنوان ٢ | `lead-location-street-2` | text |
| الرمز البريدي | `lead-location-postal-code` | text |

### الملاحظات

| التسمية | المفتاح | النوع |
| - | - | - |
| ملاحظة | `note` | textarea |
| رسالة | `message` | textarea |

<Note>
  تبقى بعض المفاتيح القديمة صالحة للحسابات المنشأة سابقاً — `mobile-number`، `primary-email`، `secondary-email`، `primary-phone`، `secondary-phone`، `address`، `image`. لا تحتاج ترحيلها، لكن استخدم المفاتيح الحديثة أعلاه لأي حقل جديد.
</Note>

## الحقول المخصّصة

أي شيء لا تغطّيه الحقول الجاهزة يصبح حقلاً مخصّصاً بمفتاح مشتق من التسمية. الحقول المخصّصة تعمل تماماً كالجاهزة، عدا الربط بالـ CRM: لا يستطيع Tap تخمين مكانها، فيجب ربطها يدوياً.

## من أين يأتي النموذج

يحصل الملف على حقول الالتقاط من ثلاثة مصادر، بهذا الترتيب:

<Steps>
  <Step title="قالب الملف">
    إن كان الملف يستخدم قالباً يعرّف حقول التقاط، تُستخدم حقول القالب.
  </Step>

  <Step title="نموذج العضو المحفوظ">
    وإلا، الحقول التي حفظها العضو لنفسه.
  </Step>

  <Step title="الحقول الأربعة الافتراضية">
    وإن لم يحفظ العضو نموذجاً قط، تُستخدم المجموعة الافتراضية.
  </Step>
</Steps>

<Tip>
  إن أصرّ مندوب أنه غيّر نموذجه ولا يظهر التغيير، تحقّق مما إذا كان ملفه على قالب يعرّف حقول التقاط. حقول القالب تتجاوز الحقول الشخصية بصمت.
</Tip>

## أفضل الممارسات

<AccordionGroup>
  <Accordion title="من أربعة إلى ستة حقول كحد أقصى" icon="ruler">
    تنخفض نسبة الإكمال بحدّة بعد ستة حقول. أي شيء يمكن إثراؤه لاحقاً من عنوان البريد لا مكان له في النموذج.
  </Accordion>

  <Accordion title="ضع حقل الملاحظة في النهاية" icon="arrow-down">
    الحقول النصية الحرة هي الأكثر عرضة للتخلّي. وضعها بعد بيانات التواصل يعني أن من يتوقّف في المنتصف يكون قد ترك عميلاً صالحاً.
  </Accordion>

  <Accordion title="استخدم وسماً للفعالية لا حقلاً" icon="tag">
    لا تطلب من الزائر كتابة اسم الفعالية. ضع وسماً على العملاء لاحقاً — أدقّ ولا يكلّف الزائر شيئاً.
  </Accordion>
</AccordionGroup>


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