Khái niệm cốt lõi

Bản đồ về mọi thành phần trên nền tảng — mỗi đối tượng làm gì, nằm ở đâu trong bảng điều khiển và API nào tương tác với nó.

ThunderPhone là nền tảng hoàn chỉnh để xây dựng, vận hành và cải thiện tác nhân AI giọng nói. Trang này là bản đồ: mọi khái niệm bạn sẽ gặp, mỗi khái niệm có một phần ngắn, cùng giao diện bảng điều khiển và API hỗ trợ khái niệm đó. Hãy xem lướt một lần, rồi quay lại bất cứ khi nào cần làm rõ một thuật ngữ.

Thanh bên của bảng điều khiển phản ánh cấu trúc này:

Tổ chức#

Một tổ chức là đơn vị quản trị độc lập. Mọi tài nguyên khác — tác nhân, số điện thoại, cuộc gọi, khóa — đều thuộc chính xác một tổ chức. Tài khoản của bạn có thể thuộc nhiều tổ chức; mỗi tổ chức có số dư, khóa và danh sách thành viên riêng.

Khóa API sk_live_ bạn tạo trong Tổ chức → Khóa được liên kết với một tổ chức. Liên kết này giúp REST API có cấu trúc phẳng: bạn không bao giờ cần đặt ID tổ chức trong đường dẫn URL, vì khóa của bạn đã xác định tổ chức đó.

Trong bảng điều khiển: bộ chuyển đổi tổ chức (ở chân thanh bên) và cài đặt Tổ chức — các tab Tài khoản của tôi, Chung, Khóa, Cảnh báo, Cài đặt thanh toán và Lịch sử thanh toán. Xem tham chiếu cài đặt tổ chức.

Trong API: /v1/orgs, /v1/developer/api-keys.

Tác nhân#

Một tác nhân là cấu hình AI vận hành một cuộc gọi. Tác nhân bao gồm:

• Một prompt quy định tác nhân nói gì và hoạt động như thế nào — bao gồm các thao tác cuộc gọi như chuyển cuộc gọi, nhấn phím và kết thúc cuộc gọi, vốn là các dòng prompt thông thường thay vì cấu hình riêng biệt.
• Một cấp động cơ (spark, bolt, storm-*): Spark được tối ưu cho chi phí, Bolt cho tốc độ, Storm cho khả năng xử lý prompt phức tạp.
• Một giọng nói cùng ngôn ngữ chính và ngôn ngữ bổ sung tùy chọn — tác nhân tự động chuyển đổi khi người gọi thay đổi ngôn ngữ. Xem Ngôn ngữ được hỗ trợ.
• Các khả năng được gắn: ứng dụng đã kết nối, kết nối API, cơ sở kiến thức, máy chủ MCP và công cụ hàm nội tuyến.
• Các thiết lập hành vi: thứ tự nói, chế độ xác nhận, nhạc nền, thời gian chờ giữ máy.

Các chỉnh sửa trong trình tạo sẽ tự động lưu vào bản nháp; không có thay đổi nào được áp dụng cho đến khi bạn nhấp vào Triển khai. Mỗi lần triển khai đều được lưu ảnh chụp trong tab Lịch sử của trình tạo, để bạn có thể kiểm tra và khôi phục bất kỳ phiên bản trước đó nào.

Trong bảng điều khiển: Tác nhân AI giọng nói → trình tạo tác nhân (/dashboard/agents). Xem Xây dựng tác nhân AI giọng nói đầu tiên.

Trong API: /v1/agents — CRUD, nhân bản, chuyển, lịch sử phiên bản và trình hỗ trợ prompt.

Giọng nói#

Thư viện giọng nói chứa các giọng nói mà tác nhân AI có thể sử dụng, các mẫu có thể phát, ngôn ngữ tương thích, nhóm giới tính và giọng địa phương, cùng mọi phụ phí cho giọng nói/ngôn ngữ cao cấp. Trình nghe thử có tính phí có thể tổng hợp cụm từ riêng dài 1–500 ký tự của bạn trước khi chọn.

