آخر تحديث: 5 نوفمبر 2026 · إعداد: فريق مظبوت (MazBot) · المصدر الأساسي: توثيق Meta لمرجع Webhook الرسائل (كائن referral) وConversions API لرسائل الأعمال ومعاملات بيانات العميل
الإجابة المختصرة: ctwa_clid (Click to WhatsApp Click ID) معرّف تولّده Meta عندما ينقر شخص إعلاناً يفتح واتساب ويرسل رسالة، وهو فريد لكل نقرة. يصلك داخل كائن referral في Webhook تلك الرسالة مع رقم الإعلان ونصه. تحفظه مع المحادثة، ثم ترسله دون تشفير مع حدث مثل Purchase أو LeadSubmitted عبر Conversions API لرسائل الأعمال، فتنسب Meta الشراء إلى الإعلان وتتعلم الوصول لمن يشتري. ولا يُرسل لإعلانات حالة واتساب (Status).
هذه صفحة تعريف بالمصطلح. وللإعداد الكامل اقرأ: تتبع تحويلات إعلانات واتساب وربطها بـ Meta Conversions API، ولاختيار هدف الحملة: محادثات أم عملاء محتملين أم مشتريات؟
محتوى المقال:
- ما هو ctwa_clid؟
- أين يظهر في Webhook واتساب؟
- كيف تعرف Meta مصدر العميل وما الذي لا تراه؟
- كيف تستخدمه مع Conversions API؟
- ماذا لو لم يصلك ctwa_clid؟
- مثالان من القاهرة والرياض
- مفاهيم خاطئة شائعة
- كيف يساعدك مظبوت؟
- أسئلة شائعة
ما هو ctwa_clid في إعلانات واتساب؟
الاسم اختصار Click to WhatsApp Click ID، أي «معرّف نقرة إعلان النقر لواتساب». ويصفه مرجع Webhook من Meta بأنه معرّف النقرة الذي يتولّد عندما ينقر المستخدم إعلاناً وجهته واتساب ثم يرسل رسالة. أهم ما تعرفه عنه:
- فريد لكل نقرة: تصفه Meta بأنه «معرّف شخصي فريد لكل نقرة»، فالشخص نفسه إذا نقر إعلانك مرتين يأخذ معرّفين مختلفين.
- ليس رقم الإعلان: رقم الإعلان حقل آخر اسمه source_id. أما ctwa_clid فيربط محادثة بعينها بنقرة بعينها.
- تولّده Meta لا أنت: لا تصنعه ولا تعدّله، بل تستقبله وتحفظه وتعيده كما هو.
- بيانات شخصية: لأنه يدل على نقرة شخص محدد، عامله كبقية بيانات العميل في نظامك.
أين يظهر ctwa_clid في Webhook واتساب؟
عندما يرسل العميل رسالة من إعلان Click to WhatsApp، يضيف Cloud API إلى الرسالة في Webhook الرسائل كائناً اسمه referral، ولا يظهر هذا الكائن في الرسائل التي لم تأتِ من إعلان. حقوله كما في مرجع Meta:
| الحقل | معناه |
|---|---|
| source_type | نوع المصدر، وقيمته ad |
| source_id | رقم الإعلان (Ad ID) |
| source_url | رابط الإعلان |
| headline / body | عنوان الإعلان ونصه الأساسي |
| media_type | image أو video |
| image_url / video_url / thumbnail_url | رابط الصورة لإعلان الصورة، ورابط الفيديو وصورته المصغرة لإعلان الفيديو |
| ctwa_clid | معرّف النقرة، ويُحذف كلياً لرسائل إعلانات حالة واتساب |
| welcome_message.text | نص الترحيب المكتوب في الإعلان |
وشكل الكائن مختصراً من مثال Meta:
"referral": {
"source_url": "https://fb.me/3cr4Wqqkv",
"source_id": "120226305854810726",
"source_type": "ad",
"headline": "Chat with us",
"media_type": "image",
"ctwa_clid": "Aff-n8ZTODiE79d22KtAwQKj9e_mIEOOj27...",
"welcome_message": { "text": "Hi there! Let us know how we can help!" }
}
حسب مرجع Webhook رسائل النص في توثيق Meta، اطّلعنا عليه في 5 نوفمبر 2026. وتنبّه Meta إلى أن كائن referral في Cloud API يختلف عن نظيره القديم في On-Premises API.
كيف تعرف Meta مصدر العميل؟ وما الذي لا تراه؟
النقرة تحدث داخل منصات Meta نفسها، فتعرف Meta من جهتها أن شخصاً نقر إعلانك وبدأ محادثة. لكن إذا كان رقمك على واتساب API، فهي لا ترى ما يحدث في المحادثة بعد ذلك: هل حجز؟ هل اشترى؟ بكم؟ هنا دور ctwa_clid:
| المرحلة | من يعرفها؟ | دور ctwa_clid |
|---|---|---|
| النقر على الإعلان وبدء المحادثة | Meta | يتولّد هنا ويصلك مع أول رسالة من الإعلان |
| الأسئلة والتفاوض داخل المحادثة | نظامك وفريقك | محفوظ مع المحادثة |
| عميل محتمل مؤهل أو شراء | نظامك فقط، حتى ترسله | ترسله مع الحدث فتنسبه Meta للنقرة والإعلان |
والنتيجة: تقارير الإعلانات تعرض المشتريات لا المحادثات وحدها، وخوارزمية الإعلان تتعلم صفات من يشتري. وتقول Meta في توثيق Conversions API لرسائل الأعمال إنه «يتيح الوصول إلى التحسين للمشتريات» لإعلانات النقر إلى Messenger وإلى واتساب.
كيف تستخدم ctwa_clid مع Conversions API لرسائل الأعمال؟
- احفظه مع المحادثة: تقول Meta: عند استلام ctwa_clid احفظه مع المحادثة، وأرسله عندما يحدث تحويل فيها.
- مجموعة بيانات (Dataset) مرتبطة بحساب واتساب: تُنشأ بالطلب POST /{WABA_ID}/dataset وتُستعلم بـ GET على المسار نفسه، فيعود رقم dataset_id. وتقول Meta إن مجموعات البيانات ملك العميل، ويصل إليها الشريك بالصلاحيات اللازمة.
- أرسل الحدث إلى POST /{DATASET_ID}/events بمصدر business_messaging وقناة whatsapp:
{
"event_name": "Purchase",
"event_time": 1793880000,
"action_source": "business_messaging",
"messaging_channel": "whatsapp",
"user_data": {
"whatsapp_business_account_id": "",
"ctwa_clid": ""
},
"custom_data": { "currency": "EGP", "value": 1450 }
}
- لا تشفّره: صفحة معاملات بيانات العميل تقول عن ctwa_clid صراحة «Do not hash»، بعكس الهاتف والبريد اللذين يُشفَّران بـ SHA-256.
- الأحداث المدعومة لرسائل الأعمال تشمل Purchase وLeadSubmitted وQualifiedLead وInitiateCheckout وAddToCart وViewContent وOrderCreated وOrderShipped وOrderDelivered وOrderCanceled وOrderReturned وCartAbandoned وRatingProvided وReviewProvided.
- للمطورين: يحتاج الرمز صلاحيتي whatsapp_business_management وwhatsapp_business_manage_events، والثانية بوصول متقدم (Advanced Access).
- للتحسين: هدف «المشتريات عبر الرسائل» يحتاج 10 أحداث شراء أو أكثر خلال 30 يوماً، والتفاصيل في هدف حملة إعلانات واتساب.
ماذا لو لم يصلك ctwa_clid؟
- إعلانات حالة واتساب (Status): تقول Meta إن الحقل يُحذف كلياً لرسائل هذه الإعلانات، فلا تتوقعه منها.
- المحادثة لم تبدأ من إعلان: لا يوجد كائن referral أصلاً، فلا شيء تنسبه لإعلان.
- البديل المشفّر: تسمح Meta بإرسال الحدث ببيانات العميل مشفرة (مثل الهاتف) مع page_id الصفحة، وتقول إن الحدث بلا page_id يُرفض. لكن المطابقة غير مؤكدة، وتقتصر على تفاعلات إعلانية خلال آخر 7 أيام، ومتاحة في مجموعة من الدول فقط؛ لذلك توصي بإرسال ctwa_clid كلما توفر لأنه أدق.
- الأحداث التلقائية من Meta: توثق Meta ميزة اختيارية تحلل فيها محادثات إعلانات واتساب الجديدة وترسل أحداث LeadSubmitted وPurchase إلى Webhook مع ctwa_clid، وهي غير متاحة في الاتحاد الأوروبي والمملكة المتحدة واليابان وكوريا الجنوبية.
مثالان على ctwa_clid من القاهرة والرياض
عيادة أسنان في مدينة نصر: تنشر إعلانين لتبييض الأسنان، فيديو وصورة. مريض ينقر إعلان الفيديو ويكتب «التبييض بكام؟»، فيصل Webhook برسالته ومعها source_id إعلان الفيديو وctwa_clid النقرة. يحجز موعداً فترسل العيادة حدث LeadSubmitted، ثم يدفع 3,500 جنيه بعد الجلسة فترسل Purchase بالقيمة والعملة EGP مع المعرّف نفسه. بعد شهر تظهر في مدير الإعلانات مشتريات إعلان الفيديو، فتنقل الميزانية إليه.
متجر عبايات في الرياض: عميلة تنقر إعلان الكاروسيل وتطلب عباءتين بـ 900 ريال. يرسل نظام المتجر Purchase بقيمة 900 وعملة SAR مع ctwa_clid محادثتها. وعندما يتجاوز المتجر 10 أحداث شراء خلال 30 يوماً يجرّب هدف «المشتريات عبر الرسائل» بدل «المحادثات».
والمحادثة التي تبدأ من إعلان Click to WhatsApp عبر الموبايل، وترد عليها خلال 24 ساعة، تفتح نافذة مجانية قد تمتد 7 أيام، فلا تدفع لـ Meta ثمن ردودك فيها (ما هو Free Entry Point؟).
ما المفاهيم الخاطئة الشائعة عن ctwa_clid؟
- «ctwa_clid هو رقم الإعلان»: لا. رقم الإعلان في source_id، وctwa_clid للنقرة نفسها.
- «يصل مع كل رسالة من العميل»: يأتي داخل referral مع الرسالة المرسلة من الإعلان، فاحفظه وقتها مع المحادثة.
- «أشفّره مثل رقم الهاتف»: لا. Meta تقول لا تشفّره، والمشفّر لن يطابق.
- «روابط UTM تكفي»: نقرة إعلان واتساب تفتح محادثة لا صفحة ويب تحمل UTM، فالذي يربط المحادثة بالنقرة هو ctwa_clid.
- «كل إعلانات واتساب ترسله»: إعلانات الحالة (Status) لا ترسله.
- «أرسل حدثاً عن كل رسالة»: أرسل ما يدل على قيمة فعلية، كعميل مؤهل أو شراء، حتى تتعلم الخوارزمية من نتائج حقيقية.
كيف يساعدك مظبوت؟
- حفظ ctwa_clid تلقائياً: كل محادثة من إعلان تحمل معرّف النقرة، ووسم إعلانات واتساب، واسم الحملة والإعلان اللذين جاء منهما العميل.
- لوحة Meta Conversions في صندوق الوارد: زر «Mark qualified lead» وزر «Record purchase» يرسلان الحدث إلى Meta عبر Conversions API لرسائل الأعمال.
- أحداث تلقائية: يرسل مظبوت أحداث العميل المحتمل والشراء عند اكتمال مسار، أو حجز موعد، أو إضافة وسم، أو وصول طلب من نظامك عبر الواجهة البرمجية.
- فريق كامل على رقم واحد مع بقاء تطبيق واتساب بيزنس، وبدون أي عمولة على رسائل Meta، والاشتراك من 6$ شهرياً بعد خصم 50% (السعر الأصلي 12$).
أسئلة شائعة
أين أجد ctwa_clid في رسالة واتساب؟
في كائن referral داخل Webhook الرسالة التي أرسلها العميل من إعلان Click to WhatsApp، بجانب source_id رقم الإعلان وheadline وbody نص الإعلان.
هل أشفّر ctwa_clid قبل إرساله إلى Conversions API؟
لا. صفحة معاملات بيانات العميل من Meta تقول «Do not hash»، فترسله كما وصلك في user_data مع رقم حساب واتساب للأعمال.
لماذا لا يصلني ctwa_clid من بعض الإعلانات؟
لأن Meta تحذفه كلياً لرسائل إعلانات حالة واتساب (Status). وفي هذه الحالة يمكن إرسال الحدث ببيانات العميل المشفرة مع page_id، بمطابقة غير مؤكدة خلال 7 أيام.
ما الأحداث التي أرسلها مع ctwa_clid؟
الأكثر استخداماً LeadSubmitted وQualifiedLead للعملاء المحتملين، وPurchase بالقيمة والعملة للمبيعات، وتدعم Meta أيضاً أحداث الطلب والسلة والتقييم.
هل أحتاج ctwa_clid لأحسّن الإعلان للمشتريات؟
تحتاج أن تشارك مع Meta أحداث شراء من المحادثات، 10 على الأقل خلال 30 يوماً. وctwa_clid أدق طريقة لربط كل شراء بإعلانه.
اقرأ أيضاً:
المصادر
- Meta: Text messages webhook reference (كائن referral وحذف ctwa_clid لإعلانات Status) (اطّلعنا عليها في 5 نوفمبر 2026)
- Meta: Conversions API for Business Messaging (حفظ المعرّف، ومجموعة البيانات، والأحداث، والمطابقة بلا ctwa_clid) (اطّلعنا عليها في 5 نوفمبر 2026)
- Meta: Customer information parameters (ctwa_clid: Do not hash) (اطّلعنا عليها في 5 نوفمبر 2026)
- Meta: Automatic Events API (اطّلعنا عليها في 5 نوفمبر 2026)
- مركز مساعدة Meta للأعمال: How to optimize your click-to-message ad campaigns for purchases (اطّلعنا عليها في 5 نوفمبر 2026)
إعلاناتك تجيب مبيعات.. مش رسايل وبس
مع مظبوت: معرّف النقرة يُحفظ مع كل محادثة من إعلان، واسم الحملة والإعلان أمام فريقك، وزر واحد يرسل الشراء إلى Meta عبر Conversions API، بدون أي عمولة على أسعار Meta. جرّب أول شهر مجاناً.. وبعده الباقات بخصم 50%، ومعه 250,000 توكن مجانية للذكاء الاصطناعي للحسابات الجديدة.
