Zendesk 实时在线交谈触发器条件和操作参考

What's my plan?

Support with

Live chat and messaging, any plan

Zendesk 实时在线交谈触发器使您可以添加关于客户的信息、改进工作流程路由，以及处理垃圾信息请求。

如需了解更多关于实时在线交谈触发器的信息，请参阅 Zendesk 在线交谈触发器资源。 

有关消息传送触发器的信息，请参阅 消息传送触发器条件和操作参考。

本文章包含以下表格：

• 为实时在线交谈触发器选择运行事件
• 创建实时在线交谈触发器条件语句
  • 触发器运算符
• 创建实时在线交谈触发器操作语句
  • 在实时在线交谈触发器操作语句中使用占位符

为实时在线交谈触发器选择运行事件

当您创建触发器时，您必须选择一个 运行事件。这些事件可确定触发器是否运行、检查其条件并执行其已定义的操作。运行事件是在使用 运行触发器 下拉菜单创建触发器时选择的。

表 1.触发器运行事件

触发事件	描述
当访问者加载在线交谈小组件时	当在线交谈小组件显示在页面上但访问者尚未与之互动时运行触发器。 注意：选择此触发事件将覆盖交谈前的表格。要继续使用交谈前的表格，请使用其它触发事件。
当访问者请求在线交谈时	在访问者请求在线交谈时运行触发器。
当发送在线交谈消息时	当访问者在在线交谈小组件中发送文本时，运行触发器。

创建实时在线交谈触发器条件语句

条件语句由条件、字段运算符和条件值组成（这些取决于所选的条件）。条件语句本质上是返回满足指定条件的“true”值的“if”语句。当选择“检查所有以下条件”时，第一个评估结果为 false 的条件语句将终止触发器。选择“检查任意以下条件”时，只需有一个条件为 true 即可触发操作。

创建实时在线交谈触发器时，您不能使用 检查以下所有条件 和 检查以下任意条件组合 。只能选择一个，这在开发者视图中也是不可能的。

注意：Zendesk 对某些触发器条件引入了限制。超过这些限制的现有触发器将被禁用。当您重新启用它们时，您将收到一条错误消息。条件限制包含在下表中。

表格 2.触发器条件