Các tổ chức đủ điều kiện cũng có thể tạo giọng nói tùy chỉnh từ một mẫu WAV hoặc MP3 ngắn. Giọng nói tùy chỉnh có hạn mức và trạng thái tạo không đồng bộ; khi sẵn sàng, chúng xuất hiện trong cùng bộ chọn tác nhân AI với các giọng nói trong thư viện.

Trong bảng điều khiển: Giọng nói (/dashboard/voices). Xem Thư viện giọng nói và giọng nói tùy chỉnh.

Trong API: /v1/voices, mẫu giọng nói, và giọng nói tùy chỉnh.

Số điện thoại#

Một số điện thoại thuộc về một tổ chức và định tuyến cuộc gọi đến tới một tác nhân AI (đồng thời có thể thực hiện cuộc gọi đi). Có hai nguồn:

• Số ThunderPhone — số điện thoại thật tại Hoa Kỳ được cấp từ kho số của ThunderPhone, hoạt động trong vài giây, $1/tháng cộng thêm 1¢/phút phụ phí. Ban đầu, chúng chỉ hỗ trợ cuộc gọi đến. Quản trị viên tổ chức có thể yêu cầu gọi đi từ trang Số điện thoại; ThunderPhone xem xét thủ công từng yêu cầu, và các số được phê duyệt có thể thực hiện cuộc gọi và chạy chiến dịch. Theo mặc định, một tổ chức có thể sở hữu 25 số.
• Số VoIP — được mang từ nhà cung cấp của bạn thông qua một kết nối VoIP. Twilio và Telnyx kết nối trực tiếp bằng khóa API (Telnyx cũng có quy trình thiết lập tài khoản mới có hướng dẫn); SignalWire, Vonage, Plivo và mọi SIP trunk khác kết nối thông qua thiết lập SIP, một cấu hình SIP thủ công. Sau khi được nhập và xác minh, số VoIP hỗ trợ cả cuộc gọi đến và gọi đi.

Mỗi hàng số điện thoại cho phép bạn đặt chế độ định tuyến, chọn tác nhân AI xử lý cuộc gọi đến và gắn nhãn cho số.

Trong bảng điều khiển: Số điện thoại (/dashboard/phone-numbers). Xem Lấy số điện thoại.

Trong API: /v1/phone-numbers, /v1/voip-connections, /v1/phone-number-labels.

Cuộc gọi#

Mọi cuộc gọi đến, cuộc gọi đi, mô phỏng và phiên tiện ích đều trở thành một nhật ký cuộc gọi. Một cuộc gọi chứa toàn bộ bản chép lời có gắn nhãn vai trò, lịch sử lượt trao đổi có cấu trúc (bao gồm các lệnh gọi công cụ), bản ghi âm, tổng phí và các báo cáo chấm điểm AI cũng như báo cáo sự cố tùy chọn.

Khi một cuộc gọi đang diễn ra, bạn có thể mở cuộc gọi và nghe — bạn tham gia trong im lặng và không ai trong cuộc gọi nghe thấy bạn. Sau khi bắt đầu nghe, bạn có thể thì thầm: nhập một chỉ dẫn được gửi thẳng đến tác nhân AI của bạn giữa cuộc gọi; người gọi không bao giờ nghe thấy chỉ dẫn đó, và tác nhân AI sẽ làm theo ngay trong cuộc gọi.

Trong bảng điều khiển: Lịch sử cuộc gọi (/dashboard/call-history) cho kho lưu trữ và thông tin chi tiết từng cuộc gọi; Trực tiếp cho các cuộc gọi đang diễn ra. Xem Xem lại, nghe và hướng dẫn cuộc gọi của bạn.

Trong API: /v1/calls — danh sách, bản chép lời, lịch sử, âm thanh, chấm điểm, xuất; /v1/issue-reports.

