نظرة عامة للمتغيرات الديناميكية

يمكن استخدام المتغيرات الديناميكية لتخصيص الرسائل الصادرة. يمكن أن يكون التعامل مع جهات الاتصال بطريقة شخصية في المحادثات عنصرًا رئيسيًا في بناء العلاقات، مما يجعلها تشعر بالرؤية والانتماء.

وهناك ثلاثة أنواع من المتغيرات الدينامية على المنصة:

متغيرات الاتصال القياسية تمثل حقول الاتصال القياسية مثل الاسم الأول واسم العائلة والبريد الإلكتروني.
متغيرات حقول الاتصال المخصصة تمثل حقول مخصصة تمت إضافتها إلى المساحة.
متغيرات سير العمل هي متغيرات مؤقتة موجودة فقط أثناء جلسة سير العمل. بمجرد خروج جهة الاتصال من سير العمل، سيتم مسح قيمة المتغير.

هناك ثلاثة أنواع من متغيرات تدفق العمل: المتغيرات المشغِّلة، متغيرات المخرجات، والمتغيرات التي تم إنشاؤها من خلال اسأل خطوة سؤال.

المتغيرات الديناميكية: أمثلة

يمكن إدراج المتغيرات الديناميكية عن طريق إضافة البادئة "$" إلى حقل جهة الاتصال. وفيما يلي بناء الجملة:

$contactأو $assignee أو $system

تدعم المنصة استخلاص النص الثابت + المتغيرات الديناميكية.

متغيرات جهة الاتصال القياسية

متغير ديناميكي.	الوصف
$contact.name	يتم استبداله بالاسم الكامل لجهة الاتصال (الاسم الأول + اسم العائلة).
$contact.الاسم الأول	يستعاض عنها بالاسم الأول لجهة الاتصال.
$contact.lastname	يستعاض عنها باسم العائلة لجهة الاتصال.
$contact.البريد الإلكتروني	يتم استبداله بالبريد الإلكتروني لجهة الاتصال.
$contact.البلد	يتم استبداله ببلد جهة الاتصال. إذا لم يكن لدى جهة الاتصال أي بلد مخزن، فلن يتم استبداله وسيتم إرسال السلسلة الفعلية.
$contact.id	يتم استبداله بمعرف جهة الاتصال.

متغيرات حقل جهة الاتصال المخصصة

متغير ديناميكي.	الوصف
$contact.field_name	يتم استبداله بالقيمة في الحقل المخصص. على سبيل المثال، إذا كان الحقل المخصص "مدينة" موجودًا وكانت لدى جهة الاتصال قيمة "نيويورك"، فإن إرسال $contact.city سيكون معادلًا لـ نيويورك.

متغيرات النظام

متغير ديناميكي.	الوصف
يتم استبداله بالتاريخ والوقت الحاليين في المنطقة الزمنية للعمل.	يتم استبداله بالتاريخ والوقت الحاليين في المنطقة الزمنية لمساحة العمل. Format: YYYY-MM-DD hh:mm:ss (e.g. 2023-01-10 09:15:27)
$system.current_date	يتم استبداله بالتاريخ الحالي في المنطقة الزمنية لمساحة العمل. التنسيق: YYYY-MM-DD (مثال: 2023-01-10)
$system.current_time	يتم استبداله بالوقت الحالي في المنطقة الزمنية لمساحة العمل. Format: hh:mm:ss (e.g. 09:15:27)

متغيرات المحال إليه

متغير ديناميكي.	الوصف
$assignee.id	يتم استبداله بمعرف المستخدم الخاص بالمحال إليه لجهة الاتصال.
$assignee.name	يتم استبداله بالاسم الكامل للمحال إليه للاتصال (الاسم الأول + اسم العائلة).
$assignee.البريد الإلكتروني	يستعاض عنه بالبريد الإلكتروني للمحال إليه لجهة الاتصال.
$assignee.الاسم الأول	يستعاض عن هذا الاسم بالاسم الأول للمحال اليه للاتصال به.
$assignee.lastname	يستعاض عن اسم العائلة للمحال إليه للاتصال به.
$assigneeفريق	يتم استبداله باسم فريق المحال إليه.

سير العمل - متغيرات المشغل

المتغيرات المشغلة هي متغيرات مرتبطة بمشغل سير العمل. لا تكون متاحة إلا عند استخدام المشغل المحدد لسير العمل.

متغيرات المحادثة مفتوحة المشغل

متغير ديناميكي.	الوصف
$conversation.opened_timestamp	التاريخ والوقت الذي تم فيه فتح المحادثة. Format: YYYY-MM-DD hh:mm:ss (e.g. 2023-11-10 09:15:27)
$conversation.opened_by_source	المصدر (مثل الاتصال، المستخدم، سير العمل، زابيير، API، ماكي) الذي يشغل المحادثة.
معرف القناة التي تشعل المحادثة.	يتم فتح معرف القناة التي تشغل المحادثة.
$conversation.contact_نوع	نوع جهة الاتصال (جهة اتصال أو إعادة الاتصال) من المحادثة.
$conversation.first_incoming_message	أول رسالة واردة من المحادثة بعد فتح المحادثة.
$conversation.first_incoming_message_channel_id	معرف القناة لأول رسالة واردة من المحادثة بعد فتح المحادثة

متغيرات المشغل للمحادثة مغلقة المشغل

