Skip to main content
Sự kiện hoàn tất được kích hoạt sau khi mỗi cuộc gọi kết thúc — điện thoại đến, điện thoại đi, cuộc gọi web hoặc cuộc gọi thử nghiệm (phiên mic trong builder). Sự kiện này không chặn: phản hồi bằng bất kỳ mã 2xx nào. Sự kiện được gửi qua cả hai đường dẫn:

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 trong transcripts 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 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ải transcripts (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ỏ qua from_number / to_number và thêm origin_domain.
  • Cuộc gọi kiểm tra mic trong Builder được báo cáo là telephony.complete trên đường dẫn cũ (hệ thống endpoint ánh xạ chúng thành web.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.