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

Tài liệu này mô tả đúng các bước và nhãn nút hiển thị trong VitaAgent 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 VitaAgent mà không cần đăng nhập lại lần đầu. Từ lần sau, đăng nhập tại VitaAgent 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 VitaAgent: 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 VitaAgent
Tự vào bàn làm việc hoặc đăng nhập qua extension / email
myapps.vitapbx.com

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

VitaAgent 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.

Chọn micro, loa và thiết bị đổ chuông ở mục "Cài đặt âm thanh" trên bàn thoại (hoặc menu "Âm thanh (micro, loa, chuông)"): nói thử để thấy thanh "Kiểm tra micro" nhảy, bấm "Nghe thử loa" để kiểm tra tai nghe.

🔒 https://myapps.vitapbx.com
🎤
myapps.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

Bàn thoại hiển thị "Máy nhánh <số>" cùng trạng thái đăng ký: "Đang đăng ký..." (đang kết nối), "Đã đăng ký" (có thể gọi/nhận), "Mất kết nối" hoặc "Chưa cấp quyền mic" (xem mục Xử lý sự cố bên dưới).

Chỉ khi trạng thái là "Đã đăng ký" mới gọi được — nút "Gọi" bị vô hiệu hoá ở mọi trạng thái khác. Khi "Mất kết nối", bấm "Kết nối lại".

1001@T0018Đã đăng ký
Đã đă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@T0018Mất kết nối
Sai mật khẩu, máy nhánh bị tắt hoặc mất mạng
Bấm "Kết nối lại" hoặc tải lại trang
1001@T0018Chưa cấp quyền mic
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 máy nhánh của đồng nghiệp vào ô "Số điện thoại hoặc máy nhánh cần gọi" (hoặc chọn từ "Danh bạ máy nhánh") rồi bấm "Gọi".

Nhận cuộc gọi đến: màn hình hiện "Cuộc gọi đến từ <số gọi>" với hai nút "Nhấc máy" 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 mic" trong lúc đang gọi, đổi thành "Bật mic" khi micro đang tắt.

Giữ máy: nút "Giữ máy" trong lúc đang gọi; khi đang giữ, bấm "Tiếp tục đàm thoại" để quay lại.

Chuyển cuộc gọi: nhập số/máy nhánh vào ô "Máy nhánh/Số chuyển tiếp", rồi chọn "Chuyển thẳng" (chuyển ngay, không báo trước) hoặc "Chuyển có thông báo" (gọi người nhận trước) — sau khi trao đổi, bấm "Hoàn tất chuyển" hoặc "Hủy chuyển" để quay về cuộc gọi ban đầu.

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

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

"Trình duyệt cần quyền truy cập microphone để thực hiện cuộc gọi." — vào cài đặt trình duyệt (biểu tượng 🔒 trên thanh địa chỉ), cấp lại quyền microphone cho trang, rồi tải lại trang.

"Đăng ký SIP thất bại — vui lòng kiểm tra kết nối mạng." — thường do mất mạng tạm thời hoặc máy nhánh đã bị tắt; bấm "Kết nối lại" hoặc 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 "Đã đăng ký": kiểm tra loa/micro đã chọn trong "Cài đặt âm thanh", và 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 chuyển sang "Mất kết nối"): kiểm tra mạng, bấm "Kết nối lại" để đă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
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