Nhập hàng loạt người dùng và tự động cấp phép điện thoại IP

Hướng dẫn này được lập ra để hỗ trợ quản trị viên công ty trong việc cấu hình một số lượng lớn nhân viên sử dụng tính năng nhập hàng loạt của SkyX PBX. Tính năng này cho phép thêm người dùng nhanh chóng và dễ dàng ở định dạng bảng tính, mà không cần cấu hình cài đặt từng thiết bị gấytốn thời gian. Hơn nữa, khi nhập người dùng hàng loạt, bạn cũng có thể tự động cấp phép Điện thoại IP cho người dùng cùng lúc.

Các biện pháp tốt nhất

Tạo một người dùng với tất cả các cài đặt cần thiết, chẳng hạn như quy tắc chuyển tiếp, giờ làm việc, Điện thoại IP và phím BLF.
Xuất người dùng này ra tệp CSV để làm mẫu.
Xóa người dùng đó trong cổng web SkyX PBX.
Chỉnh sửa tệp CSV mẫu để thêm thông tin người dùng mới. Điều này có thể được thực hiện bằng cách sao chép từ người dùng mẫu và thực hiện các thay đổi cần thiết. Ví dụ, bạn có thể cần thay đổi tên người dùng, mật khẩu, số máy nhánh, giờ làm việc và thông tin điện thoại, cùng nhiều thứ khác.
Lưu các thay đổi của bạn và sau đó nhập tệp CSV vào cổng web SkyX PBX.

Bằng cách làm theo các bước này, bạn có thể quản lý và cấu hình nhiều người dùng trên nền tảng SkyX PBX một cách hiệu quả. Quá trình này không chỉ tiết kiệm thời gian mà còn đảm bảo tính nhất quán trong cài đặt người dùng trên toàn hệ thống. Hãy nhớ rằng, chìa khóa để nhập hàng loạt và tự động cấp phép thành công nằm ở sự chuẩn bị cẩn thận và chú ý đến chi tiết khi tạo và chỉnh sửa tệp CSV của bạn.

Cấu hình tệp CSV trong bảng tính hoặc trình soạn thảo văn bản phải được thực hiện ở định dạng UTF-8.

Giải thích các cột mẫu (Template Columns Explanation)

Các cột tiêu đề tệp CSV như sau:

name: Đây là tên người dùng mà người dùng sẽ nhập để truy cập cổng web PBX. Nó phải bao gồm số và chữ cái.
enabled: Điều này cho biết liệu người dùng này có được bật hay không. Giá trị có thể là TRUE hoặc FALSE. Người dùng sẽ bị vô hiệu hóa nếu nó được đặt thành FALSE.
password: Đây là mật khẩu để người dùng đăng nhập vào cổng web PBX. Nó phải đáp ứng chính sách mật khẩu của người thuê, nếu không, việc nhập sẽ thất bại.
extension_number: Đây là số máy nhánh của người dùng. Nó chỉ chấp nhận số và giới hạn tối đa 64 chữ số.
extension_password: Đây là mật khẩu để máy nhánh đăng ký với PBX từ điểm cuối SIP. Nó phải đáp ứng chính sách mật khẩu của người thuê, nếu không, việc nhập sẽ thất bại.
email: Đây là địa chỉ email của người dùng.
display_name: Đây là tên đầy đủ của người dùng, ví dụ: Jim Keeny.
enable_audio_recording: Điều này cho biết có bật ghi âm cuộc gọi thoại hay không cho người dùng. TRUE để bật và FALSE để tắt.
enable_video_recording: Điều này cho biết có bật ghi hình hay không cho người dùng. TRUE để bật và FALSE để tắt.
enable_acb: Điều này cho biết có bật gọi lại tự động hay không cho người dùng. TRUE để bật và FALSE để tắt.
enable_dnd: Điều này cho biết có bật chế độ Không làm phiền hay không cho người dùng. TRUE để bật và FALSE để tắt.
enable_hot_desking: Điều này cho biết có bật Hot Desking hay không cho người dùng. TRUE để bật và FALSE để tắt.
office_hours: Điều này chỉ định giờ làm việc cho người dùng. Nó có thể sử dụng giờ làm việc toàn cầu từ cấp người thuê, hoặc tạo giờ làm việc tùy chỉnh chỉ cho người dùng này. Giờ làm việc được định nghĩa ở định dạng JSON.

