Hướng dẫn sử dụng Softphone (Agent Console)

Tài liệu này mô tả đúng các bước và nhãn nút hiển thị trong Agent Console thực tế — nếu giao diện bạn thấy khác với mô tả bên dưới, vui lòng liên hệ VitaPBX để được hỗ trợ.

1. Kích hoạt tài khoản, đăng nhập, quên mật khẩu

Mở email kích hoạt gửi từ VitaPBX, bấm nút "Kích hoạt tài khoản". Trang kích hoạt hiển thị đúng tên doanh nghiệp, gói dịch vụ và extension được cấp — đặt mật khẩu (tối thiểu 8 ký tự, nhập lại để xác nhận) rồi bấm xác nhận.

Link kích hoạt chỉ dùng được một lần và có thời hạn. Nếu báo hết hạn hoặc đã dùng, dùng chức năng gửi lại email ngay trên trang kích hoạt.

Sau khi kích hoạt thành công, hệ thống tự đưa bạn vào Agent Console mà không cần đăng nhập lại lần đầu. Từ lần sau, đăng nhập tại Agent Console bằng extension (vd 1001@T0018) HOẶC bằng chính email bạn đã dùng để kích hoạt — cùng 1 mật khẩu vừa đặt, dùng cách nào cũng được.

Quên mật khẩu Agent Console: liên hệ VitaPBX để được hỗ trợ đặt lại (mật khẩu Softphone không được gửi qua email vì lý do bảo mật, kể cả khi bạn tự đặt lại).

✉️
1. Email kích hoạt
Bấm nút "Kích hoạt tài khoản" trong email
token=... (1 lần)
🔑
2. Đặt mật khẩu
Tự đặt mật khẩu (≥8 ký tự) & xác nhận
Gán máy nhánh
🎧
3. Vào Agent Console
Tự vào console hoặc đăng nhập qua extension / email
/console/

2. Mở Softphone và cấp quyền microphone

Agent Console yêu cầu HTTPS và trình duyệt hiện đại hỗ trợ Softphone (Chrome, Edge, Firefox, Safari bản mới) — mở qua HTTP hoặc trình duyệt cũ có thể không đăng ký được softphone.

Khi mở trang, trình duyệt sẽ hỏi quyền truy cập microphone — bấm "Cho phép". Đây là bước bắt buộc trước khi có thể nhận/gọi cuộc gọi.

Việc chọn tai nghe/thiết bị âm thanh nào được thực hiện ở cài đặt âm thanh của trình duyệt hoặc hệ điều hành (không có bộ chọn thiết bị riêng trong Agent Console) — cắm tai nghe trước khi cấp quyền microphone để trình duyệt nhận đúng thiết bị mặc định.

🔒 https://agents.vitapbx.com
🎤
agents.vitapbx.com
muốn Sử dụng micrô của bạn
💡 Mẹo: Cắm tai nghe trước khi bấm "Cho phép" để trình duyệt nhận đúng thiết bị thoại.

3. Kiểm tra trạng thái kết nối và extension được gán

Góc trên màn hình Softphone hiển thị "Extension <số máy nhánh>" cùng trạng thái đăng ký: "Đang đăng ký…" (đang kết nối), "Đã sẵn sàng" (có thể gọi/nhận), "Đăng ký thất bại" hoặc "Thiếu quyền microphone" (xem mục Xử lý lỗi bên dưới), "Chưa đăng ký" (chưa kết nối).

Chỉ khi trạng thái là "Đã sẵn sàng" mới gọi ra được — nút "Gọi" bị vô hiệu hoá ở mọi trạng thái khác.

1001@T0018Đã sẵn sàng
Đã đăng ký PBX, sẵn sàng gọi & nhận cuộc gọi
Nút "Gọi" sẵn sàng
1001@T0018Đang đăng ký…
Đang kết nối signaling WebSocket SIP tới PBX
Chờ trong giây lát
1001@T0018Đăng ký thất bại
Sai mật khẩu, máy nhánh bị tắt hoặc mất mạng
Tải lại trang hoặc báo hỗ trợ
1001@T0018Thiếu quyền microphone
Trình duyệt bị chặn micro, không thể đàm thoại
Bấm 🔒 thanh địa chỉ để cấp lại

4. Gọi nội bộ, nhận cuộc gọi

Gọi nội bộ: nhập extension đồng nghiệp vào ô "Số/extension cần gọi" (hoặc chọn thẳng từ danh bạ nội bộ hiển thị bên dưới) rồi bấm "Gọi".

Nhận cuộc gọi đến: màn hình hiện khối "Cuộc gọi đến từ <số gọi>" với hai nút "Trả lời" và "Từ chối".

Trong cuộc gọi, đồng hồ đếm thời lượng đàm thoại hiển thị ngay khi bắt máy. Bấm "Kết thúc" để gác máy.

