動態變數可用於個人化發送的訊息。 在對話中親自稱呼聯絡人可以成為建立關係的關鍵要素，因為這可以讓聯絡人感到被重視和包容。
平台上有三種類型的動態變數：
標準聯絡人變數 代表標準聯絡人字段，例如名字、姓氏和電子郵件。
自訂聯絡人欄位變數 代表新增至空間的自訂欄位。
工作流程變數 是僅在工作流程會話期間存在的暫時變數。 一旦聯絡人退出工作流程，變數的值將被刪除。
工作流程變數有三種類型：觸發變數、輸出變數和透過提問步驟建立的變數。
可以透過在聯絡人欄位中加入 "$" 前綴來包含動態變數。 其語法如下：
$contact、$assignee 或 $system
平台支援靜態文字+動態變數的內插。
變量 | 描述 |
|---|---|
$contact.名稱 | 由聯絡人的全名（名字 + 姓氏）替換。 |
$contact.firstname | 由聯絡人的名字替換。 |
$contact.lastname | 由聯絡人的姓氏替換。 |
$contact.電子郵件 | 由聯絡人的電子郵件替換。 |
$contact.country | 被聯絡人'的國家所取代。 如果聯絡人沒有儲存國家/地區，則不會替換並且會傳送實際字串。 |
$contact.id | 由聯絡人的聯絡人 ID 取代。 |
變量 | 描述 |
|---|---|
$contact.field_name | 由自訂欄位中的值取代。 例如，如果自訂欄位 "城市" 存在，且一個聯絡人的值為 "紐約"，則發送 $contact.city 將被替換為紐約。 |
變量 | 描述 |
|---|---|
$system.current_datetime | 由工作區時區的目前日期和時間取代。 |
$system.current_date | 由工作區時區的目前日期取代。 |
$system.當前時間 | 由工作區時區的目前時間取代。 |
變量 | 描述 |
|---|---|
$assignee.id | 由聯絡人的受讓人的使用者 ID 取代。 |
$assignee.名稱 | 由聯絡人的受讓人的全名（名字 + 姓氏）替換。 |
$assignee.電子郵件 | 由聯絡人的受讓人的電子郵件替換。 |
$assignee.firstname | 由聯絡人的受讓人的名字替換。 |
$assignee.lastname | 由聯絡人的受讓人的姓氏替換。 |
$assignee.團隊 | 由受讓人團隊的名稱替換。 |
觸發變數是與工作流程觸發器相關的變數。 僅當工作流程使用特定觸發器時它們才可用。
對話開啟觸發器的觸發變數
變量 | 描述 |
|---|---|
$conversation.opened_timestamp | 對話開始的日期和時間。 |
$conversation.opened_by_source | 觸發對話的來源（例如聯絡人、使用者、工作流程、Zapier、API、Make）。 |
$conversation.opened_by_channel | 觸發開啟對話的頻道ID。 |
$conversation.contact_type | 對話的聯絡人類型（新聯絡人或回訪聯絡人）。 |
$conversation.first_incoming_message | 對話開啟後，該對話的第一個傳入訊息。 |
$conversation.first_incoming_message_channel_id | 對話開啟後，該對話第一條傳入訊息的頻道ID |
對話結束觸發器的觸發變數
變量 | 描述 |
|---|---|
$conversation.opened_timestamp | 對話開始的日期和時間。 |
$conversation.opened_by_source | 觸發開啟對話的來源（例如聯絡人、使用者、工作流程、Zapier、API、Make）。 |
$conversation.opened_by_channel | 觸發開啟對話的頻道ID。 |
$conversation.closed_time | 對話結束的日期和時間。 |
$conversation.closed_by_source | 觸發對話關閉的來源（例如聯絡人、使用者、工作流程、Zapier、API、Make）。 |
$conversation.closed_by | 關閉對話的用戶的用戶 ID。 如果對話被機器人、工作流程或 API 關閉，則該欄位將為空。 |
$conversation.closed_by_team | 關閉對話的使用者的團隊 ID。 |
$conversation.contact_type | 對話的聯絡人類型（新聯絡人或回訪聯絡人）。 |
$conversation.assignee_team | 分配對話的使用者的團隊名稱。 |
$conversation.first_assignment_timestamp | 首次分配對話的日期和時間。 |
$conversation.first_assignee | 第一位受讓人的使用者 ID。 |
$conversation.首次回應時間 | 從對話開始到給予第一個回應所花費的時間。 |
$conversation.first_response_by | 第一個回應的用戶的用戶 ID。 |
$conversation.last_assignment_timestamp | 上次分配對話的日期和時間。 |
$conversation.last_assignee | 最後一位受讓人的使用者 ID。 |
$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.平均反應時間 | 回覆聯繫的平均時間。 |
$conversation.assignments_count | 對話中的作業數量。 |
$conversation.incoming_messages_count | 對話期間收到的來電訊息數。 |
$conversation.outgoing_messages_count | 對話期間發送的傳出訊息數（不包括廣播訊息）。 |
$conversation.responses_count | 對話中發送的回覆數。 |
$conversation.category | 結束語中指定的對話類別。 |
$conversation.摘要 | 談話的結束語總結。 |
點擊聊天廣告觸發器的觸發變數
變量的名稱 | 描述 |
|---|---|
$clicktochat.ad_timestamp | 收到傳入訊息的時間戳記。 |
$clicktochat.ad_first_incoming_message | 點擊聊天廣告產生的對話中的第一則訊息。 |
$clicktochat.ad_channel_id | 接收傳入廣告訊息的管道的 ID。 |
$clicktochat.ad_channel_type | 發生廣告相關對話的管道。 |
$clicktochat.ad_contact_type | 與廣告相關的聯絡人類型：新聯絡人或回訪聯絡人 |
$clicktochat.ad_id | CTC 廣告 ID 號碼。 |
$clicktochat.ad_name | CTC 廣告名稱。 |
$clicktochat.ad_campaign_id | CTC 廣告活動 ID 號碼。 |
$clicktochat.ad_campaign_name | CTC 活動名稱。 |
$clicktochat.ad_adset_id | CTC 廣告廣告群組 ID 號碼。 |
$clicktochat.ad_adset_name | CTC 廣告廣告組名稱。 |
$clicktochat.ad_ad_url | CTC 廣告的 URL。 |
$clicktochat.ad_reference | 與 CTC 廣告相關的參考。 |
$clicktochat.ad_status | CTC 廣告的狀態。 |
$clicktochat.ad_objective | CTC 廣告的目標。 |
$clicktochat.ad_optimization_goal | CTC廣告的優化目標。 |
$clicktochat.ad_destination_type | 與 CTC 廣告相關的目的地類型。 |
如果標準聯絡人欄位與自訂聯絡人欄位同名，則資料擷取優先考慮標準聯絡人變數。 為了正確檢索數據，請確保所有變數名稱都是唯一的。
