- Điểm cuối webhook nhận
telephony.complete(cuộc gọi điện thoại) hoặcweb.complete(cuộc gọi web và cuộc gọi thử nghiệm mic trong builder) với payload ổn định được mô tả bên dưới,event_idcho mỗi lần gửi, thời gian chờ 30 giây và thử lại trong tối đa 24 giờ. - Webhook URL đơn cũ nhận một lần thử đồng bộ (thời gian chờ 10 giây, không thử lại) với payload hơi khác — xem Khác biệt của payload cũ.
Payload yêu cầu (gửi đến điểm cuối)
Lý do kết thúc
Định dạng bản ghi
Mỗi mục trongtranscripts là một lượt hội thoại. Các vai trò gồm
user (lời nói của người gọi), model (lời nói của tác nhân AI và lệnh gọi công cụ),
tool (kết quả công cụ) và system (sự kiện cuộc gọi như chuyển đổi
ngôn ngữ).
Để xem lịch sử lượt đầy đủ có cấu trúc (bao gồm điểm đánh dấu ngắt,
ack-prompt và vị trí thô), hãy dùng
GET /v1/calls/{call_id}/history.
Khác biệt của payload cũ
Envelope webhook cũ dùng một URL là{"type": "telephony.complete" | "web.complete", "data": {…}}, không có
event_id, và data của nó khác với payload endpoint:
- Mảng lượt nằm trong
history, không phảitranscripts(cùng schema lượt như trên). - Tập trường là báo cáo thô khi kết thúc cuộc gọi và có thể bao gồm các trường nội bộ bổ sung ngoài bảng trên — hãy coi các trường không xác định là thông tin tham khảo.
- Cuộc gọi web (
direction: "web") bỏ quafrom_number/to_numbervà thêmorigin_domain. - Cuộc gọi kiểm tra mic trong Builder được báo cáo là
telephony.completetrên đường dẫn cũ (hệ thống endpoint ánh xạ chúng thànhweb.complete). - Điều phối chuyển cuộc gọi: khi một cuộc gọi kết thúc bằng việc chuyển cuộc gọi,
webhook cũ được gọi đồng bộ và có thể trả về
{"transfer_ready": false}để báo hiệu mục tiêu nhận chuyển cuộc gọi chưa sẵn sàng. Bất kỳ phản hồi nào khác (hoặc không có webhook cũ) đều cho phép việc chuyển cuộc gọi tiếp tục. Các lần phân phối endpoint không bao giờ được tham vấn cho việc này.
Ví dụ về handler
Trường hợp sử dụng phổ biến
Tích hợp CRM
Lưu transcript và URL bản ghi của từng cuộc gọi cùng với hồ sơ khách hàng của bạn.
Phân tích
Truyền transcript vào pipeline để lập mô hình chủ đề, trích xuất tín hiệu CSAT hoặc theo dõi tỷ lệ chuyển cuộc gọi.
Đánh giá chất lượng
Mở cuộc gọi trong công cụ QA để con người đánh giá hoặc chạy qua mô hình đánh giá riêng của bạn.
Thông báo
Kích hoạt một thành viên trong nhóm khi chuyển cuộc gọi / xảy ra lỗi.
Liên quan
telephony.incoming / web.incoming
Đối tác chặn chạy khi cuộc gọi bắt đầu.
Danh mục sự kiện
Các loại sự kiện khác mà bạn có thể đăng ký.
API lịch sử cuộc gọi
Dữ liệu tương tự có thể truy cập qua REST để bổ sung dữ liệu / phát lại.