条件	描述
时间/日期
一天中的时间	一天中的时间（通用时间）： 0= 午夜 23= 晚上 11 点 请注意，小时条件仅使用分钟， 不 包括分钟。
一周中的一日	一周中的某一天： 0= 星期一 6= 周日
仍在网站上	检查用户在所选方案 X 秒钟后是否仍在域名上的时间已过期。 最多 3600 秒
仍在页面上	一项条件检查，用于检查用户在所选方案 X 秒钟后是否仍在同一页面上。 最多 3600 秒
访问者位置
访问者 IP	访问者的 IP 地址
访问者主机名称	与访问者 IP 地址关联的主机名称（域名）
访问者城市	与访问者 IP 地址关联的城市名称
访问者地区	根据 GeoIP显示访问者来自的地区。  对于美国和加拿大，我们使用 ISO-3166-2 区域。这些是各个州（例如佛蒙特州）。 对于其他地方，我们使用 FIPS 10-4 标准。GeoIP 网站有一个 CSV 文件，其中列出了所有不同的区域： http://www.maxmind.com/下载/geoip/misc/region_codes.csv
访问者国家代码	访问者 IP 地址的两个字母的国家代码。代码区分大小写，并应为大写。
访问者国家名称	与访问者 IP 地址关联的国家名称
上一次访问信息
访问者以前访问次数	以前独立访问次数：0= 首次访问 最大值 210 万
访问者以前在线交谈次数	之前与专员发起的独立在线交谈数量：0= 首次 Chat
页面信息
访问者页面 URL	访问者的当前 URL（小组件必须安装在此页面上）
访问者页面标题	页面访问者的当前标题在 （此页面上必须安装小组件）
访问者页面计数	访问者查看的页数。第一页 =1
上一页	用户上一个访问页面的 URL。
访问者信息
访问者名称	访问者名称
访问者电邮	访问者电邮
访问者引用	根据内容标题确定的访问者引用 URL（如适用）
访问者搜索引擎	引用的搜索引擎（如适用）。请注意，这些值区分大小写，并应为小写： Google yahoo 必应 yandex
访问者搜索词	引用的搜索词（如适用）
访问者工单标签	工单标签（通过 设置工单标签 操作应用）
已触发访问者	已触发访问者（已由“设置已触发”操作激活）。从下拉菜单中选择以下任一选项： True False
访问者部门	访问者的部门，由操作 “设置访问者部门” 或 JavaScript API 进行设置。
访问者软件/计算机
访问者用户代理	访问者的用户代理字符串
访问者浏览器	访问者使用的浏览器
访问者平台	访问者使用的平台
在线状态
帐户状态	您Zendesk Chat帐户的状态，以层次结构系统工作。 在线 离开 离线 如果一名专员在线（其余专员离开或离线），则帐户状态为在线，并触发 在线 触发器。 如果一名专员离开（其余均离线），则帐户状态为离开， 离开触发器将触发 如果所有专员均已离线，则帐户状态为离线，并将触发 离线 触发器。
部门状态	已选择的 Zendesk 部门的状态。 在线 离开 离线
访问者状态	访问者状态： 在线 空闲 （在线交谈窗口中有 10 分钟没有移动鼠标或键盘）
在线交谈相关信息
访问者正处于在线交谈中	如果访问者当前正处于活跃的在线交谈会话中，则为“true”。
访问者请求在线交谈	如果访问者通过在其在线交谈消息中点击 发送 来请求在线交谈，则为“true”。 如果访问者未请求在线交谈，则为“false”。
已为访问者提供服务	如果当前专员正在为访问者提供服务（例如，专员已选择为客户提供服务，并在在线交谈中发送了第一条消息），则为“true”。 如果专员尚未向访问者发送回复，则为“false”。
发送人	在线交谈消息的发送者名称
发送人类型	发件人类型。请注意，这些值区分大小写，并应为小写： 访问者 专员
消息	发送的消息
部门	访问者从交谈前的表格中选择的部门（名称）
访问者队列
队列大小（帐户）	帐户新到的在线交谈请求总数。请注意，此条件以客户队列总数为目标，而不衡量部门队列。

触发器条件语句的运算符

使用以下运算符可构建触发器条件语句。

表 3.触发器运算符

运算符	描述
等于	精确匹配 = 5 returns true only when 5
小于	小于输入的数字，但不包括 < 10 returns true from 0-9
大于	大于输入的数字 > 120 returns true from 121 to 1,000,000,000,000,000,000
小于或等于	精确匹配或小于输入的数字 <= 3 returns true on a 3, 2, 1, or 0
大于或等于	精确匹配或大于输入数字的匹配项 >= 600 returns true from 600 to 1,000,000,000,000,000
不等于	除输入值外的任何内容 != 0 returns true for any number but 0
包含	字符串包含以下文本 "help" matches true with "help, i need somebody"
不包含	字符串不包含以下文本 "help" matches true with "not just anybody"
正则表达式	使用 Python RegEx 框架匹配正则表达式值。此字段查找 完全 匹配项，而不是部分匹配项。如需帮助，您可以使用 Pythex 作为快速参考和验证工具。 (?P<year>(?:19|20)\d\d)(?P<delimiter>[- /.])(?P<month>0[1-9]|1[012])\2(?P<day>0[1-9]|[12][0-9]|3[01]) Test String: 2014-07-28 String match: 2014-07-28

创建实时在线交谈触发器操作语句

操作语句定义了如果所有条件语句都为 true 并且触发器触发时会发生什么情况。您可以将操作语句视为“那么”语句：如果所有条件都为 true，则执行这些操作以更新用户，并可选择发送通知。

表 4.触发器操作

