تنسيق أرقام هاتف WhatsApp لـ HubSpot وFlowella

إذا كنت تستخدم 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` لكنه غير موصى به للأتمتة الجديدة.

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

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

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

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

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

نصائح استيراد 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)

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

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

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

الصيغة

=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` للمملكة المتحدة والولايات المتحدة)

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

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

تحتوي على + في الأصل — دولي بالفعل؛ احذف وأبقِ الأرقام وأضف + في البداية
تبدأ بـ 00 — بادئة اتصال دولية؛ احذف 00 وأضف + في البداية
تبدأ برمز الدولة ويتطابق عدد الأرقام — دولي بدون علامة (مثل 447700900123)؛ أضف + في البداية
كل ما عدا ذلك — رقم محلي؛ احذف 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، فإن الأطوال للهواتف المحمولة فقط صحيحة. إذا كنت تعالج مزيجًا من أرقام الهواتف المحمولة والخطوط الأرضية، فاعلم أن بعض الدول (وخاصة ألمانيا) لديها خطوط أرضية متغيرة الطول.

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

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

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

إعداد HubSpot

اربط بوّابة HubSpot الخاصة بك واختر الخصائص التي تقرأها Flowella.

إجراءات سير العمل

اختر خاصية الهاتف الصحيحة عند تكوين Send WhatsApp Template.

فشل مزامنة HubSpot

مشكلات تنسيق الهاتف هي السبب الأكثر شيوعًا لفشل عمليات الإرسال.

الرسائل غير المسلّمة

شخّص عمليات الإرسال الفردية التي لا تصل إلى المستلِم.

البدء

سجل التغييرات

أساسيات

استخدام التطبيق

الإعدادات

إعداد Meta وWhatsApp

تكامل HubSpot

التدفقات والحملات

الحساب وتسجيل الدخول

الأمان والخصوصية

مرجع API

استكشاف الأخطاء

تنسيق أرقام هاتف WhatsApp لـ HubSpot وFlowella

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

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

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

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

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

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

الصيغة

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

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

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

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

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

ذات صلة

إعداد HubSpot

إجراءات سير العمل

فشل مزامنة HubSpot

الرسائل غير المسلّمة

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

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

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

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

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

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

​الصيغة

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

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

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

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

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

​ذات صلة

إعداد HubSpot

إجراءات سير العمل

فشل مزامنة HubSpot

الرسائل غير المسلّمة

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

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

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

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

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

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

الصيغة

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

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

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

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

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

ذات صلة