批量导入分机 - CSV 文件结构

您可以通过创建指定所有要导入选项的 CSV(逗号分隔值)文件来批量导入分机:

  1. 下载 3CX 电话系统 CSV 样本文件
  2. 列的位置必须保持不变,逗号分隔文件在第一行中提供列的结构及其名称。随后的行包含示例条目,您需要修改这些条目才能创建用于部署的分机。
  3. 创建 CSV 后,登录 3CX 管理控制台并转至 用户 > 导入
  4. 浏览并选择您的分机 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

  • LOGGEDINQUEUE
  • LOGGEDOUTQUEUE

For all other types of keys

  • -1

BLFNo=""no""

no: (Integer)

Key position. Gaps are allowed.

BLFType=""type""

type: (Text)

  • “BLF” for typeid:0 keys
  • “SpeedDial” for typeid:1 keys
  • “CustomSpeedDial” for typeid:2 keys
  • “SharedParking” for typeid:3 keys
  • “QueueLogin”  for typeid:4 keys
  • “ProfileStatus”  for typeid:5 keys
  • “Line” for typeid:6 keys

BLFTypeID=""typeid""

typeid: (Integer)

  • 0 for BLF
  • 1 for SpeedDial
  • 2 for CustomSpeedDial
  • 3 for SharedParking
  • 4 for QueueLogin
  • 5 for ProfileStatus
  • 6 for Line

text:

  • text is empty for Line, and for QueueLogin “DEFINED BY ID”
  • text for ProfileStatus is an integer
  • 0 for Available
  • 1 for Away
  • 2 for Do Not Disturb
  • 3 for Lunch
  • 4 for Business Trip
  • text for CustomSpeedDial is 3 lines
  • Number to dial
  • First name
  • Last name
  • text for SharedParking is SPX (where X = SP0, SP1 … SP999)
  • text for SpeedDial and BLF is the target internal extension number

⚠ 重要:  如果使用 Microsoft Office 打开 CSV 文件,请注意

MAC_0

MAC 地址列不显示为数字。要修复此问题,请右键单击 MAC 地址列,选择设置单元格格式...并选择文本。

或者,您可以创建至少一个分机,然后将分机导出到包含所需列的 CSV 文件。然后,您可以使用您的用户填充此 .csv 文件,并使用上述方法将其导入 3CX。

📄 注意事项:

  • 跳过已有的 3CX 分机。
  • 如果话机型号与模板中包含的型号名称完全一致,则会生成配置信息;否则,不会添加该设备。

最后更新

本文档最后更新于 2025 年 7 月  17 日

https://www.3cx.cn/docs/bulk-extension-import/