> ## 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 لـ HubSpot وFlowella

> خزّن أرقام WhatsApp بتنسيق E.164 في HubSpot، واستوردها بنظافة من CSV وExcel، واستخدم الصيغة لتحويل الأرقام غير المنظَّمة تلقائيًا.

إذا كنت تستخدم HubSpot لتخزين أرقام WhatsApp لسير عمل Flowella، فإن التنسيق المتّسق ضروري. تؤدي الأرقام بتنسيق خاطئ إلى فشل عمليات الإرسال، وغالبًا ما يكون لغز "لماذا ينقص هذا الرقم رقمًا" مشكلة تنسيق. تشرح هذه الصفحة التنسيق الصحيح، وكيفية التحقق منه في HubSpot، وكيفية الاستيراد بنظافة، وكيفية إصلاح جدول بيانات مليء بأرقام غير منظَّمة قبل الاستيراد.

## استخدم تنسيق E.164

خزّن جميع أرقام هواتف WhatsApp بـ **تنسيق E.164**:

* علامة الزائد `+`
* رمز الدولة (دون صفر في البداية)
* الرقم الوطني الكامل (دون البادئة الرئيسية `0`)

**أمثلة:**

* خط أرضي بالمملكة المتحدة: `+442079460958`
* هاتف محمول بالمملكة المتحدة: `+447700900123`

تجنّب المسافات والأقواس والشرطات. يعرض HubSpot التنسيق بشكل جميل في واجهة المستخدم، لكن التكاملات — بما في ذلك Flowella — تعمل بشكل أفضل مع قيم E.164 العادية.

## أي خاصية HubSpot تحتفظ برقم WhatsApp؟

تكتب Flowella جهات الاتصال المكتشفة عبر WhatsApp إلى خاصية مخصصة — **`hs_whatsapp_phone_number`** — بدلًا من حقل `phone` العام.

| السيناريو                                          | حيث تكتب Flowella / تقرأ                                                                                                                                                |
| -------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| رسالة واردة من جهة اتصال غير موجودة بعد في HubSpot | يتم إنشاء جهة اتصال HubSpot جديدة مع كتابة رقم WhatsApp إلى `hs_whatsapp_phone_number`. تُترك خاصية `phone` العامة فارغة.                                               |
| رسالة واردة من جهة اتصال موجودة بالفعل             | تبحث Flowella في `hs_whatsapp_phone_number` **أولًا**، ثم تعود إلى `phone` / `mobilephone` لجهات الاتصال القديمة.                                                       |
| الصادر من سير عمل HubSpot                          | اختر `hs_whatsapp_phone_number` في القائمة المنسدلة **Recipient Phone Number** لأي إجراء سير عمل في Flowella. يعمل العودة إلى `phone` لكنه غير موصى به للأتمتة الجديدة. |

<Tip>
  إذا كانت لديك جهات اتصال موجودة يقع رقم WhatsApp الخاص بها في `phone` أو `mobilephone`، فانسخه إلى `hs_whatsapp_phone_number` باستخدام سير عمل HubSpot أو استيراد. يعود بحث Flowella إلى الحقول القديمة، لكن **المطابقة الواردة أسرع وأكثر موثوقية عندما يكون رقم WhatsApp في الخاصية المخصصة**.
</Tip>

## التحقق من صلاحية رقم في HubSpot

عندما تنقر على حقل هاتف في سجل جهة اتصال (على سبيل المثال، **Mobile phone number**)، يعرض HubSpot حالة أسفل الإدخال. تريد أن تظهر **Validated**.

إذا لم تظهر Validated:

* تحقق من أن الرقم يبدأ بـ `+` ورمز الدولة الصحيح
* تحقق من **عدم وجود `0` في البداية بعد رمز الدولة** (على سبيل المثال، `+4407…` خطأ — يجب أن يكون `+447…`)
* استخدم خيار **Remove number formatting** في HubSpot إذا لصقت قيمة غير نظيفة، ثم احفظ من جديد

<Tip>
  خطأ شائع في سير عمل Flowella هو توجيه الإجراء إلى خاصية **Phone number** بدلًا من **Mobile phone number**. تحقّق جيدًا من الخاصية التي تحتوي فعلًا على الرقم المفعّل لـ WhatsApp.
</Tip>

## نصائح استيراد CSV وExcel

سيقوم Excel "بالمساعدة" بإزالة علامة `+` أو تحويل الأرقام الطويلة إلى صيغة علمية. امنع ذلك قبل الاستيراد:

* نسّق عمود الهاتف كـ **Text** (Home → Number format → Text)، *ثم* الصق القيم
* أو ابدأ القيم بفاصلة عليا في Excel: `'+447700900123` — تفرض الفاصلة العليا معالجة نصية ولن تظهر في البيانات المستوردة
* في ملفات CSV، ضع القيم بين علامتي اقتباس: `"+447700900123"`

