1. All Collections >
  2. المنتج >
  3. المتغيرات الديناميكية >
  4. نظرة عامة على المتغيرات الديناميكية

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

Avatar
Susan Swier
less than a minute read

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

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

  1. متغيرات جهة الاتصال القياسية تمثل حقول جهة الاتصال القياسية مثل الاسم الأول واسم العائلة والبريد الإلكتروني.

  2. متغيرات حقول جهة الاتصال المخصصة تمثل الحقول المخصصة التي تمت إضافتها إلى مساحة العمل.

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

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

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

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

$contact, $assignee أو $system

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

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

المتغير

وصف

$contact.name

يتم استبداله بالاسم الكامل لجهة الاتصال (الاسم الأول + اسم العائلة).

$contact.firstname

يتم استبداله بالاسم الأول لجهة الاتصال.

$contact.lastname

يتم استبداله باسم العائلة لجهة الاتصال.

$contact.email

يتم استبداله بالبريد الإلكتروني لجهة الاتصال.

$contact.country

يتم استبداله ببلد جهة الاتصال. إذا لم يكن لدى جهة الاتصال أي بلد مخزن، فلن يتم استبداله وسيتم إرسال السلسلة الفعلية.

$contact.id

يتم استبداله بمعرف جهة الاتصال.

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

المتغير

وصف

$contact.field_name

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

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

المتغير

وصف

$system.current_datetime

يتم استبداله بالتاريخ والوقت الحاليين في المنطقة الزمنية لمساحة العمل.

التنسيق: YYYY-MM-DD hh:mm:ss (مثال: 2023-01-10 09:15:27)

$system.current_date

يتم استبداله بالتاريخ الحالي في المنطقة الزمنية لمساحة العمل.

التنسيق: YYYY-MM-DD (مثال: 2023-01-10)

$system.current_time

يتم استبداله بالوقت الحالي في المنطقة الزمنية لمساحة العمل.

التنسيق: hh:mm:ss (مثال: 09:15:27)

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

المتغير

وصف

$assignee.id

يتم استبداله بمعرف المستخدم الخاص بالمحال إليه لجهة الاتصال.

$assignee.name

يتم استبداله بالاسم الكامل للمحال إليه لجهة الاتصال (الاسم الأول + اسم العائلة).

$assignee.email

يتم استبداله بالبريد الإلكتروني للمحال إليه لجهة الاتصال.

$assignee.firstname

يتم استبداله بالاسم الأول للمحال إليه لجهة الاتصال.

$assignee.lastname

يتم استبداله باسم العائلة للمحال إليه لجهة الاتصال.

$assignee.team

يتم استبداله باسم فريق المحال إليه.

متغيرات المشغّل في سير العمل

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

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

المتغير

وصف

$conversation.opened_timestamp

التاريخ والوقت الذي تم فيه فتح المحادثة.

التنسيق: YYYY-MM-DD hh:mm:ss (مثال: 2023-11-10 09:15:27)

$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

التاريخ والوقت الذي تم فيه فتح المحادثة.

التنسيق: YYYY-MM-DD hh:mm:ss (مثال: 2023-11-10 09:15:27)

$conversation.opened_by_source

المصدر (مثل: جهة الاتصال، المستخدم، سير العمل، Zapier، API، Make) الذي أدى إلى فتح المحادثة.

$conversation.opened_by_channel

معرف القناة الذي أدى إلى فتح المحادثة.

$conversation.closed_time

التاريخ والوقت الذي تم فيه إغلاق المحادثة.

التنسيق: YYYY-MM-DD hh:mm:ss (مثال: 2023-11-10 09:15:27)

$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

التاريخ والوقت الذي تم فيه تعيين المحادثة لأول مرة.

التنسيق: YYYY-MM-DD hh:mm:ss (مثال: 2023-11-10 09:15:27)

$conversation.first_assignee

معرف المستخدم للمحال إليه الأول.

$conversation.first_response_time

الوقت المستغرق لإعطاء الرد الأول منذ لحظة فتح المحادثة.

لا تظهر أي قيمة إذا حدث أي مما يلي:
- تم إغلاق المحادثة دون أي رد.
- إذا تم تقديم الاستجابة الأولى بواسطة API أو تم تعيين جهة الاتصال للمستخدم مسبقًا، ثم تم فتح المحادثة من قبل الوكيل.

التنسيق: YYYY-MM-DD hh:mm:ss (مثال: 2023-11-10 09:15:27)

$conversation.first_response_by

معرف المستخدم للمستخدم الذي قدم الرد الأول.

$conversation.last_assignment_timestamp

التاريخ والوقت الذي تم فيه تعيين المحادثة آخر مرة.

لا تظهر أي قيمة إذا حدث أي مما يلي:
- تم إغلاق المحادثة بدون محال إليه.
- لا يحدث أي تعيين في المحادثة، على سبيل المثال تم تعيين المحادثة للمستخدم قبل فتح المحادثة.

التنسيق: YYYY-MM-DD hh:mm:ss (مثال: 2023-11-10 09:15:27)

$conversation.last_assignee

معرف المستخدم لآخر محال إليه.

$conversation.time_to_first_assignment

الوقت المستغرق لتعيين المحادثة للمستخدم الأول.

التنسيق: hh:mm:ss (مثال: 00:19:08)

$conversation.first_assignment_to_first_response_time

الوقت المستغرق لإعطاء الاستجابة الأولى منذ وقت تعيين المحادثة لأول مرة.

التنسيق: hh:mm:ss (مثال: 00:19:08)

$conversation.last_assignment_to_response_time

الوقت المستغرق لإعطاء الاستجابة الأولى من قبل المحال إليه الأخير منذ وقت تعيين المحادثة آخر مرة.

التنسيق: hh:mm:ss (مثال: 00:19:08)

$conversation.resolution_time

الوقت المستغرق لحل المحادثة منذ لحظة فتح المحادثة.

التنسيق: hh:mm:ss (مثال: 00:19:08)

$conversation.first_assignment_to_close_time

الوقت المستغرق لحل المحادثة منذ وقت تعيين المحادثة لأول مرة.

التنسيق: hh:mm:ss (مثال: 00:19:08)

$conversation.last_assignment_to_close_time

الوقت المستغرق لحل المحادثة منذ وقت تعيين المحادثة آخر مرة.

التنسيق: hh:mm:ss (مثال: 00:19:08)

$conversation.average_response_time

متوسط الوقت المستغرق للرد على جهة الاتصال.

التنسيق: hh:mm:ss (مثال: 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 لإعلان 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

الحالة الثانوية للإعلان

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

مشاركة هذه المقالة
Telegram
Facebook
Linkedin
Twitter

لا يمكن العثور على ما تبحث عنه؟ 🔎