ThunderPhone v3 đã chính thức ra mắt.Tự đăng ký và sử dụng, chỉ từ 2¢/phút.Xem thông báo ra mắt

Using the dashboard

Rời ThunderPhone

Xuất tác nhân AI dưới dạng tệp mở, xây dựng lại trên LiveKit Agents, Pipecat, Vapi hoặc Retell bằng kỹ năng tác nhân lập trình, rồi tải xuống lịch sử cuộc gọi và bản ghi âm của bạn.

Bạn có thể rời ThunderPhone bất cứ khi nào bạn muốn. Mọi tác nhân AI đều có thể xuất dưới dạng gói zip gồm các tệp mở, miễn phí, và một kỹ năng giúp tác nhân AI lập trình của bạn xây dựng lại nó trên LiveKit Agents, Pipecat, Vapi hoặc Retell. Trang này trình bày những gì bạn có thể mang theo, cách xuất và những gì bạn cần thực hiện lại ở nền tảng khác.

Những gì bạn có thể mang theo

Nội dungCách thực hiện
Một tác nhân AI: hướng dẫn, công cụ, số chuyển cuộc gọi, bước, cài đặt, định tuyến số và webhookXuất tác nhân AI, một gói zip cho mỗi tác nhân AI
Tệp kiến thức của tác nhân AICó trong bản xuất tác nhân AI
Lịch sử cuộc gọi và bản chép lờiXuất cuộc gọi, tối đa 1.000 cuộc gọi mỗi yêu cầu
Bản ghi âmMột bản ghi âm mỗi yêu cầu, theo cuộc gọi
Số điện thoại tại nhà cung cấp của riêng bạnChúng chưa từng rời khỏi nhà cung cấp của bạn. Xem Số điện thoại

Xuất tác nhân

Trong Zeus

Mở tác nhân rồi chuyển đến phần cài đặt của tác nhân (Xử lý cuộc gọi trong trình chỉnh sửa tác nhân). Ở cuối trang, trong mục Xuất, sao chép hoặc xóa, chọn Xuất. Tệp zip sẽ được tải xuống máy tính của bạn.

Với API

cURL
curl 'https://api.thunderphone.com/v1/agents/12/export' \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY" \
  -o agent-12.zip

Tệp zip được tạo khi bạn yêu cầu. Bất kỳ ai có thể đọc tác nhân đều có thể xuất tác nhân đó. Kiến thức, số điện thoại và webhook chỉ được đưa vào khi thông tin xác thực có thể đọc chúng: token OAuth cần knowledge:read, numbers:read và integrations:read, còn webhook cũng cần quyền quản trị viên hoặc chủ sở hữu. Mọi phần bị bỏ qua đều được liệt kê trong omitted của manifest.json. API trả về 429 khi vượt quá 30 lượt xuất mỗi phút.

Tham số truy vấnMô tả
include_url_pathstrue giữ lại đường dẫn của từng URL trong bản xuất, chẳng hạn như endpoint của công cụ. Theo mặc định, mọi URL đều bị cắt chỉ còn máy chủ. Tên người dùng, mật khẩu và chuỗi truy vấn luôn bị xóa khỏi URL

Dùng include_url_paths=true khi bạn sắp xây dựng lại tác nhân ở nơi khác, vì tại đó cần các endpoint của công cụ. Không bật tùy chọn này cho bản sao bạn dự định chia sẻ.

Tệp zip chứa gì

TệpNội dung
manifest.jsonĐịnh dạng (thunderphone.agent-export/v1), nội dung được đưa vào và danh sách omitted nêu mọi nội dung bị bỏ qua cùng lý do
agent.jsonTác nhân theo dữ liệu mà GET /v1/agents/{agent_id} trả về, đã loại bỏ thông tin xác thực
prompt.mdHướng dẫn hiện hành
knowledge/index.json và các tệp bên cạnhKiến thức của tác nhân. Mỗi tài liệu là tệp gốc nếu có lưu tệp, nếu không là văn bản đã trích xuất
numbers.jsonCác số điện thoại được định tuyến đến tác nhân này, cả gọi vào và gọi ra, cùng mọi phiên bản hoặc biến thể được ghim
webhooks.jsonCác endpoint webhook thuộc phạm vi của tác nhân này, không bao gồm bí mật của chúng
README.mdNội dung của từng tệp

