--- title: "Tài liệu tham khảo về cài đặt tổ chức" description: "Quản lý một tổ chức ThunderPhone: hồ sơ, ngôn ngữ dashboard, thành viên, xác nhận gọi đi, người gọi bị chặn, webhook, SSO, khóa API, cảnh báo, thanh toán, giới hạn chi tiêu và lịch sử." --- Mở **Cài đặt tổ chức** (`/dashboard/organization`) để quản lý tổ chức đang hoạt động và tài khoản của riêng bạn. Cài đặt được chia thành sáu tab; vai trò của bạn xác định các tùy chọn bạn có thể thay đổi. ## Tài khoản của tôi Tab **Tài khoản của tôi** chứa các cài đặt dành cho người dùng đã đăng nhập, không phải toàn bộ tổ chức: - Tên, họ, email và URL ảnh đại diện. - Ngôn ngữ hiển thị trên bảng điều khiển. - Tải ứng dụng máy tính để bàn macOS. - Thêm, xác minh, liệt kê và xóa khóa truy cập. - Tùy chọn cookie. - Đăng xuất trên thiết bị hiện tại. Khi bạn đăng nhập thông qua SSO của tổ chức, nhà cung cấp danh tính quản lý email của bạn và email ở đây chỉ có thể xem. Xem [Tài khoản & bảo mật](/vi/guides/account-and-security) để biết quy trình chi tiết về khóa truy cập và hồ sơ. ## Chung ### Tuân thủ quy định về cuộc gọi đi Đối với các tổ chức áp dụng yêu cầu này, chủ sở hữu hoặc quản trị viên phải xem xét và ghi lại xác nhận một lần về cuộc gọi đi trước khi tác nhân AI có thể thực hiện cuộc gọi đi. Thành viên có thể thấy cần thực hiện hành động này nhưng không thể gửi xác nhận. Xem [Luật về cuộc gọi đi](/vi/guides/outbound-calling-laws). ### Báo cáo Múi giờ, giờ làm việc hằng tuần và số thử nghiệm riêng của tổ chức. Giờ làm việc quyết định cuộc gọi nào được tính là ngoài giờ trong số liệu báo cáo cuộc gọi trên Trang chủ, trong tab **Cuộc gọi** của từng tác nhân và trong Cổng thông tin khách hàng, cũng như trong bộ lọc **Giờ làm việc** tại Lịch sử cuộc gọi. Khi không chọn ngày nào, cuộc gọi ngoài giờ không được theo dõi và mọi cuộc gọi đều được tính là trong giờ làm việc. Các cuộc gọi từ hoặc đến số thử nghiệm được loại khỏi mọi số liệu báo cáo, danh sách cổng thông tin, số liệu Tổng quan và tệp xuất CSV; không thể mở các cuộc gọi này trong cổng thông tin. Một tác nhân có thể có múi giờ và giờ làm việc riêng trong mục **Báo cáo** của trình tạo tác nhân; các thiết lập này chỉ áp dụng cho cuộc gọi của tác nhân đó. Chủ sở hữu và quản trị viên thay đổi các thiết lập này tại **Chung → Báo cáo**. Chọn múi giờ và đánh dấu từng ngày làm việc, rồi nhập giờ mở cửa và đóng cửa. Trong **Số thử nghiệm**, nhập từng số và chọn **Thêm**. Sau đó chọn **Lưu cài đặt báo cáo**. Cho đến khi một múi giờ được lưu, báo cáo sử dụng UTC; trang đề xuất múi giờ của trình duyệt dưới dạng thay đổi chưa lưu. Khi đã thiết lập bất kỳ giờ làm việc nào, các ngày không được chọn sẽ được tính là ngoài giờ đối với các cuộc gọi sử dụng lịch đó. #### Cấu hình báo cáo qua API Chủ sở hữu và quản trị viên có thể `PATCH /v1/orgs/{id}/` với `timezone`, `business_hours` và `excluded_numbers`: - `timezone`: tên múi giờ IANA, chẳng hạn như `America/Los_Angeles`, tối đa 64 ký tự. - `business_hours`: khóa ngày trong tuần từ `mon` đến `sun`, mỗi khóa là danh sách tối đa bốn khung giờ `{start, end}` theo định dạng 24 giờ `HH:MM`, trong đó mỗi thời điểm kết thúc phải muộn hơn thời điểm bắt đầu. `{}` nghĩa là không phân tách ngoài giờ. - `excluded_numbers`: tối đa 50 số điện thoại, được lưu ở định dạng E.164. Một số Bắc Mỹ gồm 10 chữ số không có mã quốc gia sẽ được thêm mã quốc gia `+1`. ```bash curl -X PATCH https://api.thunderphone.com/v1/orgs/42/ \ -H "Authorization: Bearer sk_live_YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "timezone": "America/Los_Angeles", "business_hours": { "mon": [{"start": "09:00", "end": "17:00"}], "sat": [{"start": "10:00", "end": "14:00"}] }, "excluded_numbers": ["+14155550199"] }' ``` ### Người gọi bị chặn Các số trong danh sách này không thể liên hệ với tác nhân của bạn. Khi một số bị chặn gọi đến bất kỳ số điện thoại nào của tổ chức, ThunderPhone sẽ ngắt cuộc gọi trước khi tác nhân trả lời và không tính phí cuộc gọi. Cuộc gọi vẫn xuất hiện trong Lịch sử cuộc gọi, dưới dạng cuộc gọi đến thất bại với lý do kết thúc **Người gọi bị chặn**. Các cuộc gọi có ID người gọi bị ẩn hoặc ẩn danh sẽ không bao giờ được đối chiếu, và các cuộc gọi đi đến số bị chặn không bị ảnh hưởng. Người gọi bạn chặn trong khi đang gọi sẽ không bị ngắt ngay; việc chặn áp dụng từ cuộc gọi tiếp theo của họ. Mọi thành viên đều có thể xem danh sách; chủ sở hữu và quản trị viên thay đổi danh sách này tại **Chung → Người gọi bị chặn**: - Để chặn một số, nhập số đó kèm ghi chú tùy chọn và chọn **Chặn số**. Dùng `+` và mã quốc gia; định dạng nội địa như `(415) 555-0123` cũng hoạt động khi tất cả số điện thoại của tổ chức đều ở cùng một quốc gia. - Để chặn nhiều số cùng lúc, chọn **Dán danh sách**, dán tối đa 500 số (mỗi số trên một dòng hoặc được phân tách bằng dấu phẩy) rồi gửi. Kết quả hiển thị số lượng đã được thêm, đã bị chặn hoặc không hợp lệ, đồng thời liệt kê các mục không hợp lệ. - Để bỏ chặn một số, chọn **Xóa** trên hàng của số đó và xác nhận. Bạn cũng có thể mở một cuộc gọi đến trong **Lịch sử cuộc gọi** và chọn **Chặn người gọi này**. Một tổ chức có thể chặn tối đa 10.000 số. Để quản lý danh sách qua API, xem [Người gọi bị chặn](/api-reference/blocked-callers). ### Danh tính và thành viên tổ chức Thẻ tổ chức hiển thị ID tổ chức, vai trò thành viên của bạn và tên tổ chức có thể chỉnh sửa. Thẻ nhóm kết hợp thành viên đang hoạt động và lời mời đang chờ. | Vai trò | Quyền truy cập điển hình | | --- | --- | | **Thành viên** | Xây dựng và vận hành tác nhân AI, đồng thời xem lại cuộc gọi. | | **Quản trị viên** | Quyền truy cập của Thành viên cùng với quản trị nhóm, khóa, cổng thông tin, kết nối, cảnh báo, thanh toán và bảo mật. | | **Chủ sở hữu** | Quyền truy cập của Quản trị viên cùng với các hành động tổ chức ở cấp chủ sở hữu. | Chủ sở hữu và quản trị viên có thể mời **Thành viên** hoặc **Quản trị viên**, thu hồi lời mời đang chờ, thay đổi vai trò của thành viên đủ điều kiện và xóa thành viên. Lời mời được gắn với từng địa chỉ email và hết hạn sau bảy ngày. Xem [Mời nhóm của bạn](/vi/guides/invite-your-team). Khu vực nguy hiểm cho phép người dùng đủ điều kiện rời tổ chức hoặc xóa vĩnh viễn tổ chức đó. Việc xóa sẽ loại bỏ tác nhân AI, số điện thoại, lịch sử cuộc gọi và dữ liệu thanh toán của tổ chức và không thể hoàn tác. Để xóa tài khoản của riêng bạn, mở tab **Tài khoản** và chọn **Xóa tài khoản**. Hộp thoại liệt kê các tổ chức sẽ bị xóa (những tổ chức mà bạn là thành viên duy nhất) và các tổ chức bạn sẽ rời khỏi. Các khóa API do bạn tạo trong tổ chức bạn rời khỏi sẽ bị thu hồi. Việc xóa bị chặn khi bạn là chủ sở hữu duy nhất của một tổ chức có thành viên khác (trước tiên hãy đặt người khác làm chủ sở hữu), khi bạn đã tạo giọng nói tùy chỉnh trong một tổ chức vẫn được giữ lại, khi một cuộc gọi đang diễn ra hoặc khi có lệnh giữ pháp lý; hộp thoại sẽ liệt kê mọi yếu tố đang chặn việc xóa. Không thể hoàn tác. ### Webhook mặc định Đặt một URL webhook cũ để nhận sự kiện từ tất cả tiện ích web và số điện thoại trong tổ chức. Đối với bí mật theo từng điểm cuối, gói đăng ký, lịch sử gửi và lần thử lại, hãy sử dụng [điểm cuối webhook](/vi/webhooks/endpoints) được đề xuất. ### SSO doanh nghiệp Cấu hình một hoặc nhiều kết nối SSO, miền email được phép, cấp phát đúng lúc, vai trò mặc định và ánh xạ tùy chọn từ nhóm sang vai trò. Chính sách bảo mật có thể yêu cầu SSO, cho phép quản trị viên truy cập bằng mật khẩu trong trường hợp khẩn cấp và yêu cầu khóa truy cập để truy cập tổ chức. Xem [SSO](/vi/guides/sso). ## Khóa Tab **Khóa** quản lý các khóa API máy chủ bí mật `sk_live_`. Mỗi hàng hiển thị tên, tiền tố, trạng thái hoạt động/đã thu hồi, thời điểm tạo, lần sử dụng gần nhất và thời điểm thu hồi. Bí mật đầy đủ chỉ được hiển thị một lần, ngay sau khi tạo. Hãy sao chép khi đó và lưu trong trình quản lý bí mật. Việc thu hồi là vĩnh viễn và sẽ dừng mọi tích hợp sử dụng khóa đó. Xem [Khóa API](/vi/guides/api-keys). Khóa có thể công khai `pk_live_` thuộc về **Tiện ích web**, vì chúng là thông tin xác thực trình duyệt bị giới hạn theo nguồn thay vì khóa máy chủ. ## Cảnh báo Tạo quy tắc chỉ số cho tỷ lệ thành công, tỷ lệ thất bại, điểm trung bình, lượng cuộc gọi hoặc hồi quy bộ kiểm thử. Một quy tắc bao gồm: - Toán tử so sánh và ngưỡng số. - Cửa sổ đánh giá từ 1 đến 720 giờ. - Tối đa 10 người nhận email. - URL webhook đến Slack tùy chọn. - Gửi webhook dành cho nhà phát triển tùy chọn. - Thời gian chờ theo số phút nguyên và trạng thái bật. Cùng tab này cũng liệt kê các lần kích hoạt gần đây. Xem [Cảnh báo](/vi/guides/alerts). ## Cài đặt thanh toán Quản lý số dư tổ chức và hành vi thanh toán: - Thêm hoặc thay thế thẻ thanh toán mặc định. - Thêm tiền theo cách thủ công. - Bật nạp tiền tự động và đặt ngưỡng cùng số tiền nạp. - Đặt hoặc xóa giới hạn chi tiêu hàng tháng. Giới hạn hàng tháng tạm dừng cuộc gọi mới và việc sử dụng khi đạt 100% và vẫn có hiệu lực ngay cả khi nạp tiền tự động đang tắt. Xem [Giá](/vi/guides/pricing) và [Thanh toán và nạp tiền](/vi/guides/billing-and-topups). ## Lịch sử thanh toán Dùng **Lịch sử thanh toán** để kiểm tra số dư và chi tiêu trong Hôm nay, 7 ngày, 30 ngày, 90 ngày hoặc toàn bộ thời gian. Bao gồm: - Xu hướng số dư. - Cơ cấu thanh toán theo phí cuộc gọi, báo cáo, phí số điện thoại và nạp tiền. - Chi tiêu cao nhất theo tác nhân AI. - Bảng giao dịch với ngày, danh mục, mô tả, loại, số tiền và số dư sau giao dịch. - Lọc theo danh mục và xuất lịch sử đang hiển thị dưới dạng CSV hoặc JSON. Bảng điều khiển sẽ thông báo khi chỉ hiển thị các giao dịch gần đây nhất; các hàng cũ hơn vượt quá giới hạn đó cũng không có trong tệp xuất. [Billing API](/api-reference/billing) hỗ trợ phân trang theo chương trình.