إرسال حدث تحويل CTWA إلى Facebook Conversion API

نظرة عامة

استخدم إجراء قاعدة دورة الحياة إرسال حدث تحويل CTWA لإرسال أحداث تحويل النقر للانتقال إلى WhatsApp (CTWA) من Chakra إلى Meta Conversions API (مراسلة الأنشطة التجارية). تحدد Chakra مصدر الحدث باستخدام ctwa_clid من مصدر التسويق في المحادثة أو العملية.

المتطلبات الأساسية

• اتصال Facebook / Meta ضمن المسؤول → اتصالات الحسابات الإعلانية (مطلوب حتى تتمكن Chakra من إرسال أحداث تحويل CTWA عبر Meta Conversions API)
• حركة الإعلانات CTWA / WhatsApp، بحيث يتضمن مصدر التسويق في المحادثة أو العملية marketingSource ctwa_clid و wabaId
• حساب WhatsApp Business (WABA) يمكن لـ Chakra استخدامه لتحديد مجموعة بيانات التحويل في Meta
• إذن إنشاء قواعد دورة الحياة وتعديلها

ربط Facebook / Meta في Chakra

1. انتقل إلى المسؤول → اتصالات الحسابات الإعلانية (/admin/ad-account-connections).
2. انقر على ربط حساب إعلاني.
3. ضمن موفّر الحساب الإعلاني، اختر Facebook / Meta.
4. تابع باستخدام Facebook ووافق على الأذونات المطلوبة (بما في ذلك إدارة أحداث WhatsApp Business) حتى تتمكن Chakra من إرسال أحداث التحويل Pixel وCTWA عبر Meta Conversions API.
5. تأكد من ظهور اتصال Meta الجديد في قائمة اتصالات الحسابات الإعلانية قبل إنشاء قاعدة دورة الحياة.

متى تستخدم هذا الإجراء

اختر إرسال حدث تحويل CTWA لتحويلات النقر للانتقال إلى WhatsApp. إذا لم يتوفر ctwa_clid ، تتخطى Chakra الإرسال (ولا تعتبر القاعدة فاشلة بسبب خطأ جسيم). أما لتحويلات Meta Conversions API المستندة إلى Pixel أو تدفقات OAuth الأخرى لحسابات Meta الإعلانية التي تحدد حسابًا إعلانيًا / Pixel بعينه في الإجراء، فاستخدم إرسال التحويل إلى الحساب الإعلاني بدلًا من ذلك.

إنشاء قاعدة دورة الحياة

1. افتح قواعد دورة الحياة وأنشئ قاعدة للحظة التي تريد احتسابها كتحويل (مثل تغيير حالة العملية أو حدث في المحادثة).
2. أضف أي شروط للأحداث تحتاج إليها (مثلًا، عند انتقال حالة العميل المحتمل إلى «تم التحويل» فقط).
3. أضف الإجراء إرسال حدث تحويل CTWA.
4. اضبط تعريف الإجراء باستخدام الحقول أدناه، ثم احفظ القاعدة وفعّلها.

حقول الإجراء

• اسم الحدث (مطلوب) — قيمة Meta event_name مثل Lead أو Purchase أو اسم مخصص
• القيمة (اختياري) — قيمة التحويل الرقمية؛ يتوافق مع Handlebars
• العملة (اختياري) — مثل INR أو USD
• البيانات المخصصة (اختياري) — معلمات إضافية للحدث على شكل أزواج مفتاح/قيمة

آلية عمل الإحالة

• تقرأ Chakra ctwa_clid و wabaId من مصدر التسويق marketingSource.
• تُرسل الأحداث مع action_source=business_messaging وقناة المراسلة whatsapp.
• يُحدَّد مصدر مجموعة بيانات Meta تلقائيًا من WABA عند تشغيل الإجراء.

التحقق

1. تأكد من وجود اتصال Facebook / Meta ضمن اتصالات الحسابات الإعلانية.
2. ابدأ محادثة CTWA حتى تحفظ Chakra ctwa_clid في المحادثة أو العملية.
3. استوفِ شرط قاعدة دورة الحياة (مثل نقل العميل المحتمل إلى حالة «تم التحويل»).
4. تأكد من تشغيل القاعدة بنجاح، ثم تحقق من حدث التحويل في Meta Events Manager.

ملاحظات

• من دون اتصال حساب إعلاني على Facebook / Meta، لا يمكن لـ Chakra إرسال أحداث تحويل CTWA إلى Meta Conversions API.
• عدم توفر ctwa_clid ← يتم تخطي الإجراء.
• تظهر حالات تعذّر تحديد مجموعة البيانات من WABA على هيئة أخطاء في الإجراء.
• راجع أيضًا نظرة عامة على قواعد دورة الحياة ضمن المنصة → الميزات لمعرفة كيفية عمل الأحداث والإجراءات معًا.