Tệp kiến thức lớn hơn 25 MB sẽ bị bỏ qua, cũng như mọi nội dung vượt quá 100 MB cho toàn bộ bản xuất. Mỗi mục đều được liệt kê trong manifest.json cùng endpoint để tải xuống, GET /v1/knowledge/documents/{document_id}/original.

Nội dung không bao giờ được đưa vào

  • Giá trị thông tin xác thực. Header của một công cụ chỉ được liệt kê theo tên. Giá trị header chỉ có thể ghi trong ThunderPhone: không có phản hồi API nào trả về chúng, nên bản xuất cũng không thể có. Bạn cần nhập lại chúng ở phía bên kia. Điều này áp dụng cho thông tin xác thực mà ThunderPhone lưu dưới dạng thông tin xác thực. Hướng dẫn và tệp kiến thức của bạn được sao chép chính xác như khi bạn viết hoặc tải lên, vì vậy nếu một khóa từng được dán vào prompt hoặc tài liệu, khóa đó sẽ nằm trong tệp zip. Hãy kiểm tra trước khi chia sẻ.
  • Lịch sử cuộc gọi và bản ghi. Chúng có bản xuất riêng; xem Lịch sử cuộc gọi và bản ghi.
  • Lịch sử phiên bản. Bản xuất chứa tác nhân ở trạng thái hiện hành. Các phiên bản trước vẫn được liệt kê tại GET /v1/agents/{agent_id}/versions.
  • Các tác nhân khác mà tác nhân này chuyển tiếp đến. Xuất từng tác nhân theo cùng cách.

Chuyển sang nền tảng khác

Skill migrate-off-thunderphone hướng dẫn coding agent của bạn trong quá trình chuyển đổi. Cài đặt skill của ThunderPhone:

npx skills add thunderphone/skills

Sau đó, yêu cầu coding agent của bạn chuyển một tác nhân AI khỏi ThunderPhone và nêu tên đích đến: LiveKit Agents, Pipecat, Vapi hoặc Retell. Skill này tải xuống bản xuất, hỏi bạn từng thông tin xác thực, xây dựng lại tác nhân AI từ ánh xạ dành cho đích đến đó và kiểm thử tại đó trước khi bất kỳ số nào được chuyển đi. Quá trình chuyển đổi chạy trong coding agent của bạn, bằng key của riêng bạn. ThunderPhone không bao giờ ghi vào tài khoản của bạn trên nền tảng khác.

Những nội dung được chuyển, dưới dạng tệp mà skill ánh xạ cho bạn:

  • Hướng dẫn, bao gồm hướng dẫn dùng chung và các bước.
  • Công cụ: cùng endpoint, phương thức và schema tham số. request_format của từng công cụ ghi lại cấu trúc body mà endpoint của bạn mong đợi.
  • Số chuyển cuộc gọi cùng cài đặt kết thúc cuộc gọi và bàn phím.
  • Tệp kiến thức.
  • Cài đặt hộp thư thoại, khoảng lặng và thời lượng cuộc gọi.
  • Những số mà tác nhân AI trả lời và dùng để thực hiện cuộc gọi.

Những nội dung bạn cần làm lại ở phía bên kia:

  • Nhà cung cấp giọng nói, mô hình ngôn ngữ và âm thanh. Bạn chọn các nhà cung cấp này tại đích đến. Không có gì đảm bảo một giọng nói, hoặc âm thanh của cuộc gọi, sẽ khớp.
  • Thông tin xác thực. Giá trị header của công cụ và secret webhook.
  • Điện thoại. Cách số điện thoại kết nối đến tác nhân AI được thiết lập khác nhau trên mỗi nền tảng.
  • Các bước và chuyển giao. Đích đến có tính năng luồng hoặc chuyển giao sẽ xây dựng lại chúng tại đó. Ở nơi khác, skill gộp các bước vào hướng dẫn và thông báo cho bạn.
  • Cài đặt ThunderPhone không có tương đương. Cài đặt thông minh, nghe và tốc độ phản hồi, công cụ email và tin nhắn tích hợp sẵn, cùng chấm điểm cuộc gọi, bản tóm tắt và nhãn kết quả sẽ không được chuyển trừ khi bạn xây dựng lại chúng.
  • Chữ ký request. ThunderPhone ký các request công cụ và webhook mà nó gửi. Nền tảng khác ký theo cách riêng, vì vậy một endpoint xác minh chữ ký ThunderPhone cần kiểm tra mới.
  • Kiểm thử. Kiểm thử tác nhân AI đã xây dựng lại tại đích đến trước khi chuyển một số điện thoại.