متغير ديناميكي.	الوصف
$conversation.opened_timestamp	التاريخ والوقت الذي تم فيه فتح المحادثة. Format: YYYY-MM-DD hh:mm:ss (e.g. 2023-11-10 09:15:27)
$conversation.opened_by_source	المصدر (مثل جهة الاتصال، المستخدم، سير العمل، زابيير، API، ماكي) الذي يفتح المحادثة.
$conversation.opened_by_channel	معرف القناة الذي يفتح المحادثة.
$conversation.closed_time	التاريخ والوقت الذي تم فيه إغلاق المحادثة. Format: YYYY-MM-DD hh:mm:ss (e.g. 2023-11-10 09:15:27)
$conversation.closed_by_source	المصدر (مثل جهة الاتصال، المستخدم، سير العمل، زابيير، API، ماكي) الذي يشغل المحادثة المغلقة.
$conversation.closed_by	معرف المستخدم للمستخدم الذي أغلق المحادثة. إذا تم إغلاق المحادثة بواسطة البوت أو سير العمل أو API ، سيكون هذا الحقل فارغاً.
$conversation.closed_by_team	معرف فريق المستخدم الذي أغلق المحادثة.
$conversation.contact_type	نوع جهة الاتصال (جهة اتصال أو إعادة الاتصال) من المحادثة.
$conversation.assignee_team	اسم الفريق للمستخدم الذي قام بتعيين المحادثة.
$conversation.first_assignment_timestamp	التاريخ والوقت الذي تم فيه تعيين المحادثة لأول مرة. Format: YYYY-MM-DD hh:mm:ss (e.g. 2023-11-10 09:15:27)
$conversation.first_assignee	معرف المستخدم للمحال إليه الأول.
$conversation.first_response_time	الوقت المستغرق لإعطاء الرد الأول منذ لحظة فتح المحادثة. لا تظهر أي قيمة إذا حدث أي مما يلي: - المحادثة مغلقة بدون أي استجابة. - إذا تم توفير الاستجابة الأولى بواسطة واجهة برمجة التطبيقات أو تم تعيين جهة الاتصال للمستخدم من قبل، ثم يتم فتح المحادثة بواسطة الوكيل. Format: YYYY-MM-DD hh:mm:ss (e.g. 2023-11-10 09:15:27)
$conversation.first_response_by	معرف المستخدم للمستخدم الذي أعطى الرد الأول.
$conversation.last_assignment_timestamp	التاريخ والوقت الذي تم فيه تعيين المحادثة آخر مرة. لا تظهر أي قيمة إذا حدث أي مما يلي: - المحادثة مغلقة بدون محال إليه. - لا يحدث أي تعيين في المحادثة، على سبيل المثال تم تعيين المحادثة للمستخدم قبل فتح المحادثة. Format: YYYY-MM-DD hh:mm:ss (e.g. 2023-11-10 09:15:27)
$conversation.last_assignee	معرف المستخدم لآخر محال إليه.
$conversation.time_to_first_assignment	الوقت المستغرق لتعيين المحادثة للمستخدم الأول. Format: hh:mm:ss (e.g. 00:19:08)
$conversation.first_assignment_to_first_response_time	الوقت المستغرق لإعطاء الاستجابة الأولى منذ وقت تعيين المحادثة لأول مرة. Format: hh:mm:ss (e.g. 00:19:08)
$conversation.last_assignment_to_response_time	الوقت المستغرق لإعطاء الاستجابة الأولى من قبل الشخص المخصص الأخير منذ وقت تعيين المحادثة آخر مرة. $conversation.resolution_time
الوقت المستغرق لحل المحادثة منذ وقت تعيين المحادثة آخر مرة.	الوقت المستغرق لحل المحادثة منذ لحظة فتح المحادثة. Format: hh:mm:ss (e.g. 00:19:08)
$conversation.first_assignment_to_close_time	الوقت المستغرق لحل المحادثة منذ وقت تعيين المحادثة لأول مرة. Format: hh:mm:ss (e.g. 00:19:08)
$conversation.last_assignment_to_close_time	الوقت المستغرق لحل المحادثة منذ وقت تعيين المحادثة آخر مرة. $conversation.average_response_time
متوسط الوقت الذي يستغرقه تقديم ردود على جهة الاتصال.	متوسط الوقت الذي يستغرقه تقديم ردود على جهة الاتصال. Format: hh:mm:ss (e.g. 00:19:08)
$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 للإعلان الصادر عن لجنة مكافحة الإرهاب.
$clicktochat.ad_reference	المرجع المرتبط بإعلان CTC.
$clicktochat.ad_status	وضع إعلان لجنة مكافحة الإرهاب.
$clicktochat.ad_objective	هدف إعلان لجنة مكافحة الإرهاب.
$clicktochat.ad_optimization_goal	الهدف الأمثل لإعلان لجنة مكافحة الإرهاب.
$clicktochat.ad_destination_type	نوع الوجهة المرتبطة بإعلان لجنة مكافحة الإرهاب.

في حالة وجود حقل اتصال قياسي يشارك نفس الاسم كحقل اتصال مخصص، وستعطى الأولوية لاسترجاع البيانات إلى متغير جهة الاتصال القياسي. لاسترجاع البيانات بشكل صحيح، تأكد من أن جميع الأسماء المتغيرة فريدة من نوعها.