Bạn sẽ cần một tài khoản ThunderPhone.
Đăng ký miễn phí và mất chưa đến một phút. Bạn thích nhấp chuột hơn dùng curl?
Hướng dẫn nhanh trên bảng điều khiển giúp bạn thực hiện
cùng cuộc gọi đầu tiên mà không cần viết mã.
Bước 1: Lấy khóa API
1
Đăng nhập
2
Đi đến Khóa
Vào Tổ chức → Khóa trong bảng điều khiển.
3
Tạo khóa
Nhấp vào Tạo khóa, đặt tên cho khóa rồi sao chép giá trị
sk_live_.... Khóa thô chỉ hiển thị một lần duy nhất — hãy lưu
ngay vào trình quản lý bí mật của bạn.sk_live_YOUR_API_KEY bằng giá trị
bạn vừa sao chép. Khóa tự động xác định tổ chức của bạn, vì vậy
bạn không bao giờ cần thêm id tổ chức vào URL.
Bước 2: Tạo tác nhân
Một tác nhân xác định cách AI xử lý hội thoại — prompt, giọng nói, gói sản phẩm, công cụ và điều kiện đủ để dùng widget.Bước 3: Cấp một số điện thoại
Lệnh gọi này yêu cầu một số từ nhóm số demo của ThunderPhone và gán tác nhân AI mới của bạn làm trình xử lý cuộc gọi đến. (Để sử dụng số điện thoại của riêng bạn từ nhà cung cấp VoIP, hãy xem kết nối VoIP thay vào đó.)status="provisioning" và chuyển sang
active trong vài giây; đến khi bạn đóng trình duyệt,
số điện thoại đã sẵn sàng nhận cuộc gọi.
Bước 4 (tùy chọn): Thiết lập webhook
Để nhận sự kiện theo thời gian thực (định tuyến cuộc gọi động, xử lý sau cuộc gọi), hãy thêm một endpoint webhook. Chỉ đăng ký các sự kiện bạn cần.secret dùng một lần — hãy sao chép nó vào trình
quản lý secret của bạn. Dùng secret đó để xác minh header
X-ThunderPhone-Signature trên các yêu cầu đến (xem
tổng quan về Webhook).
Bước 5: Kiểm thử tác nhân AI
Gọi đến số điện thoại bạn vừa cấp. Tác nhân AI sẽ bắt máy, giới thiệu bản thân và làm theo prompt của bạn. Kiểm tra cuộc gọi sau khi kết thúc:Bước tiếp theo
Thêm công cụ hàm
Cho phép tác nhân AI gọi API của bạn trong cuộc trò chuyện.
Thực hiện cuộc gọi đi
Kích hoạt cuộc gọi từ mã của riêng bạn.
Xử lý webhook
Phản hồi các sự kiện cuộc gọi theo thời gian thực.
Tài liệu tham khảo API đầy đủ
Mọi endpoint công khai, đều được tài liệu hóa.