Cổng thông tin khách hàng#

Một cổng thông tin khách hàng là chế độ xem lịch sử cuộc gọi chỉ đọc, mang thương hiệu dành cho khách hàng bên ngoài. Quản trị viên tổ chức chọn các tác nhân AI có cuộc gọi sẽ hiển thị, thêm email người xem được phê duyệt, tải lên logo và màu nhấn, đồng thời có thể xác minh tên miền tùy chỉnh. Người xem cổng thông tin có thể kiểm tra thông tin chi tiết cuộc gọi, bản chép lời và các bản ghi âm có sẵn mà không được cấp quyền truy cập bảng điều khiển.

Trong bảng điều khiển: Cổng thông tin khách hàng (/dashboard/client-portals). Xem Cổng thông tin khách hàng.

Trong API: /v1/client-portals cho giao diện quản lý dành cho quản trị viên.

Tiện ích web#

Web widget mang đến cho khách truy cập trang web của bạn một cuộc trò chuyện qua mic với tác nhân AI — không cần số điện thoại. Widget xác thực bằng publishable key (pk_live_...) mà trình duyệt chỉ có thể sử dụng từ các miền bạn cho phép, nên an toàn khi dùng trong mã phía client. Danh sách miền không phải là cơ chế xác thực, và các cài đặt phiên mà một trang có thể gửi sẽ bị tắt cho đến khi bạn cho phép chúng trên key.

Khóa hoạt động ở một trong hai chế độ: agent (liên kết tĩnh với một tác nhân AI) hoặc webhook (máy chủ của bạn chọn cấu hình cho từng khách truy cập — xem Cấu hình động theo từng cuộc gọi). Phiên tiện ích đi qua cùng hạ tầng cuộc gọi như các cuộc gọi điện thoại.

Trong bảng điều khiển: Tiện ích web (/dashboard/web-widgets) — tạo tiện ích, đặt chế độ và tác nhân AI, quản lý các miền được phép, và sao chép đoạn mã nhúng. Xem Tạo tiện ích web.

Trong API: /v1/publishable-key, /v1/mic-session, và tài liệu Widget SDK.

Cơ sở kiến thức#

Cơ sở kiến thức là tập hợp tài liệu mà tác nhân AI của bạn có thể tìm kiếm trong khi gọi để làm căn cứ cho câu trả lời — tải tệp lên, dán văn bản hoặc nhập trang web bằng URL, sau đó gắn cơ sở kiến thức vào một tác nhân AI trong trình xây dựng. Tác nhân AI truy vấn cơ sở này bằng công cụ tìm kiếm tích hợp bất cứ khi nào cuộc trò chuyện cần đến.

Trong bảng điều khiển: Kiến thức (/dashboard/knowledge) dành cho thư viện tài liệu; mục Kiến thức trong trình xây dựng để gắn một cơ sở kiến thức vào tác nhân AI. Xem Cung cấp cho tác nhân AI của bạn một cơ sở kiến thức.

Kết nối#

Kết nối là cách các tác nhân AI tiếp cận thế giới bên ngoài. Bốn loại, một nhóm trên thanh bên:

• Ứng dụng (/dashboard/app-connections) — kết nối OAuth với Slack, HubSpot, Salesforce, Google Calendar, Google Sheets và Cal.com. Kết nối một lần, sau đó bật các công cụ theo từng thao tác (gửi tin nhắn Slack, cập nhật hoặc tạo liên hệ HubSpot, đặt lịch Cal.com…) cho bất kỳ tác nhân AI nào. Xem Kết nối ứng dụng.
• API (/dashboard/api-connections) — biến bất kỳ HTTP API nào thành hành động của tác nhân AI. Dán lệnh cURL và trình hướng dẫn AI sẽ soạn định nghĩa công cụ, hoặc tự xây dựng thủ công; nút Yêu cầu thử nghiệm thực hiện một cuộc gọi trong sandbox trước khi bạn triển khai. Xem Kết nối API — giao diện bảng điều khiển của /v1/integrations.
• MCP (/dashboard/mcp-connections) — thêm máy chủ Model Context Protocol bằng URL và cho phép tác nhân AI sử dụng các công cụ mà máy chủ cung cấp. Xem Thêm máy chủ MCP.
• VoIP (/dashboard/voip-connections) — thông tin xác thực nhà cung cấp để dùng số điện thoại của riêng bạn. Xem Kết nối nhà cung cấp VoIP.

