Help Center/ Cognitive Engagement Center/ API Reference/ Chatbot Management Interface Reference/ Statistics Report Interfaces/ Interface for Querying Chatbot Report Information
Updated on 2025-03-31 GMT+08:00
View PDF
Share

Interface for Querying Chatbot Report Information

Interface Method

POST

URL

https://IP:PORT/oifde/rest/api/queryChatbotReport

Request

Table 1 Parameters in the request body

Parameter

Type

Position

Mandatory

Description

type

String

Body

Yes

Query type.

  • hour: report data on a specified date, which is queried by hour.
  • day: report data of the last 30 days, which is queried by day.

tenantId

String

Body

Yes

Tenant ID.

accessCode

String

Body

Yes

Access ID (robot access code).

timestamp

Long

Body

Yes

Millisecond timestamp of the query date.

authToken

String

Body

Yes

Authentication token.

For details, see C3 OIAP Interface Authentication.

Response

Parameter

Type

Position

Mandatory

Description

-

ChatbotReportRes[]

Body

Yes

Robot report information.
Table 2 ChatbotReportRes

Name

Mandatory

Type

Description

recordTime

Yes

Long

Millisecond timestamp of the record date.

tenantId

Yes

String

Tenant ID.

accessCode

Yes

String

Access ID (robot access code).

type

Yes

String

Query type.

  • hour: query by hour.
  • day: query by day.

consultCount

Yes

Integer

Total number of replies from the robot.

responseSuccessCount

Yes

Integer

Number of successful replies from the robot.

unknowCount

Yes

Integer

Number of unknown replies from the robot.

responseRate

Yes

String

Reply success rate.

feedbackCount

Yes

Integer

Number of evaluations.

Number of customers who participate in the satisfaction survey.

positiveFeedbackCount

Yes

Integer

Satisfied feedback.

Amount of satisfactory feedback from customers in the satisfaction survey.

positiveFeedbackRate

Yes

String

Satisfaction rate.

  • –1.0000: The value of feedbackCount is 0.
  • 0–1.0000: Satisfaction rate = positiveFeedbackCount/feedbackCount

Example

  • Request 
    {
    "tenantId":"202104237142",
    "accessCode":"950964151029600256",
    "timestamp":1630512000000,
    "type":"hour",
    "authToken":"E***********************"
}
  • Response 
    [
    {
        "tenantId":"202104237142",
        "accessCode": "950964151029600256",
        "recordTime": 1630580400000,
        "type": "hour",
        "consultCount": 1,
        "responseSuccessCount": 0,
        "unknowCount": 1,
        "responseRate": "0.0000",
        "feedbackCount": 0,
        "positiveFeedbackCount": 0,
        "positiveFeedbackRate": "-1.0000"
    }
]