# Sự cố thường gặp

> Cần kiểm tra gì khi tài khoản không đăng ký được, không có âm thanh, cuộc gọi hay cuộc họp không được ghi, không có bản chép lời, người nhắc không chạy, hoặc liên kết, phím tắt hay API không có tác dụng, và ý nghĩa của các thông báo do chính điện thoại hiển thị.

Mỗi mục chỉ tới cài đặt quyết định vấn đề đó. Nếu câu trả lời không có ở đây, hãy mở [Chẩn đoán](https://docs.ai-softphone.com/vi/troubleshooting/diagnostics/index.md): nó cho thấy điện thoại và tổng đài nói gì với nhau.

## Tài khoản không đăng ký được {#the-account-will-not-register}

Chấm cạnh tài khoản trong **Cài đặt → Tài khoản** vẫn xám hoặc đỏ.

1. Kiểm tra **Tên đăng nhập**, **Mật khẩu** và **Địa chỉ máy chủ** trong [biểu mẫu tài khoản](https://docs.ai-softphone.com/vi/sip-accounts/setup/index.md).
2. Nếu tổng đài của bạn kiểm tra mật khẩu dưới một tên khác với số máy lẻ, hãy điền **Người dùng xác thực** trong **Cài đặt máy chủ**.
3. Đối chiếu **Giao vận** và **Cổng** với những gì tổng đài yêu cầu.
4. Mở thẻ **SIP** của [cửa sổ chẩn đoán](https://docs.ai-softphone.com/vi/troubleshooting/diagnostics/index.md) và xem yêu cầu `REGISTER` cùng câu trả lời của máy chủ.

## Tôi không nghe được, hoặc người khác không nghe được tôi {#i-cannot-hear-or-i-cannot-be-heard}

Mở [Cài đặt → Thiết bị](https://docs.ai-softphone.com/vi/sip-accounts/devices/index.md).

- Hãy nói gì đó: thanh dưới **Micrô** phải chuyển động. Nếu không, hãy chọn micrô khác.
- Nhấn **Thử** dưới **Loa** để nghe một âm thanh trên thiết bị bạn đã chọn.
- Kiểm tra các thanh trượt **Âm lượng**. **Tắt tiếng micrô** trên khung cuộc gọi và [phím tắt](https://docs.ai-softphone.com/vi/program/shortcuts/index.md) **Tắt tiếng micrô** sẽ tắt micrô trong lúc gọi.
- Nhạc chuông có thể được đặt đổ trên một thiết bị khác với thiết bị bạn dùng để nói chuyện — **Nhạc chuông**, danh sách thả xuống thứ hai.

## Cuộc gọi nghe kém, hoặc không bắt đầu được {#the-call-sounds-bad-or-does-not-start}

Các codec được đề nghị theo thứ tự của danh sách trong [Cài đặt → Cuộc gọi](https://docs.ai-softphone.com/vi/sip-accounts/calls/index.md#audio-formats). Hãy bật các codec mà tổng đài của bạn dùng, và đặt codec tốt nhất lên đầu. Thay đổi có hiệu lực từ cuộc gọi tiếp theo của bạn.

## Cuộc gọi thứ hai không đổ chuông {#a-second-call-does-not-ring}

Điều xảy ra khi có người gọi đến trong lúc bạn đang trong một cuộc gọi được thiết lập ở [Chờ cuộc gọi](https://docs.ai-softphone.com/vi/sip-accounts/calls/index.md#call-waiting).

## Cuộc gọi không được ghi âm {#a-call-was-not-recorded}

- **Cài đặt → Ghi âm**, danh sách thả xuống đầu tiên, quyết định những cuộc gọi nào được ghi âm; mặc định là **Thủ công**, chỉ ghi âm khi bạn nhấn nút ghi âm trên khung cuộc gọi. Xem [Bản ghi](https://docs.ai-softphone.com/vi/recordings/index.md).
- Việc ghi âm bắt đầu khi cuộc gọi được trả lời, nên cuộc gọi không được trả lời thì không có tệp.
- Mô-đun **Ghi âm** phải được bật trong [Mô-đun](https://docs.ai-softphone.com/vi/application/modules/index.md).
- Bản ghi bị xoá bởi các giới hạn ở mục **Lưu giữ**; bản ghi đã ghim không bao giờ bị xoá.

## Cuộc họp trong ứng dụng khác không được thu {#a-meeting-in-another-application-was-not-captured}

Xem [Thu âm ngoài](https://docs.ai-softphone.com/vi/capture/index.md).

- **Cho phép thu âm thanh** trong **Cài đặt → Thu âm ngoài** phải được bật.
- Khi **Bắt đầu tự động** đặt là **Hỏi tôi** (mặc định), hãy trả lời câu hỏi khi nó hiện ra; với **Không bao giờ**, hãy tự nhấn nút ghi.
- Dùng **Thử** trên cùng thẻ: thanh trên phải chuyển động khi bạn nói, thanh dưới khi có gì đó đang phát.
- Mô-đun **Thu âm ngoài** phải được bật trong [Mô-đun](https://docs.ai-softphone.com/vi/application/modules/index.md).

## Có bản ghi nhưng không có bản chép lời hay bản tóm tắt {#there-is-a-recording-but-no-transcript-or-summary}

- Cuộc trò chuyện chỉ tự được chép lời và xử lý nếu **Xử lý các cuộc trò chuyện tự động** được bật trong [Cài đặt → Xử lý](https://docs.ai-softphone.com/vi/ai-processing/processing/index.md). Nếu không, hãy yêu cầu trong [cửa sổ Bản ghi](https://docs.ai-softphone.com/vi/interface/recordings/index.md).
- Phải có một [bộ nhận dạng](https://docs.ai-softphone.com/vi/ai-processing/transcription/index.md) và một [mô hình ngôn ngữ](https://docs.ai-softphone.com/vi/ai-processing/processing/index.md#language-models), và mỗi thứ phải trả lời tại địa chỉ của nó.
- Khi chạm tới **Hạn mức tiền** hoặc **Hạn mức token** hằng tháng, các quy tắc tự động dừng lại cho tới khi sang tháng mới. Những gì chính bạn yêu cầu thì không bao giờ bị dừng.
- Các bước trong [Cài đặt → Tổng quan](https://docs.ai-softphone.com/vi/interface/settings-overview/index.md) cho thấy những gì còn phải thiết lập.

## Người nhắc không xuất hiện hoặc không chạy {#the-prompter-does-not-appear-or-does-not-start}

**Người nhắc** chỉ xuất hiện trong danh sách ở cuối điện thoại khi có đủ ba thứ: một bộ nhận dạng có **Địa chỉ cho người nhắc** đã vượt qua lần **Thử** trong [Cài đặt → Gỡ băng](https://docs.ai-softphone.com/vi/ai-processing/transcription/index.md#live-recognition-for-the-prompter), một mô hình ngôn ngữ, và dấu chọn **Cho phép dùng người nhắc** trong [Cài đặt → Người nhắc](https://docs.ai-softphone.com/vi/ai-processing/prompter/index.md). Mô-đun **Người nhắc** phải được bật trong [Mô-đun](https://docs.ai-softphone.com/vi/application/modules/index.md).

Nếu cửa sổ mở ra nhưng người nhắc không chạy, dòng bên dưới các nút của nó cho biết còn thiếu gì. [Khi nó không chạy](https://docs.ai-softphone.com/vi/interface/prompter/index.md#when-it-does-not-start) liệt kê mọi thông báo và cách xử lý.

## Điện thoại biến mất khi tôi đóng cửa sổ {#the-phone-disappeared-when-i-closed-the-window}

Khi **Giữ điện thoại chạy khi đóng cửa sổ** được bật, điện thoại vẫn đang chạy và cuộc gọi vẫn đến. Biểu tượng trong vùng thông báo (thanh menu trên macOS) mở lại cửa sổ. Trên màn hình nền không có vùng thông báo, điện thoại được thu nhỏ trên thanh tác vụ. Xem [Khởi động](https://docs.ai-softphone.com/vi/program/startup/index.md).

## Số điện thoại trong trình duyệt hay CRM không gọi được {#a-phone-number-in-a-browser-or-a-crm-does-not-call}

Nhấn **Mở liên kết gọi bằng điện thoại này** trong [Cài đặt → Khởi động](https://docs.ai-softphone.com/vi/program/startup/index.md#call-links). Số được nhấp sẽ hiện trong bàn quay số và chờ ở đó, trừ khi **Gọi ngay, không cần nhấn Gọi** được bật.

## Đèn của nút bấm vẫn xám {#a-buttons-lamp-stays-grey}

Tổng đài không cho biết số máy lẻ có rảnh hay không. Nút vẫn gọi được. Xem [Nút bấm](https://docs.ai-softphone.com/vi/sip-accounts/buttons/index.md).

## REST API không trả lời {#the-rest-api-does-not-answer}

- **Cho phép các chương trình khác trên máy này điều khiển điện thoại** phải được bật trong [Cài đặt → Tích hợp](https://docs.ai-softphone.com/vi/integration/rest-api/index.md), và mô-đun **Tích hợp** trong [Mô-đun](https://docs.ai-softphone.com/vi/application/modules/index.md).
- Địa chỉ là `http://127.0.0.1:8377` trừ khi bạn đã đổi **Cổng**.
- Một nhóm bạn chưa mở ở mục **Truy cập** trả lời mọi yêu cầu bằng `404`.
- Nếu bạn đặt **Token**, các yêu cầu thay đổi dữ liệu đã lưu phải mang token đó trong tiêu đề `Authorization`.
- Thêm các triệu chứng khác có trong [Khi nó không hoạt động](https://docs.ai-softphone.com/vi/integration/rest-api/index.md#when-it-does-not-work).

## Webhook không đến {#webhooks-do-not-arrive}

Nhấn **Gửi một sự kiện thử** trong [Cài đặt → Tích hợp](https://docs.ai-softphone.com/vi/integration/webhooks/index.md). Các bộ đếm `webhooks_failed_total` và `webhooks_dropped_total` của REST API cho thấy việc chuyển phát đang diễn ra thế nào; [Khi không có gì đến](https://docs.ai-softphone.com/vi/integration/webhooks/index.md#when-nothing-arrives) liệt kê ý nghĩa của từng bộ đếm.

## Phím tắt không có tác dụng {#a-hotkey-does-nothing}

Mở [Phím tắt](https://docs.ai-softphone.com/vi/program/shortcuts/index.md). Phím tắt hoạt động trong lúc điện thoại là chương trình bạn đang dùng; để dùng nó từ mọi chương trình, hãy đánh dấu **Ở mọi nơi**. Nhấp vào phím tắt và nhấn lại tổ hợp phím nếu một chương trình khác đã chiếm nó.

## Các thông báo của điện thoại {#messages-the-phone-shows}

Khi điều gì đó không xảy ra, điện thoại cho biết lý do trên một dòng riêng. Dòng bên dưới danh sách tự biến mất sau vài giây.

### Khi cuộc gọi không được thực hiện {#when-a-call-is-not-placed}

| Thông báo | Cần làm gì |
| --- | --- |
| *Chưa có tài khoản nào được thiết lập* | Thêm tài khoản trong [Cài đặt → Tài khoản](https://docs.ai-softphone.com/vi/sip-accounts/setup/index.md). |
| *Không có tài khoản nào đang bật, nên không có đường dây để gọi đi.* | Đánh dấu ô của một tài khoản trong **Cài đặt → Tài khoản**. |
| *Chưa có đường dây nào đăng ký.* | Tài khoản đã bật nhưng chưa đăng ký trên tổng đài. Hãy đợi chấm của nó chuyển sang xanh; nếu không, xem [Tài khoản không đăng ký được](#the-account-will-not-register). |
| *Số cuộc gọi đang chạy đã bằng mức máy này chịu được.* | Gác một trong các cuộc gọi, rồi gọi lại. |
| *Tài khoản đáng lẽ dùng để gọi đã không còn.* | Dòng này thuộc về một tài khoản đã bị xóa. Hãy bấm số trên bàn phím quay số. |
| *Dòng này không có số để gọi lại.* | Người gọi đã ẩn số, nên không có số nào để gọi lại. |

### Khi tài khoản không kết nối {#when-an-account-does-not-connect}

| Thông báo | Cần làm gì |
| --- | --- |
| *Không tìm thấy địa chỉ máy chủ đó. Hãy kiểm tra xem có gõ sai không.* | Kiểm tra **Địa chỉ máy chủ** trong [biểu mẫu tài khoản](https://docs.ai-softphone.com/vi/sip-accounts/setup/index.md). |
| *Không liên hệ được máy chủ. Hãy kiểm tra địa chỉ, cổng và mạng của bạn.* | Kiểm tra **Địa chỉ máy chủ**, cùng **Giao vận** và **Cổng** trong **Cài đặt máy chủ**. Tường lửa cũng có thể đang chặn SIP. |
| *Máy chủ từ chối tên đăng nhập hoặc mật khẩu này.* | Kiểm tra **Tên đăng nhập** và **Mật khẩu**. Nếu tổng đài kiểm tra mật khẩu dưới một tên khác, hãy điền **Người dùng xác thực**. |
| *Không thể xác minh chứng chỉ của máy chủ. Nếu quản trị viên máy chủ tự tạo chứng chỉ, hãy bỏ chọn “Xác minh chứng chỉ” trong “Cài đặt máy chủ”.* | Xuất hiện với kết nối TLS. Nếu tổng đài dùng chứng chỉ do chính nó tạo, hãy bỏ chọn **Xác minh chứng chỉ** trong **Cài đặt máy chủ**. |
| *Không đọc được mật khẩu của tài khoản này từ kho khoá. Hãy mở khoá rồi kết nối lại.* | Mở khóa kho mật khẩu của máy tính (Keychain trên macOS), rồi bấm **Kết nối** ở tài khoản. |

### Trong cuộc gọi {#during-a-call}

| Thông báo | Cần làm gì |
| --- | --- |
| *Không có định dạng âm thanh chung* | Tổng đài và điện thoại không có codec chung. Hãy bật một codec mà tổng đài dùng trong [Định dạng âm thanh](https://docs.ai-softphone.com/vi/sip-accounts/calls/index.md#audio-formats). |
| *Không có micrô hay loa* | Chọn thiết bị trong [Cài đặt → Thiết bị](https://docs.ai-softphone.com/vi/sip-accounts/devices/index.md). |
| *Không ghi âm: dung lượng đĩa đã chạm ngưỡng. Hãy dọn bớt, hoặc đổi ngưỡng trong Cài đặt.* | Dung lượng trống trên đĩa đã chạm **Ngưỡng dung lượng đĩa** — xem [Bản ghi](https://docs.ai-softphone.com/vi/recordings/index.md). Giải phóng dung lượng, hoặc hạ ngưỡng xuống. |

### Khi điện thoại khởi động {#when-the-phone-starts}

*Không đọc được cơ sở dữ liệu* nghĩa là cơ sở dữ liệu được tạo bởi một phiên bản khác của chương trình và phiên bản này không đọc được. Thường là một phiên bản cũ hơn đã được chạy trên dữ liệu của phiên bản mới hơn: cài lại phiên bản mới hơn sẽ mở cơ sở dữ liệu như cũ. **Bắt đầu lại** thì ngược lại, tạo một cơ sở dữ liệu trống — mọi liên hệ và mọi cuộc gọi trong lịch sử đều mất, và không thể hoàn tác. Trước khi bấm, bạn có thể giữ một bản sao của tệp cơ sở dữ liệu; [Chẩn đoán](https://docs.ai-softphone.com/vi/troubleshooting/diagnostics/index.md#files) cho biết tệp nằm ở đâu.

## Thực thi mặc định {#default-prompt-execution}

Không có quy tắc tự động mặc định cho `action-items`, `topics`, `entities` hoặc `qa`. Hãy chạy lời nhắc thủ công hoặc thêm quy tắc phù hợp; nhập câu hỏi khi chạy `qa`.

Chạy `summary` trước `super-summary`, vì lời nhắc sau sử dụng `{{artifact:summary}}`. Chạy `categorise` trước khi đánh giá chất lượng: `sales-quality` yêu cầu phân loại `sales`, còn `support-quality` yêu cầu `support`.

[Thực thi mặc định](https://docs.ai-softphone.com/vi/ai-processing/processing/index.md#default-execution)

## Hiểu kết quả {#prompt-result-notes}

Danh sách nhiệm vụ hoặc cảnh báo trống có thể là kết quả đúng. Không được tự đặt người phụ trách hoặc thời hạn còn thiếu. Câu trả lời phải chỉ dựa trên bản chép lời.

Đây là tên các trợ lý có sẵn; ảnh chụp màn hình có thể hiển thị tên cũ. “—” từ `rt-objections` nghĩa là không có gợi ý hữu ích. Hướng dẫn cũng bao gồm câu hỏi chưa được trả lời và dấu hiệu sẵn sàng mua.

Bộ mặc định được lưu trong lần sử dụng đầu tiên. Chỉnh sửa bản xuất Markdown không thay đổi ứng dụng: hãy sửa thẻ lời nhắc hoặc khôi phục mặc định.

[Nội dung lời nhắc mặc định](https://docs.ai-softphone.com/vi/ai-processing/prompt-studio/index.md#standard-templates) · [Trợ lý có sẵn](https://docs.ai-softphone.com/vi/ai-processing/prompter/index.md#assistant-templates)
