在 3CX 中自动设置节假日时间表

介绍

本文档提供了在 3CX 内配置节假日提示和呼叫路由的全面指南。它详细介绍了管理节假日呼叫流程的两种主要方法：基于部门的集中式节假日时间表以及holiday.cs呼叫脚本。

  • 基于部门的节假日时间表 允许管理员在部门级别定义节假日及其关联的提示音。这些时间表随后可自动应用于各种端点，包括队列、IVR、响铃组和部门呼叫处理，简化了维护工作并确保整个系统内节假日消息的一致性。
  • holiday.cs呼叫脚本为更高级或特定的路由需求提供了高度可定制的呼叫流程逻辑。

基于部门的节假日时间表

此功能允许您在部门级别定义节假日及相关提示音，然后动态应用于多个端点。

配置步骤

  • 步骤 1：创建或选择一个部门：在定义节假日之前，请确保您在 3CX 中已配置好部门。如果没有，则需要创建一个。
  • 导航至 管理 > 部门。
  • 选择现有部门或点击+ 添加创建一个新部门。

  • 步骤 2：为部门定义节假日：有了部门后，您可以定义具体的节假日及其关联的提示音。
  • 前往管理 > 办公时间。
  • 选择相关的部门（例如，“意大利办事处”）。
  • 点击办公室假期选项卡。
  • 点击 + 添加定义一个新的节假日。
  • 输入节假日的 名称（例如“圣诞节”）。
  • 指定节假日的 日期（例如“12月25日”）。
  • 上传或选择一个现有的 提示音消息，以便在此节假日期间播放（例如“圣诞节当天我们关闭。”）。该提示音将集中关联到此节假日。

  • 步骤 3：将部门节假日时间表分配给端点：最后，配置您希望使用的端点，使其利用部门的节假日时间表。
  • 编辑特定的端点（例如队列、响铃组、IVR 或部门自己的呼叫处理设置）。
  • 找到 “节假日时路由至” 选项。
  • 将此选项切换为 “结束通话” 或除默认的“仍然接受”之外的任何其他目的地。
  • 此操作会解锁更多的节假日提示选项。
  • 启用 “播放提示音” 开关。
  • 将出现一个新的下拉菜单，列出可用的提示语。
  • 选择 “播放部门节假日提示”。

现在，端点的节假日路由将动态解析活动部门节假日中的提示音，同时保持其正常目的地。

基于部门的节假日时间表工作原理

当端点（如队列、IVR、振铃组或部门的呼叫处理）配置为使用 “播放部门节假日提示” 选项时，它将自动检查活动部门已定义的节假日。如果某个节假日处于活动状态，系统将播放关联的节假日提示音并按照配置的节假日路由进行路由。这消除了在每个节假日前手动更新每个端点上的提示音或规则的需要。

使用 holiday.cs 呼叫脚本

holiday.cs呼叫脚本是一项现有功能，为基于部门的时间表可能无法覆盖的特定场景提供高级节假日路由能力。

holiday.cs脚本允许基于特定日期或条件的高度自定义呼叫流程逻辑。可以对其进行修改以实现独特的路由需求，例如在同一个节假日针对不同 DID 播放不同提示音，或实现复杂的条件路由。

配置步骤

  • 步骤 1：创建一个节假日
  • 导航至管理 > 办公时间。
  • 选择相关部门并点击办公室假期选项卡。
  • 添加一个具有唯一名称的新节假日（例如：国庆节）。
  • 步骤 2：准备节假日提示音
  • 录制或创建一个音频文件（.wav 格式）作为节假日提示音（例如：nationalday.wav）并上传
  • 步骤 3：在 3CX 中创建呼叫处理脚本
  • 登录您的账户管理员控制台前往集成 > 呼叫脚本。
  • 点击 从商店添加。
  • 选择 holiday.cs。

  • 为呼叫脚本输入一个名称（应仅包含小写字母，无空格）。
  • 通过 “运行此脚本” 选项选择启动该脚本的方式。例如，选择 “在 trunk 上收到呼叫时”。
  • 将脚本分配给所需的 SIP trunk。
  • 选择您选择的部门。
  • 点击 确定 继续。这将重定向到代码编辑器页面，该页面会自动编译脚本。

  • C# 代码的内容将加载到代码编辑器中。
  • 按 保存 以保存脚本并编译代码。

编译成功后，当在所分配 trunk 的任何 DID 上检测到入站呼叫时，脚本将被触发。

holiday.cs 呼叫脚本工作原理

  • 当呼叫到达所分配的 SIP trunk 时，脚本被触发。
  • 脚本检查当前日期是否与您定义的任何节假日匹配。
  • 如果匹配，脚本会播放您在步骤 2 中创建的节假日语音提示。
  • 如果当天是节假日，呼叫将被路由到节假日目的地。。

何时使用哪种方案

基于部门的节假日时间表

  • 推荐用于：大多数标准节假日路由场景，即部门内多个端点需要一致的节假日提示音和路由规则。
  • 好处：简单、集中管理、减少手动工作、动态应用节假日规则。
  • 使用场景：：您希望为一个部门定义一次节假日，然后所有关联的队列、IVR 和响铃组自动播放正确的节假日提示音并遵循节假日路由。

holiday.cs 呼叫脚本

  • 推荐用于：基于部门的时间表无法满足的高级或高度特定的节假日路由需求。这包括路由至用户的分机的自定义 DID 逻辑或特定的呼叫流程修改（例如，播放提示音后结束呼叫或排除特定的 DID）。
  • 优点：高灵活性、自定义逻辑、对呼叫流程的精细控制。
  • 使用场景：您需要基于特定 DID、复杂的时间条件实现独特路由，或与外部系统集成以获取节假日信息。此方法需要熟悉呼叫脚本编辑。

另请参阅

最后更新时间

本文件最后更新日期为2026年8月20日。

https://www.3cx.cn/docs/holiday-prompts/