操作	描述
给访问者发送消息	向访问者发送给定消息 注意：如果帐户离线，此操作将不起作用。
设置已触发	设置已触发可以是两个值之一，并应用一个可与“访问者已触发？”结合使用的标记。条件。从下拉菜单中选择以下选项中的一个： True False 注意：如果帐户离线，此操作将不起作用。
等待	触发下一个操作之前的延迟（秒数） 注意：如果您有多个必须以特定顺序执行的触发器，则需要在每个触发器之间添加至少一秒钟的等待时间。之所以必要，是因为触发器不以特定顺序运行，而是同时评估和执行。
添加工单标签	为工单添加工单标签
移除工单标签	从工单中移除标签
设置访问者名称	设置访问者的名称
设置访问者部门	将部门添加到访问者个人资料。选择此操作后，会出现一个下拉菜单，使您可以选择一个可用的部门。仅当运行触发器设置为当访问者加载在线交谈小组件时有效。
替换注释	替换访问者个人资料的注释
附加注释	添加 到访问者个人资料的注释
阻止访问者	禁止访问者访问您的在线交谈服务。有关阻止访问者的更多信息，请参阅 禁止访问者访问 Chat。
请求电邮（持续的对话）	向请求电邮的访问者发送自动消息，以便持续重新参与对话。有关更多信息，请参阅 允许客户通过电邮继续对话 。

注意：对于触发器操作 发送消息给访问者、 替换注释、 设置访问者名称和 附加注释，要使用 @ 符号，您必须多加一个 @ 符号。例如，[e-mail] 应输入为 user@@domain.com。

在实时在线交谈触发器操作语句中使用占位符

占位符是对可在触发器操作语句中使用的访问者详情的引用。触发触发器后，占位符会提取当前访问者和会话信息。

表 5：触发器占位符

占位符	类型	描述
@hour_of_day	整数	当天的当前时间（UTC 时区）。0 - 23
@day_of_week	整数	当前周几（0 = 周一，6 = 周日）
@visitor_ip	字符串	访问者来自的城市（基于 IP 地址）
@visitor_hostname	字符串	访问者 IP 地址的主机名称
@visitor_city	字符串	访问者的城市
@visitor_region	字符串	访问者来自的地区（根据 IP 地址）
@visitor_country_code	字符串	访问者来自的两个字母的国家代码（基于 IP 地址）。代码区分大小写，并应为大写。
@visitor_country_name	字符串	访问者来自的国家（基于 IP 地址）
@visitor_page_url	字符串	访问者当前访问页面的 URL
@visitor_page_title	字符串	访问者当前访问页面的标题
@visitor_引用	字符串	访问者的推荐 URL
@visitor_search_engine	字符串	访问者用于查找您网站的搜索引擎（可以为空白）
@visitor_search_terms	字符串	访问者用于查找您网站的搜索词（可以为空白）
@visitor_user_agent	字符串	访问者浏览器的用户代理字符串
@visitor_browser	字符串	访问者的浏览器
@visitor_platform	字符串	添加 到访问者个人资料的注释
@account_status	字符串	您的帐户状态（在线、 离开或 离线）
@visitor_以前的_访问	字符串	以前独立访问次数
@visitor_prefore_chats	字符串	之前与专员发起的独立在线交谈数量
@visitor_name	字符串	访问者名称
@visitor_status	字符串	访问者状态（在线、 空闲、 或 离线）
@visitor_time_on_page	字符串	访问者在当前页面上花费的时间
@visitor_time_on_site	字符串	访问者当前登录期间在网站上停留的时间
@visitor_page_count	字符串	访问者查看的页数
@visitor_requesting_chat	字符串	如果访问者已请求在线交谈，则为 True
@visitor_served	字符串	如果专员当前正在为访问者提供服务，则为 True
@visitor_tags	字符串	已应用到访问者的工单标签
@visitor_triggered	字符串	已触发的访问者（true 或 false）
@推荐人	字符串	访问者当前会话发起的 URL

翻译免责声明：本文章使用自动翻译软件翻译，以便您了解基本内容。 我们已采取合理措施提供准确翻译，但不保证翻译准确性

如对翻译准确性有任何疑问，请以文章的英语版本为准。