Nếu chế độ là "CUSTOM", có nghĩa là sử dụng giờ làm việc được chỉ định cho người dùng đó. Đối với mỗi ngày trong tuần, nếu khóa enabled là true, có nghĩa là ngày đó mở, và ranges là một mảng JSON được sử dụng để định nghĩa các ca thời gian cho giờ làm việc. Nếu ranges trống, có nghĩa là cả ngày đều mở; nếu khóa enabled là false, có nghĩa là cả ngày đều đóng, và ranges sẽ bị bỏ qua.

JSON

{
	"mode": "CUSTOM",
	"monday": {
		"enabled": true,
		"ranges": [{
			"from": "09:00",
			"to": "11:00"
		}, {
			"from": "12:00",
			"to": "17:00"
		}]
	},
	"tuesday": {
		"enabled": true,
		"ranges": [{
			"from": "09:00",
			"to": "17:00"
		}]
	},
	"wednesday": {
		"enabled": true,
		"ranges": []
	},
	"thursday": {
		"enabled": true,
		"ranges": []
	},
	"friday": {
		"enabled": true,
		"ranges": []
	},
	"saturday": {
		"enabled": false,
		"ranges": []
	},
	"sunday": {
		"enabled": false,
		"ranges": []
	}
}

Nếu chế độ được đặt là "GLOBAL", có nghĩa là giờ làm việc của người dùng sẽ tuân theo giờ làm việc của người thuê.

JSON

{
	"mode": "GLOBAL",
	"monday": {
		"enabled": true,
		"ranges": []
	},
	"tuesday": {
		"enabled": true,
		"ranges": []
	},
	"wednesday": {
		"enabled": true,
		"ranges": []
	},
	"thursday": {
		"enabled": true,
		"ranges": []
	},
	"friday": {
		"enabled": true,
		"ranges": []
	},
	"saturday": {
		"enabled": true,
		"ranges": []
	},
	"sunday": {
		"enabled": true,
		"ranges": []
	}
}

anonymous_outbound_calls: Điều này cho biết có bật cuộc gọi ẩn danh hay không cho người dùng. TRUE để bật và FALSE để tắt.
delivery_outbound_cid: Điều này cho biết có ghi lại phần người dùng của tiêu đề From bằng ID người gọi đi trong tin nhắn SIP INVITE hay không khi người dùng thực hiện cuộc gọi đến trunk. TRUE để bật và FALSE để tắt.
sms: Điều này chỉ định quyền gửi tin nhắn SMS và WhatsApp, nó có thể là DISABLE, ALLOW_WITH_SENDER_ID, ALLOW. Nó chỉ áp dụng cho PBX v22.0 trở lên.
voicemail_prompt: Điều này chỉ định ngôn ngữ lời nhắc hộp thư thoại. Nó là BCP 47 Language Tags (Các Thực hành tốt nhất hiện tại của Internet (BCP) cho thẻ ngôn ngữ), ví dụ, en-US.
enable_voicemail_pin: Điều này cho biết có xác minh mã PIN hộp thư thoại hay không khi người dùng truy cập hộp thư thoại của họ bằng cách quay FAC. TRUE để bật và FALSE để tắt.
voicemail_pin: Điều này đặt mã PIN hộp thư thoại. Đây là trường bắt buộc và phải là số và đáp ứng chính sách mật khẩu hộp thư thoại.
voicemail_play_datetime: Điều này cho biết có phát ngày và giờ hay không khi người dùng truy cập hộp thư thoại của họ. TRUE để bật và FALSE để tắt.
enable_voicemail_notify: Điều này cho biết có gửi thông báo email đến email của người dùng hay không nếu hộp thư thoại mới được tạo. TRUE để bật và FALSE để tắt.
online_no_answer_forward_rule: Điều này chỉ định quy tắc chuyển tiếp nếu người dùng trực tuyến nhưng không trả lời cuộc gọi trong một thời gian nhất định. Nó là một đối tượng JSON bao gồm các khóa sau:
- action: Cho phép đặt FORWARD_TO_NUMBER, FORWARD_TO_VOICEMAIL, HANGUP.
- timeout: Chỉ định thời gian đổ chuông tối đa trước khi thực hiện hành động, tính bằng giây.
- number: Chỉ định số đích nếu hành động được đặt là FORWARD_TO_NUMBER. Nó sẽ bị bỏ qua nếu hành động không được đặt là FORWARD_TO_NUMBER.
Ví dụ, nếu cuộc gọi không được trả lời trong 60 giây, cuộc gọi đó sẽ được chuyển tiếp đến hộp thư thoại. Điều này có thể được đặt như sau:

JSON
```
{
	"action": "FORWARD_TO_VOICEMAIL",
	"timeout": 60,
	"number": ""
}
```
online_busy_forward_rule: Điều này chỉ định quy tắc chuyển tiếp nếu người dùng trực tuyến nhưng hiện đang trong cuộc gọi. Nó là một đối tượng JSON bao gồm các khóa sau:
- action: Cho phép đặt FORWARD_TO_NUMBER, FORWARD_TO_VOICEMAIL, RING_ANYWAY, HANGUP.
- timeout: Nó sẽ bị bỏ qua cho quy tắc chuyển tiếp bận trực tuyến.
- number: Chỉ định số đích nếu hành động được đặt là FORWARD_TO_NUMBER. Nó sẽ bị bỏ qua nếu hành động không được đặt là FORWARD_TO_NUMBER.
Ví dụ, nếu người dùng đang trong cuộc gọi, cuộc gọi mới gọi đến người đó sẽ được gửi đến người đó bằng mọi cách. Các khóa timeout và number sẽ bị bỏ qua. Điều này có thể được đặt như sau:

JSON
```
{
	"action": "RING_ANYWAY",
	"timeout": 60,
	"number": ""
}
```
offline_office_hours_forward_rule: Điều này chỉ định quy tắc chuyển tiếp nếu người dùng ngoại tuyến và hiện đang trong giờ làm việc. Nó là một đối tượng JSON bao gồm các khóa sau:
- action: Cho phép đặt FORWARD_TO_NUMBER, FORWARD_TO_VOICEMAIL, HANGUP.
- timeout: Nó sẽ bị bỏ qua cho quy tắc chuyển tiếp ngoại tuyến.
- number: Chỉ định số đích nếu hành động được đặt là FORWARD_TO_NUMBER. Nó sẽ bị bỏ qua nếu hành động không được đặt là FORWARD_TO_NUMBER.
Ví dụ, nếu người dùng ngoại tuyến trong giờ làm việc, cuộc gọi mới gọi đến người đó sẽ bị ngắt kết nối. Các khóa timeout và number sẽ bị bỏ qua. Điều này có thể được đặt như sau:

JSON
```
{
	"action": "HANGUP",
	"timeout": 60,
	"number": ""
}
```
offline_non_office_hours_forward_rule: Điều này chỉ định quy tắc chuyển tiếp nếu người dùng ngoại tuyến và hiện đang ngoài giờ làm việc. Nó là một đối tượng JSON bao gồm các khóa sau:
- action: Cho phép đặt FORWARD_TO_NUMBER, FORWARD_TO_VOICEMAIL, HANGUP.
- timeout: Nó sẽ bị bỏ qua cho quy tắc chuyển tiếp ngoại tuyến.
- number: Chỉ định số đích nếu hành động được đặt là FORWARD_TO_NUMBER. Nó sẽ bị bỏ qua nếu hành động không được đặt là FORWARD_TO_NUMBER.
Ví dụ, nếu người dùng ngoại tuyến ngoài giờ làm việc, cuộc gọi mới gọi đến người đó sẽ được chuyển tiếp đến số 123456. Khóa timeout sẽ bị bỏ qua. Điều này có thể được đặt như sau:

JSON
```
{
	"action": "FORWARD_TO_NUMBER",
	"timeout": 60,
	"number": "123456"
}
```
custom_forward_rules: Các quy tắc này đóng vai trò là ngoại lệ ghi đè lên các quy tắc chuyển tiếp tiêu chuẩn. Chúng được định nghĩa là một đối tượng JSON. Nếu bạn muốn để trống trường này, hãy đặt nó là []. Điều này cho phép người dùng tự thiết lập các quy tắc ngoại lệ thông qua cổng web SkyX PBX.
blfs: Trường này được sử dụng để chỉ định các phím BLF (Busy Lamp Field). Nó cũng là một đối tượng JSON. Để trống, hãy đặt nó là [].
interface: Trường này được sử dụng để chỉ định Địa chỉ IP Giao diện mạng, được sử dụng để tạo mã QR. Ứng dụng khách sẽ kết nối với SkyX PBX bằng địa chỉ IP này. Nó chấp nhận các giá trị sau:
- WEB_DOMAIN: Ứng dụng khách sẽ sử dụng Tên miền Web SkyX PBX làm địa chỉ máy chủ proxy đi.
- PUBLIC_IPV4: Ứng dụng khách sẽ sử dụng địa chỉ IPv4 công cộng của SkyX làm địa chỉ máy chủ proxy đi.
- PUBLIC_IPV6: Ứng dụng khách sẽ sử dụng địa chỉ IPv6 công cộng của SkyX PBX làm địa chỉ máy chủ proxy đi.
- PRIVATE_IPV4: Ứng dụng khách sẽ sử dụng địa chỉ IPv4 riêng của SkyX PBX làm địa chỉ máy chủ proxy đi.
- PRIVATE_IPV6: Ứng dụng khách sẽ sử dụng địa chỉ IPv6 riêng của SkyX PBX làm địa chỉ máy chủ proxy đi.
- SBC_DOMAIN: Ứng dụng khách sẽ sử dụng tên miền web SkyX SBC làm địa chỉ máy chủ proxy đi, và sau đó ứng dụng khách đăng ký với SkyX PBX thông qua SkyX SBC.
preferred_transport: Trường này được sử dụng để chỉ định giao thức vận chuyển cho SkyX PBX trong mã QR. Sau khi quét mã QR, ứng dụng khách sẽ ưu tiên sử dụng giao thức vận chuyển được chỉ định này để đăng ký với SkyX PBX. Khóa này chấp nhận UDP, TCP và TLS.
custom_options: Trường này được dành riêng để đặt các tùy chọn tùy chỉnh. Nó thường được để trống.
role: Trường này được sử dụng để chỉ định vai trò của người dùng. Nó chấp nhận các giá trị sau: StandardUser, StandardInternationalUser, QueueManager, Admin.
phones: Trường này được sử dụng để chỉ định tự động cấp phép Điện thoại IP cho người dùng này. Nó là một đối tượng JSON bao gồm các khóa sau:
- mac: Đây là địa chỉ MAC của điện thoại. Nó phải ở dạng chữ thường với dấu phân cách “:” hoặc “-”. Vui lòng đảm bảo Địa chỉ MAC của Điện thoại này không được sử dụng bởi người dùng khác, nếu không, việc cấp phép sẽ thất bại.
- filename: Đây là tệp mẫu của điện thoại IP.
- vendor: Đây là nhà cung cấp của điện thoại IP.
- interface: Điều này chỉ định Địa chỉ IP của giao diện mạng của PBX cho điện thoại IP, sẽ được coi là máy chủ proxy đi trong cài đặt Điện thoại IP. Các giá trị tương tự như interface đã giải thích ở trên.
- preferred_transport: Điều này chỉ định giao thức truyền tải của SkyX PBX cho điện thoại IP này. Điện thoại IP sẽ ưu tiên sử dụng giao thức truyền tải được chỉ định này để đăng ký với SkyX PBX. Nó cho phép UDP, TCP hoặc TLS.
- model: Đây là kiểu điện thoại.
- password: Điều này chỉ định mật khẩu giao diện web của điện thoại.
- language: Điều này chỉ định ngôn ngữ hiển thị cho điện thoại IP. Nó hỗ trợ các giá trị sau: ENGLISH, CHINESE, DUTCH, FRENCH, GERMAN, GREEK, ITALIAN, JAPANESE, POLISH, RUSSIAN, SPANISH, SWEDISH, UKRAINIAN, BULGARIAN.
- timezone: Điều này chỉ định múi giờ cho Điện thoại IP này.
- transfer: Điều này chỉ định chế độ chuyển cho phím chuyển của điện thoại IP. Nó có thể là ATTENDED, BLIND, và NEW_CALL.
- ringtone: Đây là nhạc chuông khi nhận cuộc gọi mới.
- queue_ringtone: Điều này chỉ định nhạc chuông cho cuộc gọi chờ.
- date_format: Đây là định dạng ngày cho điện thoại.
- time_format: Đây là định dạng thời gian cho điện thoại.
- powerled: Đây là đèn LED nguồn.
- backlight: Đây là đèn nền của màn hình Điện thoại IP.
- screensaver: Đây là trình bảo vệ màn hình của Điện thoại IP.
- rps: Điều này cho biết có lưu URL tự động cấp phép vào máy chủ RPS của nhà cung cấp Điện thoại IP hay không. Đặt thành true sẽ được lưu trữ trong RPS và false sẽ không.
- https: Điều này cho biết có tạo URL tự động cấp phép bằng giao thức HTTPS hay không. Đặt thành true URL sẽ là HTTPS và false sẽ là HTTP.
Đối với v22.x:
```
[
  {
    "mac": "0c:38:3e:63:fe:e8",
    "rps": true,
    "https": false,
    "model": "V62 Pro",
    "codecs": [
      "PCMU",
      "PCMA",
      "G729",
      "G722"
    ],
    "vendor": "Fanvil",
    "filename": "fanvil.ph.xml",
    "language": "English",
    "password": "63FEE8",
    "powerled": "Both (Voicemail and Missed calls)",
    "ringtone": "Default",
    "timezone": "GMT+8 China(Beijing)",
    "transfer": "BLIND",
    "backlight": "30 seconds",
    "interface": "WEB_DOMAIN",
    "pc_port_id": 254,
    "date_format": "15 JAN MON",
    "enable_lldp": false,
    "screensaver": "",
    "time_format": "24-hour clock",
    "wan_port_id": 256,
    "serial_number": "",
    "door_password1": "",
    "door_password2": "",
    "queue_ringtone": "Ring 1",
    "pc_port_priority": 0,
    "wan_port_priority": 0,
    "enable_vlan_pc_port": false,
    "preferred_transport": "UDP",
    "enable_vlan_wan_port": false
  }
]
```

Tệp CSV mẫu

Chúng tôi cung cấp một tệp CSV mẫu để nhập hàng loạt và tự động cấp phép bốn người dùng.

Đối với v22.x

Sau khi bạn tải xuống tệp CSV mẫu đó, bạn có thể đăng nhập vào cổng web SkyX PBX, trong menu Call Manager > Users (Quản lý cuộc gọi > Người dùng), nhấp vào nút Import (Nhập), và chọn tệp CSV mẫu để nhập người dùng, người dùng sẽ được tạo thành công với thông tin cấp phép.

Vui lòng cũng tham khảo bài viết Cấp phép điện thoại không chạm.

Các biện pháp tốt nhất ​

Giải thích các cột mẫu (Template Columns Explanation)​

Tệp CSV mẫu ​

Các biện pháp tốt nhất

Giải thích các cột mẫu (Template Columns Explanation)

Tệp CSV mẫu