لا تستورد أرقامًا بها مسافات أو أقواس. غالبًا ما يمكن لـ HubSpot تطبيع التنسيق، لكن قيم E.164 النظيفة تعطي النتائج الأكثر اتساقًا.

## صيغة Excel: تنظيف أرقام الهواتف إلى E.164

إذا كان لديك جدول بيانات مليء بأرقام هواتف بتنسيقات متنوعة، فستقوم الصيغة أدناه بتنظيفها إلى تنسيق E.164، جاهزة للاستيراد إلى HubSpot.

تتعامل مع جميع تنسيقات الإدخال الشائعة، بما في ذلك:

* الأرقام المحلية ببادئة `0` (مثل `07700 900123`)
* الأرقام بعلامة `+` ورمز الدولة (مثل `+44 7700 900123`)
* بادئة الاتصال الدولية `00` (مثل `0044 7700 900123`)
* تنسيق `+44(0)7...`
* الشرطات والنقاط والأقواس وعلامات الترقيم الأخرى
* الأرقام التي تحتوي بالفعل على رمز الدولة دون `+` (مثل `447700900123`)

<Note>
  تتطلب هذه الصيغة **Excel 365 أو Google Sheets**. تستخدم `LET` و`TEXTJOIN` و`SEQUENCE`، وهي غير متوفرة في إصدارات Excel الأقدم.
</Note>

### كيفية استخدام الصيغة

1. انسخ الصيغة أدناه
2. الصقها في أي خلية في جدول البيانات
3. غيّر `A2` ليشير إلى خلية أول رقم هاتف
4. غيّر `"44"` إلى رمز دولتك (راجع جدول المرجع أدناه)
5. غيّر `10` إلى الطول المتوقع لرقم الهاتف المحمول لدولتك
6. اضغط Enter، ثم اسحب لأسفل لتطبيقها على كل الصفوف

### الصيغة

```excel theme={null}
=LET(
  cell, A2,
  country_code, "44",
  nsn_len, 10,
  raw, TRIM(cell&""),
  clean, SUBSTITUTE(raw,"(0)",""),
  digits, TEXTJOIN("",,IFERROR(MID(clean,SEQUENCE(LEN(clean)),1)*1,"")),
  has_plus, ISNUMBER(FIND("+",raw)),
  has_00, LEFT(digits,2)="00",
  p, LEN(country_code),
  starts_cc, AND(LEFT(digits,p)=country_code, LEN(digits)=p+nsn_len),
  nsn, IF(has_plus, digits,
    IF(has_00, MID(digits,3,999),
    IF(starts_cc, MID(digits,p+1,999),
    IF(LEFT(digits,1)="0", MID(digits,2,999), digits)))),
  intl, IF(has_plus, "+"&digits,
    IF(has_00, "+"&MID(digits,3,999),
    IF(starts_cc, "+"&digits,
    "+"&country_code&nsn))),
  is_domestic, AND(NOT(has_plus), NOT(has_00), NOT(starts_cc)),
  IF(raw="","",
  IF(digits="","REVIEW (not a number): "&raw,
  IF(AND(is_domestic, LEN(nsn)<nsn_len),"REVIEW (number too short): "&raw,
  IF(AND(is_domestic, LEN(nsn)>nsn_len),"REVIEW (number too long): "&raw,
  intl))))
)
```

### ماذا تعني متغيرات التكوين الثلاثة

| المتغير        | ما يجب تغييره                                                                                                   |
| -------------- | --------------------------------------------------------------------------------------------------------------- |
| `cell`         | الخلية التي تحتوي على رقم الهاتف الخام — غيّرها لتطابق عمودك (مثل `G2`)                                         |
| `country_code` | رمز الدولة الافتراضي للأرقام المحلية (مثل `"44"` للمملكة المتحدة، و`"1"` للولايات المتحدة)                      |
| `nsn_len`      | الطول المتوقع لرقم المشترك الوطني لأرقام الهواتف المحمولة في دولتك (مثل `10` للمملكة المتحدة والولايات المتحدة) |

### كيف تعمل الصيغة

تأخذ الصيغة أربعة مسارات مختلفة بناءً على ما تجده في الإدخال:

1. **تحتوي على `+` في الأصل** — دولي بالفعل؛ احذف وأبقِ الأرقام وأضف `+` في البداية
2. **تبدأ بـ `00`** — بادئة اتصال دولية؛ احذف `00` وأضف `+` في البداية
3. **تبدأ برمز الدولة ويتطابق عدد الأرقام** — دولي بدون علامة (مثل `447700900123`)؛ أضف `+` في البداية
4. **كل ما عدا ذلك** — رقم محلي؛ احذف `0` البادئ وأضف `+` ورمز الدولة في البداية

قبل أي من ذلك، تزيل الصيغة `(0)` من الإدخال الخام، حتى يُعالَج `+44(0)7700 900123` بشكل نظيف.

