批量导入分机 - CSV 文件结构
您可以通过创建指定所有要导入选项的 CSV(逗号分隔值)文件来批量导入分机:
- 下载 3CX 电话系统 CSV 样本文件。
- 列的位置必须保持不变,逗号分隔文件在第一行中提供列的结构及其名称。随后的行包含示例条目,您需要修改这些条目才能创建用于部署的分机。
- 创建 CSV 后,登录 3CX 管理控制台并转至 “用户” > “导入” 。
- 浏览并选择您的分机 CSV 文件,然后单击“打开” 将您的分机导入 3CX。
下表描述了可用字段和要求:
字段名称 | 描述 | 值 |
Number | 分机号 | 可选 - 仅限数字值 |
FirstName | 名字 | 字母数字字符 |
LastName | 姓氏 | 字母数字字符 |
EmailAddress | 电子邮箱地址 | 字母数字字符 |
MobileNumber | 手机号码 | 数字值,也接受 + - ( ) 和空格。 |
OutboundCallerID | 呼出显示号码 | 字母数字字符 – 为分机配置外呼主叫 ID |
DID | 分配给该分机的 DID号码 列表,以冒号 (:) 分隔 | 示例: 36912:*123963321:*961235469 |
Role | 用户的访问角色 | "<role name=""ROLE"" />", 其中角色为以下之一 users managers receptionists group_admins group_owners system_admins system_owners |
Department | 主要部门 | 字母数字字符(必须是已存在的部门) |
ClickToCallAuth | 为客户使用 Talk URL 时要求提供的信息 | 0 – 姓名和电子邮件地址 1 – 姓名 2 – 电子邮件 3 – 无 |
WMApprove | 在参与者加入会议前是否需要批准 | 0 – 禁用 1 – 启用 |
WebMeetingFriendlyName | 您的 Talk 和 Meet URL 名称 | 唯一的字母数字字符串,不含空格。 如果为空,则禁用 3CX Talk。 |
MAC | 第一部已配置话机的 MAC 地址 | 十六进制字符串,不含空格或短横线。 |
Template | IP 话机用于配置的模板 | 模板文件名,例如:yealinkT4x.ph.xml |
Model | 话机型号名称 | 一部已配置电话的型号。取值来自电话模板中的 <model>,例如:Yealink T43U |
Router | 使用的路由设备 | 本地话机留空。 远程话机:父级路由器话机的 MAC 或 SBC ID。 路由话机:此字段包含其自身的 MAC。 |
Language | 话机使用的语言 | 话机语言名称取决于所使用的话机模板。 |
Ringtone | 话机使用的铃声 | 铃声名称取决于所使用的话机模板。 |
QRingtone | 队列呼叫使用的铃声 | 铃声名称取决于所使用的话机模板。 |
VMEnable | 为此分机启用语音邮箱 | 0 – 语音邮箱已禁用 1 – 语音邮箱已启用 |
VMLanguage | 语音邮箱语言 | 提示集 GUID 或提示集文件夹名称,例如:8210986B-9412-497f-AD77-3A554F4A9BDB |
VMPlayMsgDateTime | 朗读留言的日期/时间 | 0 – 不朗读 1 – 以 AM/PM 格式朗读 2 – 以 24 小时格式朗读 |
VMPIN | 用于访问语音邮箱的 PIN 码 | 数字值 |
VMEmailOptions | 电子邮件选项 | 0 – 收到语音留言时不发送电子邮件通知 1 – 仅发送电子邮件通知 2 – 发送带有语音留言附件的电子邮件通知 3 – 发送带有语音留言附件的电子邮件通知,并从您的邮箱中删除该留言 |
VMNoPin | 禁用语音邮箱 PIN 码认证 | 0 –禁用语音邮箱 PIN 码认证 1 –开启语音邮箱 PIN 码认证 |
VMPlayCallerID | 播放来电显示号码 | 0 – 不播放来电显示号码 1 – 不播放来电显示号码 |
RecordCalls | 录制所有通话 | 0 – 不录制所有通话 1 – 录制此分机的所有通话 |
RecordExternal | 限制仅录制外部通话 | 0 – 禁用仅录制外部通话模式 1 – 启用仅录制外部通话模式 |
RecordCanSee | 显示通话录音 | 0 – 不向用户显示通话录音 1 – 向用户显示通话录音 |
RecordCanDelete | 允许删除录音 | 0 – 不允许用户删除录音 1 – 允许用户删除录音 |
RecordStartStop | 允许用户开始和停止通话录音 | 0 – 不允许用户控制通话录音 1 – 允许用户控制通话录音 |
RecordNotify | 在进行通话录音时通知用户 | 0 – 录音时不生成电子邮件通知 1 – 接收一封包含录音链接的电子邮件通知 |
Disabled | 禁用分机 | 0 – 分机已启用 1 – 分机已禁用 |
HideFWrules | 隐藏呼叫转移规则 | 0 – 在 3CX APP应用中启用“转移规则”选项卡 1 – 在 3CX APP应用中禁用“转移规则”选项卡 |
DisableExternalCalls | 禁用外部呼叫 | 0 – 已启用外部呼叫 1 – 已禁用外部呼叫 |
HideInPhonebook | 不在 3CX 公司电话簿中显示此分机 | 0 – 在 3CX 公司电话簿中显示分机 1 – 不在 3CX 公司电话簿中显示分机 |
CallScreening | 通话筛选 IVR | 0 – 禁用通话筛选 1 – 启用通话筛选 |
PinProtected | 外呼 PIN 码保护 | 0 - PIN 保护已禁用 1 - PIN 保护已启用 用户必须拨打 777 IVR 并输入其语音邮箱 PIN 码才能拨打外部电话。 |
PinTimeout | PIN 保护超时时间 | 用户输入 PIN 码后允许开始外呼的秒数。 |
Transcription | 用户的转写设置 | 留空以使用部门设置 0 –无转写 1 – 仅语音留言 2 – 仅录音 3 – 语音留言和录音 |
AllowLanOnly | 阻止远程非隧道连接 | 阻止或取消阻止注册远程电话的不安全方法 0 – 不阻止连接(不安全!) 1 – 阻止连接(推荐默认值) |
SIPID | SIP ID | 字母数字字符 – 为分机配置 SIP ID。每个分机必须唯一。 |
DeliverAudio | PBX 传输音频 | 0 – PBX 不传输音频 1 – PBX 传输音频 |
HotDesk | 启用共享话机 | 0 - 共享话机已禁用 1 - 共享话机已启用 |
SRTPMode | 开启安全 RTP (SRTP) | 0 – 已禁用 1 – SRTP 已启用 2 – 强制使用 SRTP |
EmailMissedCalls | 在有未接来电时发送电子邮件通知 | 0 – 不发送未接来电电子邮件通知 1 – 发送未接来电电子邮件通知 |
MS365SignInDisabled | 禁用 Microsoft SSO(单点登录) | 留空以启用 M365 SSO 1 - 禁用 M365 SSO |
MS365CalendarDisabled | 禁用同步日历和 Teams 状态 | 留空以启用同步 1 - 禁用同步 |
MS365ContactsDisabled | 禁用从 M365 同步个人联系人 | 留空以启用同步 1 - 禁用同步 |
MS365TeamsDisabled | 禁用 MS Teams 集成 | 留空以启用集成 1 - 禁用集成 |
GoogleSignInDisabled | 禁用 Google SSO(单点登录) | 留空以启用 Google SSO 1 - 禁用 Google SSO |
GoogleContactsDisabled | 禁用从 Google 同步个人联系人 | 留空以启用同步 1 - 禁用同步 |
GoogleCalendarDisabled | 禁用从 Google 同步日历 | 留空以启用同步 1 - 禁用同步 |
BLF | 定义电话和 APP 应用程序的 BLF(忙灯指示)映射 | XML string: If no BLFs are defined: <PhoneDevice><BLFS/></PhoneDevice> If BLFs are defined: <PhoneDevice><BLFS> <BLF ID=""id"" BLFNo=""no"" BLFType=""type"" BLFTypeID=""typeid"">text </BLF> … </BLFS></PhoneDevice> Values: BLF ID=""id"" id: For QueueLogin type keys
For all other types of keys
BLFNo=""no"" no: (Integer) Key position. Gaps are allowed. BLFType=""type"" type: (Text)
BLFTypeID=""typeid"" typeid: (Integer)
text:
|
⚠ 重要: 如果使用 Microsoft Office 打开 CSV 文件,请注意
MAC 地址列不显示为数字。要修复此问题,请右键单击 MAC 地址列,选择“设置单元格格式...”并选择文本。
或者,您可以创建至少一个分机,然后将分机导出到包含所需列的 CSV 文件。然后,您可以使用您的用户填充此 .csv 文件,并使用上述方法将其导入 3CX。
📄 注意事项:
- 跳过已有的 3CX 分机。
- 如果话机型号与模板中包含的型号名称完全一致,则会生成配置信息;否则,不会添加该设备。
最后更新
本文档最后更新于 2025 年 7 月 17 日


