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.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.prompt và voice 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.prompt và voice 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: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.