يمكن استخدام المتغيرات الديناميكية لتخصيص الرسائل الصادرة. يمكن أن يكون مخاطبة جهات الاتصال شخصيًا في المحادثات عنصرًا رئيسيًا في بناء العلاقات، حيث تجعلهم يشعرون بأنهم مرئيون ومُشمولون.
هناك ثلاثة أنواع من المتغيرات الديناميكية على المنصة:
متغيرات جهة الاتصال القياسية تمثل حقول جهة الاتصال القياسية مثل الاسم الأول واسم العائلة والبريد الإلكتروني.
متغيرات حقول جهة الاتصال المخصصة تمثل الحقول المخصصة التي تمت إضافتها إلى مساحة العمل.
متغيرات سير العمل هي متغيرات مؤقتة موجودة فقط أثناء جلسة سير العمل. بمجرد خروج جهة الاتصال من سير العمل، سيتم مسح قيمة المتغير.
هناك ثلاثة أنواع من متغيرات سير العمل: متغيرات المشغل، متغيرات المخرجات، والمتغيرات التي يتم إنشاؤها من خلال خطوة اسأل سؤال
أمثلة على المتغيرات الديناميكية
يمكن إدراج المتغيرات الديناميكية عن طريق إضافة البادئة "$" إلى مجال جهة الاتصال. وفيما يلي بناء الجملة:
$contact, $assignee أو $system
تدعم المنصة دمج النص الثابت مع المتغيرات الديناميكية.
متغيرات جهة الاتصال القياسية
المتغير | وصف |
|---|---|
$contact.name | يتم استبداله بالاسم الكامل لجهة الاتصال (الاسم الأول + اسم العائلة). |
$contact.firstname | يتم استبداله بالاسم الأول لجهة الاتصال. |
$contact.lastname | يتم استبداله باسم العائلة لجهة الاتصال. |
$contact.email | يتم استبداله بالبريد الإلكتروني لجهة الاتصال. |
$contact.country | يتم استبداله ببلد جهة الاتصال. إذا لم يكن لدى جهة الاتصال أي بلد مخزن، فلن يتم استبداله وسيتم إرسال السلسلة الفعلية. |
$contact.id | يتم استبداله بمعرف جهة الاتصال. |
متغيرات حقول جهة الاتصال المخصصة
المتغير | وصف |
|---|---|
$contact.field_name | يتم استبداله بالقيمة في المجال المخصص. على سبيل المثال، إذا كان الحقل المخصص "مدينة" موجودًا وكانت لدى جهة الاتصال قيمة "نيويورك"، فإن إرسال $contact.city سيُستبدل بـ نيويورك. |
متغيرات النظام
المتغير | وصف |
|---|---|
$system.current_datetime | يتم استبداله بالتاريخ والوقت الحاليين في المنطقة الزمنية لمساحة العمل. |
$system.current_date | يتم استبداله بالتاريخ الحالي في المنطقة الزمنية لمساحة العمل. |
$system.current_time | يتم استبداله بالوقت الحالي في المنطقة الزمنية لمساحة العمل. |
متغيرات المحال إليه
المتغير | وصف |
|---|---|
$assignee.id | يتم استبداله بمعرف المستخدم الخاص بالمحال إليه لجهة الاتصال. |
$assignee.name | يتم استبداله بالاسم الكامل للمحال إليه لجهة الاتصال (الاسم الأول + اسم العائلة). |
$assignee.email | يتم استبداله بالبريد الإلكتروني للمحال إليه لجهة الاتصال. |
$assignee.firstname | يتم استبداله بالاسم الأول للمحال إليه لجهة الاتصال. |
$assignee.lastname | يتم استبداله باسم العائلة للمحال إليه لجهة الاتصال. |
$assignee.team | يتم استبداله باسم فريق المحال إليه. |
متغيرات المشغّل في سير العمل
المتغيرات المشغِّلة هي متغيرات مرتبطة بمشغل سير العمل. لا تكون متاحة إلا عند استخدام المشغل المحدد لسير العمل.
متغيرات المشغل عند فتح المحادثة
المتغير | وصف |
|---|---|
$conversation.opened_timestamp | التاريخ والوقت الذي تم فيه فتح المحادثة. |
$conversation.opened_by_source | المصدر (مثل: جهة الاتصال، المستخدم، سير العمل، Zapier، API، Make) الذي يشغل المحادثة. |
$conversation.opened_by_channel | معرف القناة الذي يفتح المحادثة. |
$conversation.contact_type | نوع جهة الاتصال في المحادثة (جهة اتصال جديدة أو جهة اتصال عائدة). |
$conversation.first_incoming_message | أول رسالة واردة في المحادثة بعد فتح المحادثة. |
$conversation.first_incoming_message_channel_id | معرف القناة لأول رسالة واردة في المحادثة بعد فتح المحادثة |
متغيرات المشغل عند إغلاق المحادثة
المتغير | وصف |
|---|---|
$conversation.opened_timestamp | التاريخ والوقت الذي تم فيه فتح المحادثة. |
$conversation.opened_by_source | المصدر (مثل: جهة الاتصال، المستخدم، سير العمل، Zapier، API، Make) الذي أدى إلى فتح المحادثة. |
$conversation.opened_by_channel | معرف القناة الذي أدى إلى فتح المحادثة. |
$conversation.closed_time | التاريخ والوقت الذي تم فيه إغلاق المحادثة. |
$conversation.closed_by_source | المصدر (مثل: جهة الاتصال، المستخدم، سير العمل، Zapier، API، Make) الذي أدى إلى إغلاق المحادثة. |
$conversation.closed_by | معرف المستخدم للمستخدم الذي أغلق المحادثة. إذا تم إغلاق المحادثة بواسطة البوت أو سير العمل أو API، سيكون هذا الحقل فارغًا. |
$conversation.closed_by_team | معرف فريق المستخدم الذي أغلق المحادثة. |
$conversation.contact_type | نوع جهة الاتصال في المحادثة (جهة اتصال جديدة أو جهة اتصال عائدة). |
$conversation.assignee_team | اسم الفريق للمستخدم الذي قام بتعيين المحادثة. |
$conversation.first_assignment_timestamp | التاريخ والوقت الذي تم فيه تعيين المحادثة لأول مرة. |
$conversation.first_assignee | معرف المستخدم للمحال إليه الأول. |
$conversation.first_response_time | الوقت المستغرق لإعطاء الرد الأول منذ لحظة فتح المحادثة. |
$conversation.first_response_by | معرف المستخدم للمستخدم الذي قدم الرد الأول. |
$conversation.last_assignment_timestamp | التاريخ والوقت الذي تم فيه تعيين المحادثة آخر مرة. |
$conversation.last_assignee | معرف المستخدم لآخر محال إليه. |
$conversation.time_to_first_assignment | الوقت المستغرق لتعيين المحادثة للمستخدم الأول. |
$conversation.first_assignment_to_first_response_time | الوقت المستغرق لإعطاء الاستجابة الأولى منذ وقت تعيين المحادثة لأول مرة. |
$conversation.last_assignment_to_response_time | الوقت المستغرق لإعطاء الاستجابة الأولى من قبل المحال إليه الأخير منذ وقت تعيين المحادثة آخر مرة. |
$conversation.resolution_time | الوقت المستغرق لحل المحادثة منذ لحظة فتح المحادثة. |
$conversation.first_assignment_to_close_time | الوقت المستغرق لحل المحادثة منذ وقت تعيين المحادثة لأول مرة. |
$conversation.last_assignment_to_close_time | الوقت المستغرق لحل المحادثة منذ وقت تعيين المحادثة آخر مرة. |
$conversation.average_response_time | متوسط الوقت المستغرق للرد على جهة الاتصال. |
$conversation.assignments_count | عدد المهام في المحادثة. |
$conversation.incoming_messages_count | عدد الرسائل الواردة التي تم تلقيها أثناء المحادثة. |
$conversation.outgoing_messages_count | عدد الرسائل الصادرة المرسلة أثناء المحادثة (باستثناء الرسائل الجماعية). |
$conversation.responses_count | عدد الردود المرسلة في المحادثة. |
$conversation.category | فئة المحادثة كما هي محددة في ملاحظات الإغلاق. |
$conversation.summary | موجز ملاحظات الإغلاق للمحادثة. |
متغيرات المشغل لإعلانات النقر للدردشة
اسم المتغير | وصف |
|---|---|
$clicktochat.ad_timestamp | الطابع الزمني عند استلام الرسالة الواردة. |
$clicktochat.ad_first_incoming_message | الرسالة الأولى في المحادثة الناتجة عن إعلان النقر للدردشة. |
$clicktochat.ad_channel_id | معرف القناة التي تم من خلالها تلقي الرسالة الإعلانية الواردة. |
$clicktochat.ad_channel_type | القناة التي تتم من خلالها المحادثة المتعلقة بالإعلان. |
$clicktochat.ad_contact_type | نوع جهة الاتصال المرتبط بالإعلان: جديد أم عائد |
$clicktochat.ad_id | رقم معرف إعلان CTC. |
$clicktochat.ad_name | اسم إعلان CTC. |
$clicktochat.ad_campaign_id | رقم معرف حملة إعلان CTC. |
$clicktochat.ad_campaign_name | اسم حملة CTC. |
$clicktochat.ad_adset_id | رقم معرف مجموعة إعلانات CTC. |
$clicktochat.ad_adset_name | اسم مجموعة إعلانات CTC. |
$clicktochat.ad_ad_url | عنوان URL لإعلان CTC. |
$clicktochat.ad_reference | المرجع المرتبط بإعلان CTC. |
$clicktochat.ad_status | حالة إعلان CTC. |
$clicktochat.ad_objective | هدف إعلان CTC. |
$clicktochat.ad_optimization_goal | هدف تحسين إعلان CTC. |
$clicktochat.ad_destination_type | نوع الوجهة المرتبطة بإعلان CTC. |
متغيرات المشغّل لإعلانات المراسلة على TikTok
المتغير | وصف |
|---|---|
$tiktokmessagingad.ad_timestamp | الوقت الذي تم فيه النقر على الإعلان |
$tiktokmessagingad.ad_first_incoming_message | الرسالة الأولى التي أرسلها جهة الاتصال |
$tiktokmessagingad.ad_channel_id | معرف قناة المراسلة |
$tiktokmessagingad.ad_channel_type | نوع القناة (مثل TikTok) |
$tiktokmessagingad.ad_contact_type | نوع جهة الاتصال (مثل: جديدة أو موجودة) |
$tiktokmessagingad.ad_id | معرف الإعلان |
$tiktokmessagingad.ad_name | اسم الإعلان |
$tiktokmessagingad.ad_campaign_id | معرف الحملة |
$tiktokmessagingad.ad_campaign_name | اسم الحملة |
$tiktokmessagingad.ad_adgroup_id | معرف مجموعة الإعلانات |
$tiktokmessagingad.ad_adgroup_name | اسم مجموعة الإعلانات |
$tiktokmessagingad.ad_advertiser_id | معرف المعلن |
$tiktokmessagingad.ad_operation_status | حالة تشغيل الإعلان |
$tiktokmessagingad.ad_secondary_status | الحالة الثانوية للإعلان |
في حالة مشاركة حقل جهة اتصال قياسي نفس الاسم مع حقل جهة اتصال مخصص، ستُعطى أولوية استرجاع البيانات لمتغير جهة الاتصال القياسي. لاسترجاع البيانات بشكل صحيح، تأكد من أن جميع أسماء المتغيرات فريدة من نوعها.