Giữ tác nhân AI ThunderPhone tại chỗ cho đến khi tác nhân AI mới vượt qua các kiểm thử của bạn. Đây là cách để bạn quay lại.

Số điện thoại

Chuyển số sau cùng, sau khi tác nhân AI mới vượt qua các kiểm thử.

  • Số điện thoại trên nhà mạng của riêng bạn (một kết nối VoIP) vẫn ở lại với nhà mạng đó. Trỏ số đến nền tảng mới trong console của nhà mạng. Sau đó chọn Phát hành trên số trong ThunderPhone và không tích Cũng hủy số này trong tài khoản … của tôi: số sẽ bị ngắt kết nối khỏi ThunderPhone và vẫn ở trong tài khoản nhà mạng của bạn. Qua API, phát hành số bằng DELETE /v1/phone-numbers/{phone_number_id}?confirm=true và không gửi release_at_provider.
  • Số điện thoại do ThunderPhone cung cấp. Liên hệ bộ phận hỗ trợ trước khi bạn phát hành một số muốn giữ lại. Việc phát hành số ThunderPhone là vĩnh viễn: số sẽ trở về nhóm số và có thể được cấp cho khách hàng khác.

Lịch sử cuộc gọi và bản ghi âm

Các nội dung này tách biệt với bản xuất tác nhân AI.

  • Cuộc gọi. GET /v1/calls/export trả về tối đa 1.000 cuộc gọi mỗi request dưới dạng CSV (metadata) hoặc JSON (kèm bản chép lời). Lọc theo agent_id và phân trang lịch sử bằng start_date và end_date. Header phản hồi X-Truncated có giá trị true khi có nhiều cuộc gọi khớp hơn số được trả về.
  • Bản ghi âm. GET /v1/calls/{call_id}/audio trả về URL tồn tại trong thời gian ngắn cho bản ghi âm của một cuộc gọi. Không có tính năng tải xuống hàng loạt bản ghi âm.
cURL
curl 'https://api.thunderphone.com/v1/calls/export?export_format=json&agent_id=12&start_date=2026-10-01T00:00:00Z&end_date=2026-11-01T00:00:00Z' \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY" \
  -o calls-2026-10.json

Chi phí

Không tốn gì. Xuất tác nhân, xuất cuộc gọi và tải xuống bản ghi đều miễn phí. ThunderPhone là dịch vụ trả theo mức sử dụng, không có phí thuê bao và không có phí theo chỗ ngồi. Một số ThunderPhone sẽ ngừng tính phí khi bạn giải phóng số đó.

Sau khi bạn rời đi

Không có thời hạn cố định. Bạn có thể chấm dứt thỏa thuận bằng thông báo bằng văn bản gửi đến legal@thunderphone.com, từ email quản trị của tài khoản hoặc một kênh xác minh được khác. Việc chậm thanh toán có thể khiến dịch vụ bị tạm ngừng; bản thân việc này không bao giờ chấm dứt thỏa thuận hoặc kích hoạt việc xóa Dữ liệu Khách hàng. Về dữ liệu, Điều khoản nêu: "Sau khi chấm dứt chính thức, Nhà cung cấp sẽ hoàn trả hoặc xóa Dữ liệu Khách hàng trong vòng sáu mươi (60) ngày, tùy thuộc vào quyền xuất dữ liệu của Khách hàng, chu kỳ sao lưu, yêu cầu lưu giữ pháp lý, việc lưu giữ theo yêu cầu pháp luật, DPA và mọi BAA đã được ký kết."

Toàn văn nằm trong Điều khoản Dịch vụ, mục Thời hạn dịch vụ; tạm ngừng; chấm dứt. Điều khoản có hiệu lực chi phối; đây là bản tóm tắt.

Liên quan