AlicomAgentCallReport - Call record

更新时间:
复制 MD 格式

You can subscribe to call record messages (AlicomAgentCallReport) from the Intelligent Communications Agent by using the batch HTTP push method. After a call completes, you receive details such as the caller and callee numbers, call start time, call end time, call duration, and real-time voice ASR duration.

Protocol

Category

Description

Protocol

HTTP + JSON

Encoding

UTF-8

Request

The request payload is a JSON array.

  • Request example

    [{
      "taskId": "1181**************",
      "detailId": "9662*************",
      "batchId": "B202******",
      "callId": "10000161****^1000018****",
      "outId": "123456",
      "startTime": "2025-06-01 10:00:00",
      "endTime": "2025-06-01 10:05:30",
      "duration": 330,
      "statusCode": "200010",
      "smartStatusCode": "ANSWERED",
      "statusMsg": "Call ended normally",
      "caller": "05710000*****",
      "realCaller": "0571********",
      "callee": "139********",
      "hangupDirection": "User",
      "originateTime": "2025-06-01 09:59:45",
      "ringTime": "2025-06-01 09:59:50",
      "bRingTime": "2025-06-01 09:59:52",
      "bStartTime": "2025-06-01 09:59:55",
      "bEndTime": "2025-06-01 10:05:25",
      "bDuration": 320,
      "bOriginateTime": "2025-06-01 09:59:48"
    }]
  • Parameters

    Parameter

    Type

    Example

    Description

    taskId

    String

    1181**************

    The task ID.

    detailId

    String

    9662*************

    The task detail ID.

    batchId

    String

    B202******

    The task batch ID.

    callId

    String

    10000161****^1000018****

    The call ID.

    outId

    String

    123456

    Contains the outId that you provided in the initial call request.

    startTime

    String

    2025-06-01 10:00:00

    The time the callee answered the call. This field is null if the call was not answered. Format: yyyy-MM-dd HH:mm:ss.

    endTime

    String

    2025-06-01 10:05:30

    The time the call ended. This field is null if the call did not connect. Format: yyyy-MM-dd HH:mm:ss.

    duration

    Integer

    330

    The call duration in seconds. This value is 0 if the call did not connect.

    statusCode

    String

    200010

    The call result status code. For more information, see Call status codes.

    smartStatusCode

    String

    ANSWERED

    The smart call result status code. For more information, see Intelligent status codes.

    statusMsg

    String

    Call ended normally

    A description of the result.

    caller

    String

    05710000*****

    The service instance number.

    realCaller

    String

    0571********

    The actual caller number.

    callee

    String

    139********

    The callee number.

    hangupDirection

    String

    User

    The party that hung up. Valid values:

    • User

    • Machine

    originateTime

    String

    2025-06-01 09:59:45

    The time the voice service initiated the call to the carrier. Format: yyyy-MM-dd HH:mm:ss.

    ringTime

    String

    2025-06-01 09:59:50

    The time the caller starts hearing the ringback tone. This field is null if the callee's phone did not ring. Format: yyyy-MM-dd HH:mm:ss.

Response

  • Response example

    {
      "code": 0,
      "msg": "Success"
    }
  • Parameters

    Parameter

    Type

    Required

    Description

    Example

    code

    Number

    Yes

    The response code. A value of 0 indicates you successfully received the message.

    0

    msg

    String

    No

    The response message.

    Success

Note
  • Your endpoint must return an HTTP 200 status code to acknowledge receipt of the message. The system only verifies that the code in your response is a number and does not validate the content. If the service receives an HTTP status code other than 200 or the request times out, it will retry the push.

  • If your endpoint fails to process the message due to a system error, return an HTTP 5xx status code.

Push retries

If an initial delivery attempt fails, the service retries up to three more times at 1, 5, and 10-minute intervals. If all three retries fail, no further attempts are made.