يمكن استخدام المتغيرات الديناميكية لتخصيص الرسائل الصادرة. يمكن أن يكون مخاطبة جهات الاتصال شخصيًا في المحادثات عنصرًا رئيسيًا في بناء العلاقات، حيث تجعلهم يشعرون بأنهم مرئيون ومُشمولون.
هناك ثلاثة أنواع من المتغيرات الديناميكية على المنصة:
متغيرات جهة الاتصال القياسية تمثل حقول جهة الاتصال القياسية مثل الاسم الأول واسم العائلة والبريد الإلكتروني.
متغيرات حقول جهة الاتصال المخصصة تمثل الحقول المخصصة التي تمت إضافتها إلى مساحة العمل.
متغيرات سير العمل هي متغيرات مؤقتة موجودة فقط أثناء جلسة سير العمل. بمجرد خروج جهة الاتصال من سير العمل، سيتم مسح قيمة المتغير.
هناك ثلاثة أنواع من متغيرات سير العمل: متغيرات المشغل، متغيرات المخرجات، والمتغيرات التي يتم إنشاؤها من خلال خطوة اسأل سؤال
أمثلة على المتغيرات الديناميكية
يمكن إدراج المتغيرات الديناميكية عن طريق إضافة البادئة "$" إلى مجال جهة الاتصال. وفيما يلي بناء الجملة:
$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 | الحالة الثانوية للإعلان |
متغيرات المشغّل لحدث انتهاء المكالمة
المتغير | الوصف | القيم الممكنة |
|---|---|---|
$call.event_id | المعرف الفريد لحدث المكالمة. | نص |
$call.id | المعرف الفريد للمكالمة. | نص |
$call.direction | اتجاه المكالمة. | واردة، صادرة |
$call.language | لغة المكالمة. | رمز اللغة كنص (مثال: eng) |
$call.status | حالة المكالمة. | فائتة، مكتملة |
$call.duration_seconds | مدة المكالمة بالثواني. | رقم |
$call.start_time | الطابع الزمني عند بدء المكالمة. | تاريخ ووقت |
$call.end_time | الطابع الزمني عند انتهاء المكالمة. | تاريخ ووقت |
$call.contact_id | المعرف الفريد لجهة الاتصال المرتبطة بالمكالمة. | نص |
$call.contact_first_name | الاسم الأول لجهة الاتصال المرتبطة بالمكالمة. | نص |
$call.contact_last_name | اسم العائلة لجهة الاتصال المرتبطة بالمكالمة. | نص |
$call.contact_phone | رقم هاتف جهة الاتصال المرتبطة بالمكالمة. | نص |
$call.user_id | المعرف الفريد للوكيل الذي تعامل مع المكالمة. | نص |
$call.user_first_name | الاسم الأول للوكيل الذي تعامل مع المكالمة. | نص |
$call.user_last_name | اسم العائلة للوكيل الذي تعامل مع المكالمة. | نص |
$call.user_email | البريد الإلكتروني للوكيل الذي تعامل مع المكالمة. | نص |
$call.channel_id | المعرف الفريد للقناة التي حدثت عليها المكالمة. | نص |
$call.recording_url | رابط تسجيل المكالمة، إذا تم تفعيل تسجيل المكالمات. | URL |
$call.summary_title | عنوان الملخص المُولَّد بواسطة الذكاء الاصطناعي. | نص |
$call.summary_summary | نص ملخص المكالمة المولَّد بواسطة الذكاء الاصطناعي. | نص |
$call.summary_action_items | بنود العمل المستخرجة من الملخص الذي أنشأه الذكاء الاصطناعي. | نص |
ملاحظة: نص المكالمة غير متاح كمتغير مشغل. فقط المتغيرات المدرجة أعلاه مدعومة.
