زر «اطلب عبر واتساب» من أقصر الطرق بين الزبون ومتجرك. وهو في النهاية رابط واحد يحمل شيئين: رقمك ورسالة جاهزة. إن كان الرقم بصيغة خاطئة لم يفتح الزر المحادثة، وإن كانت الرسالة مشفّرة خطأً رأى الزبون في مربع الدردشة رموزاً مثل %D9%85 بدل «مرحبا».
والخطأ هنا صامت: الصفحة سليمة، والزر يظهر، ولا يرى النتيجة إلا زبون يلمسه، وقد لا يرسل ما رأى. فهذا المقال يمشي على الرابط جزءاً جزءاً: الصيغة، ثم رقم الهاتف، ثم ترميز الرسالة العربية، ثم روابط الاتصال والبريد، ثم طريقة التحقق.
الصيغة التي توثّقها واتساب
تذكر صفحة مساعدة واتساب عن رابط النقر للدردشة ثلاث صيغ:
https://wa.me/<number>
https://wa.me/<number>?text=<urlencodedtext>
https://wa.me/?text=<urlencodedtext>الأولى تفتح محادثة مع رقم. والثانية تضيف رسالة جاهزة تظهر تلقائياً في مربع النص داخل المحادثة. والثالثة بلا رقم: يرى من يلمسها قائمة جهات اتصاله ليختار منها من يرسل إليه الرسالة. وتحدد الصفحة الرقم بأنه رقم كامل بالصيغة الدولية، وتطلب حذف الأصفار والأقواس والشرطات. ومثالها الصحيح https://wa.me/1XXXXXXXXXX والخاطئ https://wa.me/+001-(XXX)XXXXXXX.
والصيغة الثالثة تصلح لأزرار «شارك» حيث يختار الزائر من يرسل إليه، أما زر «تواصل معنا» فيحتاج رقمك لتصله الرسالة.
وهذه الصفحة لا تذكر الصيغة api.whatsapp.com/send?phone=، لكن أدواتنا تفحصها أيضاً إن وجدتها في صفحتك، بالقاعدة نفسها على قيمة phone.
رقم الهاتف: دولي وبالأرقام فقط
اكتب رمز الدولة ثم الرقم بلا صفره المحلي. ورموز الخليج: السعودية 966 والإمارات 971 وعُمان 968 والكويت 965 والبحرين 973 وقطر 974. وتحذّر صفحة واتساب عن تنسيق الأرقام الدولية من إضافة صفر أو رمز اتصال خاص في أول الرقم.
<!-- خطأ -->
<a href="https://wa.me/0501234567">راسلنا على واتساب</a>
<a href="https://wa.me/+968 9123 4567">راسلنا على واتساب</a>
<!-- صواب -->
<a href="https://wa.me/966501234567">راسلنا على واتساب</a>
<a href="https://wa.me/96891234567">راسلنا على واتساب</a>قاعدة صيغة رابط واتساب تفرّق بين خمس حالات: أرقام عربية مشرقية، ورموز غير الأرقام كـ+ والمسافة والشرطة، وصفر في البداية، ورقم ليس دولياً كاملاً والأرجح أنه ينقصه رمز الدولة، وصفر الاتصال المحلي بعد رمز الدولة مثل 9660501234567 وصحيحه 966501234567. وتتحقق من إمكان الرقم ببيانات أرقام الهواتف في libphonenumber-js المبنية على بيانات Google. ولا تعرف إن كان للرقم حساب على واتساب، فذلك يحتاج الاتصال بها.
ونصيحة عملية: لا تنظّف الرقم بالتعبير \D، فهو يحذف الأرقام العربية المشرقية بدل أن يحوّلها، فيضيع رقم كتبه الزائر في نموذجك. حوّلها إلى 0-9 أولاً، كما يفعل مولّد رابط واتساب في متصفحك. ويقرأ فحص رابط واتساب الروابط التي في <a> و<area> في HTML الصفحة، ولا يفحص الروابط بلا رقم مثل wa.me/message/….
ترميز الرسالة العربية
الرسالة في الرابط يجب أن تُرمَّز بالنسبة المئوية. يحدد RFC 3986 أن البايت المرمّز علامة % يتبعها رقمان ستة عشريان، وأن النص غير ASCII يُحوَّل أولاً إلى بايتات بترميز UTF-8 ثم تُرمَّز تلك البايتات (القسمان 2.1 و2.5). فحرف الميم يصير %D9%85، وكلمة «مرحبا» تصير:
%D9%85%D8%B1%D8%AD%D8%A8%D8%A7وفي RFC نفسه أن # يبدأ جزء الشظية (القسم 3.5)، وأن & من الفواصل الفرعية المحجوزة (القسم 2.2). فرقم طلب مثل #1042 إن كتبته خاماً أنهى العنوان وسقط ما بعده، ولذلك يُكتب %23. والأسهل ألا تحسب كل هذا بيدك: الدالة encodeURIComponent في JavaScript، وفق MDN، تُرمّز بـ UTF-8 وتُبقي الحروف اللاتينية والأرقام وبعض الرموز فقط.
const message = 'أريد الطلب رقم #1042'
const url = `https://wa.me/966501234567?text=${encodeURIComponent(message)}`
// https://wa.me/966501234567?text=%D8%A3%D8%B1%D9%8A%D8%AF%20%D8%A7%D9%84%D8%B7%D9%84%D8%A8%20%D8%B1%D9%82%D9%85%20%231042رمّز النص وحده، لا العنوان كله. ومقابلها في PHP الدالة rawurlencode.
زر المنتج: ابنِ الرسالة مرة واحدة
زر «اسأل عن هذا المنتج» يحمل اسم المنتج في رسالته، وهنا يقع خطأ الترميز. ابنِ الرسالة من بيانات المنتج في الخادم، ورمّزها مرة واحدة عند كتابة الرابط، ولا ترسل قالباً فيه متغيّر ليملأه المتصفح:
function productLink(phone, product) {
const message = `مرحباً، أسأل عن ${product.name} (رقم ${product.id})`
return `https://wa.me/${phone}?text=${encodeURIComponent(message)}`
}وأكثر ما يسبب الترميز مرتين أن يرمّز قالبك النص ثم تعيد إضافة أو حقل رابط ترميزه. فلا تفترض ما في لوحة التحكم، وانظر إلى الرابط الذي وصل إلى href في الصفحة المنشورة.
ست طرق تتشوه بها الرسالة
قاعدة ترميز الرسالة تقرأ النص كما هو مكتوب في الرابط، وتصنف الخطأ إلى:
| الحالة | ما يراه الزبون |
|---|---|
ترميز مرتين، %25D9%2585… | %D9%85… في مربع الدردشة |
| بايتات ليست UTF-8، مثل Windows-1256 | حروف مكسورة أو رفض |
% لا يتبعها رقمان | الرابط مشوّه، والصواب %25 |
# خام | تسقط الرسالة من موضعها فما بعد |
| عربية قُرئت بترميز خاطئ | نص مشوّه |
متغيّر لم يُملأ مثل {{product_name}} | اسم المتغير نفسه في الرسالة |
ولا تفتح القاعدة الرابط ولا تتصل بواتساب. وفحص زر الطلب عبر واتساب هو الأنسب لأزرار المنتجات لأنه يفحص الرقم والرسالة معاً، وتقول صفحته إن بعض الروابط المعيبة يصلحها المتصفح على سطح المكتب وتفشل في الهواتف.
روابط الاتصال والبريد
الزبون الذي لا يستعمل واتساب يلمس «اتصل بنا». قاعدة روابط الاتصال تفحص صيغة tel: وmailto: بأربع رسائل: رقم بأرقام عربية مشرقية، ورقم بلا رمز دولة، ورقم غير ممكن في دولته، وبريد ليس عنواناً لأنه يفتقد اسماً أو @ أو نطاقاً.
والصيغة هنا مختلفة عن واتساب: يعرّف RFC 3966 الأرقام العالمية بعلامة + في أولها، ويوجب أن يحمل الرقم المحلي معامل phone-context، ويوصي ألا يُستعمل إلا حين يتعذر الرقم العالمي. فعنوان tel: يبدأ بـ+، وعنوان واتساب لا يحمله:
<a href="tel:+966501234567" dir="ltr">050 123 4567</a>
<a href="https://wa.me/966501234567">راسلنا على واتساب</a>
<a href="mailto:[email protected]">[email protected]</a>ويجيز RFC 3966 فواصل بصرية في عنوان tel: مثل الشرطة والنقطة والأقواس، لكنها للقراءة فقط ولا تُستعمل في الاتصال، ولا يجيز المسافات فيها، فالأنظف أن تكتب العنوان أرقاماً متصلة بعد +. واكتب الأرقام 0-9 في العنوان أياً كانت الأرقام التي يعرضها النص، وبعد رمز الدولة يُحذف الصفر المحلي. وdir="ltr" على النص المعروض يحفظ ترتيب رقمه داخل الجملة العربية، وهذه مسألة من النص ثنائي الاتجاه. فاحص روابط الهاتف والبريد يقرأ الصيغة فقط: لا يتصل ولا يرسل، ولا يعرف إن كان الرقم يجيب أو صندوق البريد موجوداً.
وإن جمع نموذجك رقم الزبون لتراسله، فتأكد أن حقل الهاتف لا يقلب رقمه: فحص حقول الهاتف يعرض الصفحة في ثلاثة متصفحات ويقرأ اتجاه كل حقل، وتجد شرح الحقول في مقال النماذج.
كيف تتحقق
- شغّل فحص رابط واتساب على كل صفحة فيها زر.
- شغّل فاحص زر الطلب على صفحة منتج.
- أنشئ الروابط الجديدة بالمولّد بدل أن تكتبها بيدك.
- شغّل فاحص روابط الهاتف والبريد.
- المس الزر على هاتف حقيقي، واقرأ الرسالة في المربع: يجب أن تكون عربية سليمة.
وتنبّه إلى حدود هذه الفحوص كلها: تقرأ الصيغة فقط. رقم مكتوب بصيغة صحيحة قد يكون رقماً قديماً لا يرد، ولا تعرف الأدوات ذلك. فاجمع أرقام موقعك في مكان واحد في القالب، رقم واتساب ورقم الاتصال والبريد، وولّد منه كل الروابط، حتى يتغير الرقم في موضع واحد فيتغير في الموقع كله.
والأدوات تقرأ HTML كما يرسله الخادم، فزر تضيفه المنصة بسكربت بعد التحميل لا ترى الأداة رابطه. ولأخطاء المنصات الأخرى انظر مقال سلة وزد.
قائمة قبل أن تنشر
- الرقم دولي بالأرقام
0-9فقط: بلا+ولا صفر ولا مسافة في رابط واتساب. - رابط
tel:يبدأ بـ+. - الرسالة مرمّزة مرة واحدة بـ UTF-8، والنص وحده هو المرمّز.
#و&والمسافة والسطر الجديد مرمّزة:%23و%26و%20و%0A.- لا متغير قالب في الرسالة.
- جرّبت الزر على هاتف.