Cốt lõi
Tương tác
Giám sát trực tiếp và
chiến dịch gọi ra.
Kết nối
Ứng dụng, API, máy chủ MCP và nhà cung cấp VoIP mà
tác nhân của bạn có thể sử dụng.
Chất lượng & Kiểm thử
Tổ chức
Sự kiện
Webhook và công cụ hàm cho
mã riêng của bạn.
Tổ chức
Một tổ chức là đơn vị thuê bao. 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 APIsk_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 đó 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 đó.
Trên dashboard: trình chuyển đổi tổ chức (cuối thanh bên) và
cài đặt Tổ chức — các tab Chung, Khóa, Cảnh báo, Cài đặt thanh toán
và Lịch sử thanh toán.
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. Cấu hình này 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 hành động cuộc gọi như chuyển cuộc gọi, nhấn phím và gác máy; đây là các dòng prompt thông thường thay vì cấu hình riêng biệt.
- Một cấp engine (
spark,bolt,storm-*): Spark được tối ưu về chi phí, Bolt về tốc độ, Storm về khả năng xử lý prompt phức tạp. - Một giọng nói cùng ngôn ngữ chính và các ngôn ngữ bổ sung tùy chọn — tác nhân tự động chuyển đổi khi người gọi đổ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 tùy chọn hành vi: thứ tự phát lời, chế độ xác nhận, âm thanh nền, thời gian chờ giữ máy.
/dashboard/agents). Xem
Xây dựng tác nhân AI giọng nói đầu tiên của bạn.
Trong API: /v1/agents — CRUD,
nhân bản, chuyển, lịch sử phiên bản và công cụ hỗ trợ prompt.
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 đến một tác nhân AI (và có thể thực hiện cuộc gọi đi). Có hai nguồn:- Số demo — số điện thoại Hoa Kỳ thật được cấp từ nhóm số của ThunderPhone, hoạt động trong vài giây. Chỉ hỗ trợ cuộc gọi đến, chúng trả lời bằng một thông báo miễn trừ ngắn được đọc thành lời, và dashboard giới hạn mỗi tổ chức ở 10 số. Phù hợp cho lần thử đầu tiên; không dành cho môi trường production.
- Số VoIP — được đưa 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 (Telnyx có thiết lập có hướng dẫn); SignalWire và Vonage sẽ sớm được hỗ trợ — hiện tại bạn kết nối với chúng qua cấu hình SIP thủ công, hỗ trợ mọi SIP trunk. Sau khi được nhập và xác minh, số VoIP hỗ trợ cuộc gọi đến và cuộc gọi đ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 bản chép lời đầy đủ có nhãn vai trò, lịch sử lượt hội thoại có cấu trúc (bao gồm lệnh gọi công cụ), bản ghi âm, tổng chi phí thanh toán, cùng tùy chọn chấm điểm AI và báo cáo sự cố. Khi một cuộc gọi đang diễn ra, bạn có thể mở cuộc gọi đó và nghe cùng — bạn tham gia im lặng và không ai trong cuộc gọi nghe thấy bạn. Sau khi nghe cùng, 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 dashboard: Lịch sử cuộc gọi (/dashboard/call-history) dành cho
kho lưu trữ và thông tin chi tiết từng cuộc gọi; Trực tiếp dành 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.
Tiện ích web
Tiện ích web mang đến cho khách truy cập trang web của bạn một cuộc trò chuyện qua micrô với tác nhân AI — không cần số điện thoại. Tiện ích xác thực bằng một khóa có thể công khai (pk_live_...) được khóa theo origin đối với
các miền được phép của bạn, vì vậy an toàn khi dùng trong mã phía client.
Khóa hoạt động ở một trong hai chế độ: agent (được liên kết tĩnh với một
tác nhân AI) hoặc webhook (server của bạn chọn cấu hình cho từng khách truy cập —
xem Cấu hình động cho từng cuộc gọi). Phiên tiện ích
đi qua cùng hạ tầng cuộc gọi như cuộc gọi điện thoại.
Trong dashboard: Tiện ích web (/dashboard/web-widgets) —
tạo tiện ích, đặt chế độ và tác nhân AI, quản lý 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
Một 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 giữa cuộc gọi để làm cơ sở cho câu trả lời — tải tệp trực tiếp hoặc nhập từ Google Drive, sau đó liên kết cơ sở kiến thức với một tác nhân AI trong trình tạo. Tác nhân AI truy vấn cơ sở kiến thức 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 dashboard: Kiến thức (/dashboard/knowledge) dành cho
thư viện tài liệu; phần Kiến thức trong trình tạo để liên kết cơ sở kiến thức
với tác nhân AI. Xem
Cung cấp cơ sở kiến thức cho tác nhân AI của bạn.
Kết nối
Kết nối là cách 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 (đăng tin nhắn Slack, tạo hoặc cập nhật 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 một hành động của tác nhân AI. Dán một lệnh cURL và trình hướng dẫn AI sẽ phác thảo định nghĩa công cụ, hoặc tự tạo thủ công; nút Kiểm tra yêu cầu sẽ gửi một lệnh gọi sandbox trước khi bạn triển khai. Xem Kết nối API — giao diện dashboard của/v1/integrations. - MCP (
/dashboard/mcp-connections) — thêm máy chủ Model Context Protocol bằng URL và để 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 để sử dụng số điện thoại của riêng bạn. Xem Kết nối nhà cung cấp VoIP.
/v1/integrations và
/v1/voip-connections; xem thêm
Tạo tích hợp công cụ.
Chiến dịch
Một chiến dịch thực hiện cuộc gọi đi trên quy mô lớn: tải lên CSV chứa liên hệ, chọn tác nhân AI và số gọi đi, rồi thiết lập khung giờ gọi (ngày và giờ, có hỗ trợ 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à các kết quả nào — không trả lời, hộp thư thoại, thất bại — sẽ được thử lại). Chiến dịch xử lý danh sách và ghi lại mọi cuộc gọi trong Lịch sử cuộc gọi. Trong dashboard: Chiến dịch (/dashboard/campaigns). Xem
Chạy chiến dịch gọi đi.
Đối với cuộc gọi lập trình một lần: 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 toàn 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 nhận lưu lượng thực đầu tiên, 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à một người gọi AI thực hiện cuộc trò chuyện thực với tác nhân AI của bạn — cùng tuyến viễn thông, 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 triển khai. Chỉ định một tác nhân AI hoặc một 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 AI (bao gồm các trường hợp biên, nếu bạn yêu cầu), và 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ử, trong đó cố đị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 mốc chuẩn đã được chấp nhận sẽ được báo cáo theo từng kịch bản. Trong dashboard: Mô phỏng (/dashboard/simulations), cùng với
nút Mô phỏng bên trong trình tạo tác nhân AI. Xem
Mô phỏng 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 AI từ đầu đến cuối.
Thử nghiệm
Một thử nghiệm kiểm thử A/B các cấu hình tác nhân AI 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à
tab A/B trong trình tạo tác nhân AI. Xem
Thử nghiệm (kiểm thử A/B).
Vấn đề
Một vấn đề là lỗi được đánh dấu trên một cuộc gọi cụ thể — do người đánh giá ghi nhận hoặc được phát hiện qua chấm điểm AI. Vấn đề có 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ó lỗi và theo dõi việc khắc phục. Trong dashboard: Vấn đề (/dashboard/issues), cùng với chức năng
đánh dấu 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 một bản phân tích do AI soạn, giới hạn theo các tác nhân AI và khoảng thời gian 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à khu vực 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 AI và khoảng thời gian, đồng thời hỗ trợ xuất dữ liệu để phân tích hạ nguồn. 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 suite) trong một khoảng thời gian và kích hoạt khi chỉ số đó vượt ngưỡng của bạn. Thông báo được gửi đến email và Slack, đồng thời kích hoạt sự kiệnalert.triggered đến
các endpoint 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ự kiện xảy ra trong và sau cuộc gọi. Có hai mô hình gửi:- Endpoint webhook (khuyến nghị): quản lý nhiều URL tại
/v1/developer/webhook-endpointsvới bí mật riêng cho từng endpoint và đăng ký sự kiện riêng cho từng endpoint. - Webhook URL đơn cũ: một URL cho mỗi tổ chức. Quản lý tại
/v1/webhookhoặc trong Tổ chức → Chung. Được giữ lại để tương thích ngược.
- 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). Bạn có tối đa 10 giây để phản hồi; nếu hết thời gian chờ, tác nhân AI được gán tĩnh sẽ xử lý cuộc gọi. - Sự kiện không chặn là thông báo gửi rồi bỏ qua, được thử lại với khoảng lùi theo cấp số nhân — xem ngữ nghĩa gửi.
X-ThunderPhone-Signature. Xem
Xác minh chữ ký.
Công cụ hàm
Một công cụ hàm là endpoint 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 schema hàm theo kiểu OpenAI cùng URL endpoint; tác nhân AI quyết định thời điểm gọi, và ThunderPhone thực hiện yêu cầu HTTP có chữ 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 bàn phím (DTMF), kết thúc cuộc gọi, chờ 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 xây dựng (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 của 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 sẽ trừ số dư theo đơn giá mỗi phút của tác nhân AI (cấp engine cộng phụ phí — trình tạo hiển thị trực tiếp đơn giá tổng khi bạn thay đổi cài đặt, và ngôn ngữ cao cấp cộng thêm 2¢/phút). Khi số dư về không, các cuộc gọi đến sẽ bị từ chối và các cuộc gọi đi sẽ 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 lại 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
Nạp tiền và bật tự động nạp tiền.
Trong API: /v1/billing.
Trợ lý đồng hành trong ứng dụng
Dashboard đi kèm trợ lý đồng hành tích hợp — hãy hỏi “làm thế nào để X” và trợ lý 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 nút đ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 nút điều khiển được đề cập trên trang này. Xem Hỏi trợ lý đồng hành trong ứng dụng.Tổng hợp
Bắt đầu nhanh với dashboard
Trình hướng dẫn năm bước: tác nhân AI → thanh toán → số điện thoại → mô phỏng → xem lại.
Bắt đầu nhanh với API
Cùng cuộc gọi đầu tiên trong bốn lệnh gọi REST.
Sử dụng dashboard
Tạo tác nhân AI, nạp tiền, lấy số điện thoại, mô phỏng và xem lại cuộc gọi.
Kết nối công cụ và dữ liệu
Ứng dụng OAuth, API tùy chỉnh, máy chủ MCP và nhà cung cấp VoIP.
Phân tích và cải thiện
Báo cáo, khả năng quan sát, thử nghiệm, sự cố và cảnh báo.
Nhóm và tài khoản
Lời mời và vai trò, khóa API, bảo mật và SSO.
Sổ tay công thức cho nhà phát triển
Các công thức API: cuộc gọi đến, cuộc gọi đi, cấu hình động, công cụ, kiểm thử.
Xác minh chữ ký webhook
Thiết lập kiểm tra HMAC đúng một lần và tái sử dụng ở mọi nơi.