📞 Bàn phím quay số & Gọi đi
1002 (Đồng nghiệp)
1
2
3
4
5
6
7
8
9
*
0
#
Cuộc gọi đến
0912.345.678
Gọi vào từ Hotline Doanh nghiệp
Đang đàm thoại02:45
1002 - CSKH Ca Sáng

5. Tắt tiếng, giữ máy, chuyển cuộc gọi

Tắt tiếng: nút "Tắt tiếng" trong lúc đang gọi, đổi thành "Bật tiếng" khi micro đang tắt.

Giữ máy: nút "Giữ máy" trong lúc đang gọi, đổi thành "Tiếp tục" khi cuộc gọi đang được giữ.

Chuyển cuộc gọi: nhập số/extension cần chuyển vào ô "Số chuyển tiếp", sau đó chọn "Chuyển ngay (Blind)" để chuyển thẳng không cần xác nhận trước, hoặc "Gọi thử trước (Attended)" để gọi thử người nhận trước — khi đó có thể bấm "Xác nhận chuyển" để hoàn tất hoặc "Hủy, quay lại" để quay về cuộc gọi ban đầu.

🎙️
Tắt tiếng / Bật tiếng
Tắt mic khi cần trao đổi nội bộ
[Tắt tiếng] ➔ [Bật tiếng]
⏸️
Giữ máy / Tiếp tục
Phát nhạc chờ cho khách hàng
[Giữ máy] ➔ [Tiếp tục]
Chuyển ngay (Blind)
Chuyển thẳng không cần báo trước
Nhập số ➔ [Chuyển ngay]
👥
Gọi thử trước (Attended)
Nói chuyện trước với người nhận
[Gọi thử] ➔ [Xác nhận]

6. Xử lý sự cố thường gặp

"Trình duyệt chưa được cấp quyền microphone. Softphone không thể nhận/gọi cuộc gọi." — vào cài đặt trình duyệt, cấp lại quyền microphone cho trang, rồi tải lại trang.

"Đăng ký softphone thất bại — kiểm tra lại cấu hình extension." — thường do extension đã bị vô hiệu hoá hoặc mất kết nối mạng tạm thời; thử tải lại trang, nếu vẫn lỗi liên hệ VitaPBX.

Không nghe được âm thanh dù trạng thái "Đã sẵn sàng": kiểm tra thiết bị phát âm thanh mặc định của trình duyệt/hệ điều hành, kiểm tra loa/tai nghe không bị tắt tiếng ở mức hệ thống.

Mất kết nối giữa cuộc gọi (trạng thái quay về "Chưa đăng ký" đột ngột): kiểm tra lại kết nối mạng, tải lại trang để đăng ký lại softphone.

7. Mời nhân viên và gán extension

Chủ tài khoản vào cổng khách hàng → "Quản lý đội ngũ", nhập email nhân viên vào form mời (chỉ hiển thị khi còn seat trống theo gói đang dùng).

Hệ thống tự cấp một extension còn trống trong dải số của doanh nghiệp cho nhân viên và gửi email kích hoạt riêng đến email đó — nhân viên thực hiện đúng các bước ở mục 1 của tài liệu này.

Lời mời đang chờ kích hoạt có thể huỷ bất kỳ lúc nào từ danh sách lời mời trong "Quản lý đội ngũ".

🏢
1. Cổng khách hàng
Vào "Quản lý đội ngũ"
📧
2. Nhập Email
Nhập email nhân viên
⚙️
3. Cấp Extension
Hệ thống tự gán số trống
📩
4. Gửi kích hoạt
Nhân viên đặt mật khẩu

8. Điều kiện để gọi ra ngoài (PSTN)

Tài khoản Softphone vừa kích hoạt CHỈ gọi được nội bộ (giữa các extension trong cùng doanh nghiệp). Để gọi ra số điện thoại bên ngoài, doanh nghiệp cần có đầu số/hotline và kết nối nhà mạng (trunk) được VitaPBX xác nhận.

Trong bước đặt hàng, bạn có thể chọn "Tôi đã có đầu số/hotline" để gửi thông tin cho đội kỹ thuật kiểm tra kết nối, hoặc "Tôi cần tư vấn đầu số" để được VitaPBX liên hệ tư vấn.

Chưa có đầu số không ảnh hưởng đến việc kích hoạt tài khoản hay gọi nội bộ — chỉ giới hạn duy nhất khả năng gọi ra ngoài.

💻 📱
WebRTC Softphone
Máy nhánh 1001, 1002...
✓ Miễn phí gọi nội bộ
WSS / SRTP
☁️ ⚙️
VitaPBX Cloud
Máy chủ SIP, IVR & Định tuyến
PBX Core Cluster
SIP Trunk
📡 ☎️
Nhà mạng & Di động
Đầu số cố định, 1800/1900
Gọi ra khách hàng