Updated on 2023-09-27 GMT+08:00

Handshake

Description

This interface is used by a third-party client to send heartbeat messages to the CTI platform of the call center to remain the validity of a subscription task. If the CTI platform of the call center does not detect any heartbeat message within five minutes, it invalids the subscription task. Then the client needs to send a subscription request to the CTI platform of the call center again.

It is recommended that a third-party business client send a heartbeat message to the CTI platform of the call center every two minutes.

Interface Method

This interface supports only the GET method.

URI

https://IP:Port/agentgateway/resource/config/subscribe/handshake/{serviceid}

Table 1 Parameter in the URI

Parameter

Data Type

Mandatory (Yes/No)

Description

serverid

string

Yes

ID of an existing subscription task on the CTI platform, that is, subscription task ID returned by the CTI platform to a third-party business client upon successful subscription.

This parameter cannot be left empty or set to null.

Method Name in Logs

handshake

Request Message

  • Message header
    Table 2 Parameters in the message header

    No.

    Parameter

    Value Type

    Mandatory

    Description

    1

    Content-Type

    string

    Yes

    Coding mode of the message body. The default value is application/json; charset=UTF-8.

    2

    Guid

    string

    Yes

    The value of Guid is that returned through the interface in C5 Intelligent Auxiliary Interface Authentication.

Response Message

Table 3 Parameters in the message body

No.

Parameter

Value Type

Description

1

message

string

Returned message.

2

retcode

string

Result cause code.

The value is an integer.

Example

  • Message header
    Content-Type:application/json; charset=UTF-8
    Guid: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.AgentGateway1
  • Request parameter

    None

  • Response parameter
    {
        "message": "success",
        "retcode": "0"
    }