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

إذا كنت تخزّن أرقام WhatsApp في HubSpot لاستخدامها في مسارات سير عمل Flowella، فإن التنسيق المتسق يمنع فشل عمليات الإرسال. تشرح هذه الصفحة التنسيق الذي يجب استخدامه، والتنسيقات التي يقبلها Flowella، وخاصية HubSpot التي يقرؤها Flowella، وكيفية تنظيف جدول بيانات من الأرقام قبل استيراده.

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

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

علامة الجمع +
رمز الدولة (دون صفر في البداية)
الرقم الوطني الكامل (دون رمز الاتصال المحلي 0 في البداية)

أمثلة:

هاتف أرضي في المملكة المتحدة: +442079460958
هاتف محمول في المملكة المتحدة: +447700900123

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

التنسيقات التي يقبلها Flowella

عندما يرسل إجراء سير عمل رسالة، يحوّل Flowella الرقم المخزّن إلى E.164. يتجاهل المسافات والشرطات والأقواس، لكنه يحتاج إلى رمز الدولة.

القيمة المخزّنة	ما يفعله Flowella
`+44 7700 900123`	يرسل إلى `+447700900123`
`+447700900123`	يرسل إلى `+447700900123`
`0044 7700 900123`	يقرأ `00` كبادئة دولية ويرسل إلى `+447700900123`
`447700900123`	يقرأ الرقم على أنه يبدأ برمز دولة ويرسل إلى `+447700900123`
`07700 900123`	يفشل مع `CONTACT_PHONE_INVALID`، لعدم وجود رمز دولة

يقرأ Flowella الرقم الذي لا يبدأ بـ + أو 00 كما لو كان يبدأ برمز دولة. وقد يطابق الرقم الوطني عندها دولة خاطئة. على سبيل المثال، رقم الولايات المتحدة (202) 555-0123 المخزّن دون +1 يُقرأ كرقم مصري يبدأ بـ +20. أدرج رمز الدولة دائمًا.

أي خاصية في HubSpot تحتوي على رقم WhatsApp؟

يحتوي HubSpot على خاصية مخصصة لرقم هاتف WhatsApp، وهي hs_whatsapp_phone_number. يستخدمها Flowella أولًا، قبل الخاصيتين العامتين Mobile phone number (mobilephone) وPhone number (phone).

السيناريو	ما يقرؤه Flowella أو يكتبه
رسالة واردة من شخص غير موجود في HubSpot بعد	ينشئ Flowella جهة اتصال في HubSpot مع رقم WhatsApp في `hs_whatsapp_phone_number`. وتُترك الخاصية العامة `phone` فارغة. يتطلب ذلك إمكانية CRM contacts (auto-create on new WhatsApp chat).
رسالة واردة من جهة اتصال موجودة بالفعل	يبحث Flowella في `hs_whatsapp_phone_number` أولًا، ثم `mobilephone`، ثم `phone`. وعندما يطابق جهة اتصال، يكتب رقم WhatsApp في `hs_whatsapp_phone_number` إذا كانت هذه الخاصية فارغة أو تحتوي على رقم مختلف.
Send WhatsApp Template أو Send WhatsApp Message في سير عمل HubSpot	يستخدم Flowella خاصية الهاتف التي تربطها في الإجراء. إذا كانت هذه الخاصية فارغة لدى جهة الاتصال، يجرّب `hs_whatsapp_phone_number`، ثم `mobilephone`، ثم `phone`.
Send WhatsApp Reply في سير عمل HubSpot	لا يحتوي الإجراء على حقل هاتف. يجرّب Flowella دائمًا `hs_whatsapp_phone_number`، ثم `mobilephone`، ثم `phone`.

إذا لم تحتوِ أي من هذه الخصائص على رقم، يفشل الإجراء مع CONTACT_PHONE_MISSING. وإذا تعذّرت قراءة الرقم، يفشل مع CONTACT_PHONE_INVALID. راجع رموز الأخطاء.

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

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

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

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

تحقق من الخاصية التي تحتوي فعليًا على الرقم المفعّل على WhatsApp قبل ربطها في إجراء سير عمل. غالبًا ما يكون Phone number لجهة الاتصال هاتفًا أرضيًا، بينما قد يكون رقم WhatsApp الخاص بها في Mobile phone number أو hs_whatsapp_phone_number.

نصائح استيراد 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 تفشل مع CONTACT_PHONE_MISSING أو CONTACT_PHONE_INVALID، فاتبع قائمة التحقق هذه:

تأكد من أن خاصية HubSpot تحتوي على قيمة بتنسيق E.164 (تبدأ بـ +)
تأكد من أن الحقل يعرض حالة Validated في HubSpot
تأكد من أن الرقم يتضمن رمز الدولة ولا يوجد 0 في البداية بعده
تأكد من أن إجراء سير العمل يشير إلى الخاصية التي تحتوي فعليًا على الرقم المفعّل على WhatsApp، ويُفضَّل hs_whatsapp_phone_number
إذا كانت الخاصية المربوطة فارغة، فتحقق من الخصائص البديلة بالترتيب الذي يقرؤها به Flowella: hs_whatsapp_phone_number، ثم mobilephone، ثم phone

توصيل HubSpot

وصّل حساب HubSpot الخاص بك وتحقق من إمكاناتك.

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

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

أعطال المزامنة مع HubSpot

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

الرسائل التي لم تُسلَّم

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

البدء

أساسيات

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

الإعدادات

إعداد Meta وWhatsApp

تكامل HubSpot

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

مرجع API

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

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

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

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

التنسيقات التي يقبلها Flowella

أي خاصية في HubSpot تحتوي على رقم WhatsApp؟

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

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

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

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

الصيغة

ماذا تعني متغيرات الإعداد الثلاثة

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

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

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

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

ذات صلة

توصيل HubSpot

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

أعطال المزامنة مع HubSpot

الرسائل التي لم تُسلَّم

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

​التنسيقات التي يقبلها Flowella

​أي خاصية في HubSpot تحتوي على رقم WhatsApp؟

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

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

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

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

​الصيغة

​ماذا تعني متغيرات الإعداد الثلاثة

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

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

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

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

​ذات صلة

توصيل HubSpot

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

أعطال المزامنة مع HubSpot

الرسائل التي لم تُسلَّم

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

التنسيقات التي يقبلها Flowella

أي خاصية في HubSpot تحتوي على رقم WhatsApp؟

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

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

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

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

الصيغة

ماذا تعني متغيرات الإعداد الثلاثة

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

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

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

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

ذات صلة