### إخراج الأرقام غير الصالحة

ترجع الأرقام التي لا تجتاز التحقق رسالة واضحة حتى تتمكن من تصفيتها وإصلاحها:

| الإخراج                                  | المعنى                                             |
| ---------------------------------------- | -------------------------------------------------- |
| `REVIEW (not a number): hello world`     | لم يتم العثور على أرقام على الإطلاق                |
| `REVIEW (number too short): 07700`       | عدد الأرقام غير كافٍ لرقم صالح                     |
| `REVIEW (number too long): 077009001234` | عدد الأرقام أكثر من اللازم، ربما بسبب بادئة مزدوجة |

ينطبق التحقق من الطول فقط على الأرقام المحلية (تلك التي بدون `+` أو `00`). تُمرَّر الأرقام التي تحتوي بالفعل على بادئة دولية كما هي، نظرًا لأن الصيغة لا يمكنها معرفة طول NSN لكل دولة.

## مرجع رموز الدول

| الدولة                   | رمز الدولة | طول NSN (محمول) | ملاحظات                                    |
| ------------------------ | ---------- | --------------- | ------------------------------------------ |
| المملكة المتحدة          | 44         | 10              |                                            |
| الولايات المتحدة / كندا  | 1          | 10              | جميع دول NANP تتشارك cc=1                  |
| فرنسا                    | 33         | 9               |                                            |
| ألمانيا                  | 49         | 11              | محمول فقط؛ الخطوط الأرضية متغيرة           |
| إسبانيا                  | 34         | 9               |                                            |
| إيطاليا                  | 39         | 10              | تحتفظ الهواتف المحمولة بالرقم 3 في البداية |
| البرتغال                 | 351        | 9               |                                            |
| هولندا                   | 31         | 9               |                                            |
| أيرلندا                  | 353        | 9               |                                            |
| اليونان                  | 30         | 10              |                                            |
| بولندا                   | 48         | 9               |                                            |
| سويسرا                   | 41         | 9               |                                            |
| تركيا                    | 90         | 10              |                                            |
| الهند                    | 91         | 10              |                                            |
| أستراليا                 | 61         | 9               |                                            |
| اليابان                  | 81         | 10              |                                            |
| الصين                    | 86         | 11              |                                            |
| الإمارات العربية المتحدة | 971        | 9               |                                            |
| المملكة العربية السعودية | 966        | 9               |                                            |
| جنوب أفريقيا             | 27         | 9               |                                            |
| البرازيل                 | 55         | 11              | محمول مع الرقم التاسع                      |
| سنغافورة                 | 65         | 8               |                                            |
| هونغ كونغ                | 852        | 8               |                                            |

قيم طول NSN أعلاه خاصة بأرقام الهواتف المحمولة. لاستخدام WhatsApp، فإن الأطوال للهواتف المحمولة فقط صحيحة. إذا كنت تعالج مزيجًا من أرقام الهواتف المحمولة والخطوط الأرضية، فاعلم أن بعض الدول (وخاصة ألمانيا) لديها خطوط أرضية متغيرة الطول.

## قائمة تحقق سريعة لاستكشاف الأخطاء

<Tip>
  إذا كانت إجراءات سير عمل Flowella تفشل في تسليم الرسائل، فاعمل من خلال قائمة التحقق هذه:

  * تأكد من أن خاصية HubSpot تحتوي على قيمة بـ **تنسيق E.164** (تبدأ بـ `+`)
  * تأكد من أن الحقل يعرض حالة **Validated** في HubSpot
  * تأكد من أن الرقم يتضمن رمز الدولة وأنه **بدون `0` في البداية** بعده
  * تأكد من أن إجراء سير العمل يشير إلى الخاصية الصحيحة — تلك التي تحتوي فعلًا على الرقم المفعّل لـ WhatsApp، وليس حقل هاتف مختلف
</Tip>

## ذات صلة

<CardGroup cols={2}>
  <Card title="إعداد HubSpot" icon="plug" href="/hubspot/setup">
    اربط بوّابة HubSpot الخاصة بك واختر الخصائص التي تقرأها Flowella.
  </Card>

  <Card title="إجراءات سير العمل" icon="git-branch" href="/hubspot/workflow-actions">
    اختر خاصية الهاتف الصحيحة عند تكوين Send WhatsApp Template.
  </Card>

  <Card title="فشل مزامنة HubSpot" icon="bug" href="/troubleshooting/hubspot-sync-failures">
    مشكلات تنسيق الهاتف هي السبب الأكثر شيوعًا لفشل عمليات الإرسال.
  </Card>

  <Card title="الرسائل غير المسلّمة" icon="message-x" href="/troubleshooting/messages-not-delivered">
    شخّص عمليات الإرسال الفردية التي لا تصل إلى المستلِم.
  </Card>
</CardGroup>