ThunderPhone cũng cung cấp điểm cuối MCP riêng để một ứng dụng khách MCP bên ngoài có thể liệt kê tác nhân AI, kiểm tra cuộc gọi và bản chép lời, cũng như thực hiện cuộc gọi. Xem Dùng ThunderPhone làm máy chủ MCP.

Trong API: /v1/integrations, /v1/mcp-servers, và /v1/voip-connections; xem thêm Xây dựng tích hợp công cụ.

Chiến dịch#

Chiến dịch thực hiện các cuộc gọi đi ở quy mô lớn: tải lên CSV gồm các liên hệ, chọn tác nhân AI và số gọi đi, rồi đặt khung giờ gọi (ngày và giờ, có xét múi giờ), số cuộc gọi đồng thời và chính sách thử lại (số lần thử tối đa và kết quả nào — không trả lời, thư thoại, thất bại — được thử lại). Chiến dịch xử lý lần lượt danh sách và ghi lại mọi cuộc gọi trong Lịch sử cuộc gọi.

Trong bảng điều khiển: Chiến dịch (/dashboard/campaigns). Xem Chạy chiến dịch gọi đi.

Đối với các cuộc gọi lập trình một lần: dùng API cuộc gọi đi.

Giám sát trực tiếp#

Trực tiếp hiển thị mọi cuộc gọi đang diễn ra trong tổ chức và cho phép bạn mở bất kỳ cuộc gọi nào để nghe và thì thầm theo thời gian thực. Đây là giao diện giám sát: theo dõi prompt mới khi bắt đầu nhận lưu lượng thực tế hoặc giám sát một chiến dịch đang chạy.

Trong dashboard: Trực tiếp (/dashboard/live). Xem Theo dõi và giám sát cuộc gọi trực tiếp.

Mô phỏng#

Một mô phỏng là tác nhân AI gọi điện và thực hiện cuộc trò chuyện thực với tác nhân của bạn — cùng tuyến điện thoại, bản chép lời thực, chấm điểm thực — để bạn có thể kiểm thử trước (và sau) khi phát hành. Chỉ định tác nhân hoặc số điện thoại, tự viết kịch bản người gọi hoặc tạo kịch bản bằng AI từ prompt của tác nhân (bao gồm cả trường hợp biên nếu bạn yêu cầu), rồi theo dõi cuộc gọi trực tiếp.

Các kịch bản được nhóm thành bộ kiểm thử, quy định tỷ lệ đạt tối thiểu và có thể chặn bản phát hành trong CI; các hồi quy so với đường cơ sở đã được chấp nhận được báo cáo theo từng kịch bản.

Trong dashboard: Mô phỏng (/dashboard/simulations), cùng nút Mô phỏng trong trình tạo tác nhân. Xem Mô phỏng một cuộc gọi.

Trong API: /v1/test-calls và trình chạy bộ kiểm thử — xem Kiểm thử tác nhân đầu cuối.

Bộ xác thực#

Một bộ xác thực biến các thời điểm trong cuộc gọi thực thành các lần kiểm tra hồi quy một lượt có thể lặp lại. Mỗi ví dụ lưu cố định ngữ cảnh hội thoại, âm thanh người gọi liên quan, phản hồi gốc và hành vi mong đợi. Các lần phát lại chạy trên bản nháp tác nhân hiện tại mà không thực hiện thêm cuộc gọi nào, và hộp thoại triển khai có thể hiển thị liệu lần chạy mới nhất vẫn khớp với bản nháp đó hay không.

