Skip to main content
Khi một cuộc gọi điện thoại đến một số chưa được gán tác nhân, hoặc một phiên widget web bắt đầu trên một publishable key ở mode="webhook", ThunderPhone gửi một yêu cầu telephony.incoming / web.incoming chặn đến URL webhook cũ của bạn và chờ tối đa 10 giây để nhận phản hồi cấu hình. Sử dụng trao đổi này để chọn động prompt, giọng nói và công cụ cho từng cuộc gọi — xem hướng dẫn cấu hình cuộc gọi động để biết quy trình đầy đủ.
Các endpoint webhook đã đăng ký cũng nhận telephony.incoming / web.incoming — cho mọi cuộc gọi đến và phiên web, dù có cấu hình tác nhân hay không — nhưng các lần gửi đó là thông báo gửi rồi bỏ qua kèm event_id, không bao giờ chặn. Chỉ webhook URL đơn cũ mới thực hiện trao đổi cấu hình trên trang này. Cấu trúc thông báo endpoint nằm trong danh mục sự kiện.
Trao đổi chặn không có phương án dự phòng: nếu handler của bạn trả về trạng thái không phải 2xx, hết thời gian chờ hoặc trả về cấu hình không vượt qua xác thực, cuộc gọi sẽ bị từ chối (cuộc gọi điện thoại không kết nối; yêu cầu phiên widget thất bại với 502/422). Phản hồi nhanh — người gọi đang nghe âm báo đổ chuông trong khi bạn quyết định.

Payload yêu cầu

Đối với cuộc gọi điện thoại (telephony.incoming):
Đối với phiên widget web (web.incoming), data xác định trang nhúng thay vì số điện thoại:
Widget ở chế độ webhook gửi yêu cầu này đến webhook_url riêng của publishable key khi được thiết lập, nếu không sẽ dùng URL webhook cấp tổ chức. Dù bằng cách nào, yêu cầu cũng được ký bằng secret webhook của tổ chức.

Lược đồ phản hồi

Trả về một đối tượng JSON mô tả cấu hình tác nhân cho cuộc gọi này. promptvoice là bắt buộc; mọi trường khác là tùy chọn.
Các khóa cấp cao nhất không xác định sẽ bị bỏ qua một cách im lặng — tên trường bị gõ sai không khiến cấu hình bị từ chối, mà chỉ không được áp dụng. Thứ tự phát và max_hold_seconds không được chấp nhận ở đây; chúng chỉ có thể được cấu hình trên chính Tác nhân.
promptvoice là bắt buộc, việc trả về {} hoặc bất kỳ phản hồi nào không vượt qua xác thực sẽ từ chối cuộc gọi với 422 — không có phương án dự phòng tác nhân tĩnh trên đường dẫn này (một số điện thoại hoặc khóa ở chế độ webhook không có tác nhân được gán).

Trình xử lý mẫu


Phản hồi kèm công cụ hàm

Đính kèm công cụ để tác nhân AI có thể gọi API của bạn trong khi hội thoại:
Yêu cầu đến endpoint công cụ được ký bằng cùng secret webhook của tổ chức đã ký exchange này. Xem Công cụ hàm để biết cấu trúc chính xác và định dạng yêu cầu đã ký.

Bảng tóm tắt cấp sản phẩm


Liên quan

telephony.complete / web.complete

Sự kiện kết thúc cuộc gọi không chặn.

Công cụ hàm

JSON schema đầy đủ cho tools[] và hợp đồng endpoint đã ký.

Endpoint webhook

Đăng ký nhiều URL cho telephony.incoming / web.incoming.

Cấu hình cuộc gọi động

Mẫu cho prompt, công cụ và kiểm thử A/B theo từng người gọi.