动态变量可用于个性化外发消息。 在对话中以姓名等方式亲自称呼联系人，可能是建立关系的关键，让他们感到被重视并被接纳。
平台上有三种动态变量：
标准联系人变量 表示标准联系人字段，如名字、姓氏和电子邮件。
自定义联系人字段变量 代表添加到工作区的自定义字段。
工作流变量 是仅在工作流会话中存在的临时变量。 联系人退出工作流后，变量的值将被清除。
工作流变量有三种类型：触发变量、输出变量和通过提问步骤创建的变量。
动态变量示例
在联系人字段前添加“$”前缀即可使用动态变量。 以下是其语法：
$contact, $assignee 或 $system
平台支持静态文本与动态变量的插值。
标准联系人变量
变量 | 描述 |
|---|---|
$contact.name | 会被替换为联系人的全名（名字 + 姓氏）。 |
$contact.firstname | 将被替换为联系人的名字。 |
$contact.lastname | 将被替换为联系人的姓氏。 |
$contact.email | 将被替换为联系人的电子邮件。 |
$contact.country | 将被替换为联系人的国家。 如果联系人未存储国家信息，则不会被替换，原始字符串将被发送。 |
$contact.id | 将被替换为联系人的 ID。 |
自定义联系人字段变量
变量 | 描述 |
|---|---|
$contact.field_name | 将被替换为自定义字段中的值。 例如，如果自定义字段 "City" 存在，并且一个联系人的值为 "New York"，则发送 $contact.city 将被替换为 New York。 |
系统变量
变量 | 描述 |
|---|---|
$system.current_datetime | 将被替换为工作区时区的当前日期和时间。 |
$system.current_date | 将被替换为工作区时区的当前日期。 |
$system.current_time | 将被替换为工作区时区的当前时间。 |
受让人变量
变量 | 描述 |
|---|---|
$assignee.id | 将被替换为该联系人的受让人的用户 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 | 触发对话打开的频道 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.first_response_time | 从对话打开到给出第一个回应所花费的时间。 |
$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.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 | 接收该广告消息的频道 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 广告关联的目标类型。 |
TikTok 消息广告触发器的触发变量
变量 | 描述 |
|---|---|
$tiktokmessagingad.ad_timestamp | 广告被点击的时间 |
$tiktokmessagingad.ad_first_incoming_message | 联系人发送的第一条消息 |
$tiktokmessagingad.ad_channel_id | 消息通道 ID |
$tiktokmessagingad.ad_channel_type | 渠道类型（例如 TikTok） |
$tiktokmessagingad.ad_contact_type | 联系人类型（例如 新联系人或现有联系人） |
$tiktokmessagingad.ad_id | 广告 ID |
$tiktokmessagingad.ad_name | 广告名称 |
$tiktokmessagingad.ad_campaign_id | 广告系列 ID |
$tiktokmessagingad.ad_campaign_name | 广告系列名称 |
$tiktokmessagingad.ad_adgroup_id | 广告组 ID |
$tiktokmessagingad.ad_adgroup_name | 广告组名称 |
$tiktokmessagingad.ad_advertiser_id | 广告主 ID |
$tiktokmessagingad.ad_operation_status | 广告的运营状态 |
$tiktokmessagingad.ad_secondary_status | 广告的次要状态 |
如果标准联系人字段与自定义联系人字段同名，则数据检索将优先使用标准联系人变量。 为了正确的数据检索，请确保所有变量名称都是唯一的。
