Webhook

Webhook cuộc gọi

Nhận dữ liệu cuộc gọi từ Webhook

• Đối tác khai báo API để nhận dữ liệu cuộc gọi từ WEBHOOK trả về

• METHOD : POST

• Content-type : application/json

Webhook data khi cuộc gọi đã kết thúc

Truy cậu cấu hình tại :

{
  "answer_sec": 0, // Số giây trả lời
  "bill_sec": 7, // Thời lượng cuộc gọi , tính tiền 
  "bill_sec_forward_out": 0, 
  "call_out_price": 0, // Tổng tiền cuộc gọi
  "call_uuid": "1ec80cc5-3ef0-4c95-87db-6fa6a4ab8af1", // ID của cuộc gọi 
  "create_by": {
    "name": "create_default_by_tenant"
  },
  "created_date": 1747648633456, // Ngày tạo
  "customer": {
    "_id": "67c67c5e967b3044cf57d400",
    "full_name": "Dũng",
    "full_name_unsigned": "dung"
  },
  "destination_number": "919077274", // Số hotline
  "direction": "inbound", // Hướng gọi : inbound, outbound, local
  "disposition": "answered",
  "domain_fusion": "demo20",
  "duration": 8, // Tổng thời gian, tính từ khi có tín hiệu rung chuông
  "endby_name": "end_call_by_agent",
  "from_number": "919077274",
  "hangup_cause": "NORMAL_CLEARING",
  "hangup_cause_q850": 16,
  "hotline": "919077274", // Số hotline
  "is_auto_call": false,
  "is_have_forward_out": false,
  "is_same_network": false,
  "is_same_network_forward_out": false,
  "is_voicemail": false, // nếu cuộc này là voicemail ( chỉ có đối với cuộc gọi callbot)
  "ivr": "none",
  "note": "",
  "out_of_working_time": false,
  "phone_number": "0387118493", // số người gọi
  "provider": "viettel", // Nhà mạng số người gọi
  "provider_of_number": "",
  "record_seconds": 0,
  "send_num_retry": 1,
  "sip_hangup_disposition": "send_bye",
  "sip_number": "919077274",
  "sip_number_tags": [],
  "sip_user": "",
  "source_number": "0387118493", // số người gọi
  "state": "cdr",
  "tag": [],
  "tenant_id": "6391feada745be2a6aa18006",
  "time_end_call": 1747648633,
  "time_start_call": 1747648625, // Thời gian bắt đầu gọi 
  "time_start_to_answer": 1747648625,
  "to_number": "",
  "transaction_id": "1ec80cc5-3ef0-4c95-87db-6fa6a4ab8af1", // ID cuộc gọi
  "transfer_histories": [], // lịch sử cuộc gọi được chuyển tới những nhân viên ( extension) nào
  "user": [
    {
      "full_name": "create_default_by_tenant",
      "full_name_unsigned": "create_default_by_tenant"
    }
  ]
}

Webhook khi cuộc gọi đang diễn ra

• Gửi thông tin cuộc gọi đang diễn ra cho đối tác tích hợp

• Trạng thái gồm : ringing(Đổ chuông), answered (Kết nối) , hangup (Kết thúc)

{
  "to_number": "0387118493", // Số điện thoại khách hàng
  "created_time": 1747649416775, // Ngày khởi tạo cuộc gọi
  "extension": "0387118493",
  "unique_id": "49631f25-0316-4c1d-b4c7-076deec5c2a6",
  "hotline": "919077274", // Số hotline của doanh nghiệp
  "source": "webhookEvent",
  "date_time": 1747649418605, // Thời gian hook
  "from_number": "", // Số máy lẻ gọi
  "call_uuid": "49631f25-0316-4c1d-b4c7-076deec5c2a6", // Id cuộc gọi = transaction_id
  "phone_number": "",
  "state": "answered", //ringing : Đang kết nối; answered : Kết nối, hangup : Kết thúc 
  "device": "VSBC",
  "event_time": 1747649418535,
  "direction": "inbound" // outbound : Gọi ra, inbound : Gọi vào
}