Trong dashboard: Bộ xác thực (/dashboard/validation) dành cho tập dữ liệu của tổ chức và thẻ Xác thực trong trình tạo tác nhân dành cho các lần chạy. Xem Bộ xác thực.

Trong API: /v1/validation-sets và các điểm cuối phát lại tác nhân/ví dụ trên cùng trang tham chiếu.

Thử nghiệm#

Một thử nghiệm kiểm thử A/B các cấu hình tác nhân trên lưu lượng thực: xác định các biến thể (prompt, engine hoặc cài đặt khác nhau), phân chia lưu lượng giữa chúng và so sánh kết quả theo từng biến thể. Dùng tính năng này thay vì tự xây dựng logic phân nhóm trong webhook.

Trong dashboard: Thử nghiệm (/dashboard/experiments) và thẻ A/B trong trình tạo tác nhân. Xem Thử nghiệm (kiểm thử A/B).

Vấn đề#

Một vấn đề là lỗi được gắn cờ trên một cuộc gọi cụ thể — do người đánh giá báo cáo hoặc được phát hiện qua chấm điểm AI. Vấn đề bao gồm mức độ nghiêm trọng, nguồn và trạng thái; trang Vấn đề là hàng đợi phân loại: lọc, kiểm tra cuộc gọi có vấn đề và theo dõi các bản sửa lỗi.

Trong dashboard: Vấn đề (/dashboard/issues), cùng tính năng gắn cờ theo từng cuộc gọi trong Lịch sử cuộc gọi. Xem Phân loại vấn đề.

Trong API: /v1/issue-reports.

Báo cáo#

Một báo cáo trả lời câu hỏi bằng ngôn ngữ tự nhiên về dữ liệu cuộc gọi của bạn ("Ba lý do hàng đầu khiến người gọi yêu cầu gặp người thật vào tuần trước là gì?") bằng phân tích do AI viết, giới hạn trong các tác nhân và khoảng ngày bạn chọn.

Trong dashboard: Báo cáo (/dashboard/reports). Xem Báo cáo.

Khả năng quan sát#

Khả năng quan sát là giao diện chỉ số: khối lượng cuộc gọi, kết quả và chất lượng theo thời gian, có thể lọc theo tác nhân và khoảng thời gian, đồng thời hỗ trợ xuất dữ liệu để phân tích tiếp theo.

Trong dashboard: Khả năng quan sát (/dashboard/observability). Xem Khả năng quan sát.

Cảnh báo#

Một quy tắc cảnh báo theo dõi một chỉ số (tỷ lệ thành công, tỷ lệ thất bại, điểm trung bình, khối lượng cuộc gọi, hồi quy của bộ kiểm thử) trong một khoảng thời gian và kích hoạt khi chỉ số vượt qua ngưỡng của bạn. Thông báo được gửi qua email và Slack, đồng thời kích hoạt sự kiện alert.triggered đến các điểm cuối webhook của bạn.

Trong dashboard: Tổ chức → Cảnh báo. Xem Cảnh báo.

Webhook#

ThunderPhone gửi webhook HTTP POST đến máy chủ của bạn khi các sự việc xảy ra trong và sau cuộc gọi. Có hai mô hình phân phối:

• Điểm cuối webhook (khuyến nghị): quản lý nhiều URL tại /v1/developer/webhook-endpoints với secret riêng cho từng điểm cuối và đăng ký sự kiện riêng cho từng điểm cuối.
• Webhook URL đơn cũ: một URL cho mỗi tổ chức. Quản lý tại /v1/webhook hoặc trong Tổ chức → Chung. Được giữ lại để tương thích ngược.

Sự kiện được chia thành hai loại:

• Sự kiện chặn yêu cầu máy chủ của bạn phản hồi bằng cấu hình định hình cuộc gọi đang diễn ra — các sự kiện cuộc gọi đến (telephony.incoming / web.incoming). Một cuộc gọi điện thoại chờ tối đa 13 giây, bao gồm một lần thử lại, và một phiên widget chờ 10 giây. Không có tác nhân dự phòng: nếu không có cấu hình dùng được, cuộc gọi điện thoại sẽ kết thúc và phiên widget sẽ thất bại.
• Sự kiện không chặn là các thông báo gửi đi mà không chờ phản hồi, được thử lại với thời gian chờ tăng theo cấp số nhân — xem ngữ nghĩa phân phối.

Mỗi yêu cầu đều mang chữ ký HMAC-SHA256 có dấu thời gian trong X-ThunderPhone-Signature-V2, cùng với chữ ký chỉ phần nội dung cũ X-ThunderPhone-Signature. Xem Xác minh chữ ký.

Công cụ hàm#

Công cụ hàm là một điểm cuối HTTP mà tác nhân AI của bạn có thể gọi giữa cuộc hội thoại. Bạn cung cấp cho ThunderPhone một lược đồ hàm theo kiểu OpenAI cùng URL điểm cuối; tác nhân AI quyết định khi nào cần gọi, và ThunderPhone gửi yêu cầu HTTP đã ký từ máy chủ của mình rồi chuyển kết quả lại cho tác nhân AI.

Tác nhân AI cũng có khả năng gọi tích hợp sẵn — chuyển cuộc gọi, gửi dữ liệu nhập bàn phím (DTMF), kết thúc cuộc gọi, chờ giữ máy — mà bạn bật bằng các dòng prompt đơn giản thay vì định nghĩa công cụ.

Trong dashboard: phần Kết nối API của trình tạo (xem Kết nối).

Trong API: /v1/integrations và đặc tả Công cụ hàm.

Nhóm và vai trò#

Mỗi tổ chức có danh sách thành viên với hai vai trò: Thành viên xây dựng và vận hành tác nhân AI; Quản trị viên cũng quản lý nhóm và thanh toán. Mời qua email — lời mời hết hạn sau 7 ngày và có thể bị thu hồi; menu ⋯ trên hàng thành viên dùng để thay đổi vai trò hoặc xóa một người. Đăng nhập một lần có thể được cấu hình cho toàn tổ chức — xem SSO.

Trong dashboard: Tổ chức → Chung. Xem Mời nhóm của bạn.

Trong API: /v1/members, /v1/invites.

Thanh toán#

ThunderPhone là dịch vụ trả trước. Mỗi tổ chức có số dư USD; các cuộc gọi trừ số dư theo mức phí mỗi phút của tác nhân AI (gói engine cộng phụ phí — trình tạo hiển thị mức phí trọn gói theo thời gian thực khi bạn thay đổi cài đặt, và các ngôn ngữ bổ sung được chọn cộng thêm 3¢/phút). Khi số dư bằng không, cuộc gọi đến bị từ chối và cuộc gọi đi trả về 402 Payment Required.

Nạp tiền thủ công hoặc bật tự động nạp tiền với ngưỡng số dư, số tiền nạp và giới hạn chi tiêu hằng tháng tùy chọn — để cuộc gọi không bao giờ bị ngắt giữa câu.

Trong dashboard: Tổ chức → Cài đặt thanh toán và Lịch sử thanh toán. Xem Thêm tiền và bật tự động nạp tiền, cùng tài liệu tham khảo đầy đủ về giá.

Trong API: /v1/billing.

Copilot trong ứng dụng#

Dashboard có copilot tích hợp sẵn — hãy hỏi "làm thế nào để X" và copilot sẽ trả lời dựa trên tài liệu này, cung cấp hướng dẫn từng cú nhấp làm nổi bật các điều khiển thực tế, đồng thời có thể phát lại bất kỳ Tour hướng dẫn nào. Đây là cách nhanh nhất để tìm một điều khiển được đề cập trên trang này. Xem Hỏi copilot trong ứng dụng.

Kết hợp mọi thứ#