Skip to main content
Hướng dẫn này sẽ chỉ cho bạn bốn lệnh gọi REST cần thiết để trả lời cuộc gọi điện đầu tiên bằng tác nhân AI.
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.
Gặp khó khăn? Tạo khóa API máy chủ hướng dẫn quy trình này chi tiết từng bước, và trợ lý đồng hành trong ứng dụng có thể làm nổi bật trực tiếp từng thành phần điều khiển cho bạn.
Trong toàn bộ hướng dẫn này, hãy thay 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.
Gói sản phẩm: spark được tối ưu cho chi phí, bolt cho tốc độ, và storm-base / storm-extra cho khả năng xử lý prompt phức tạp. Xem Tác nhân để biết phần so sánh đầy đủ.

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 đó.)
Số mới của bạn bắt đầu ở trạng thái 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.
Phản hồi chứa một 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:
Đi sâu vào một cuộc gọi cụ thể để lấy bản chép lời và URL bản ghi âm:

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.