Making a Previewed Outbound Call

Prerequisites

• The agent has signed in.
• The agent is not answering any call (except a held call).
• The agent has received a previewed outbound call event.

Description

After receiving a previewed outbound call event, the agent calls a subscriber using the previewed outbound call interface.

Interface Method

The request method must be set to PUT. This interface supports only the PUT method.

URI

https://ip:port/agentgateway/resource/voicecall/{agentid}/previewCallout

In the URL, ip indicates the IP address of the CC-Gateway server, and port indicates the HTTPS port number of the CC-Gateway server.

Method Name in Logs

previewCallout

Request Description

• Message header

  Table 2 Parameter in the request message header

  No.	Parameter	Value Type	Mandatory (Yes/No)	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	GUID returned by the sign-in interface during static authentication (AUTHMODE is set to 1) or GUID returned by the polling event query interface during dynamic authentication (AUTHMODE is set to 2).

• Message body

  Table 3 Parameters in the message body

  No.	Parameter	Value Type	Mandatory (Yes/No)	Description
  1	called	string	Yes	Called number. The parameter must be contained in the dialeddigits field of a preview event. If the parameter is not contained in the dialeddigits field, a call cannot be made.
  2	callcontrolid	long	Yes	Control block ID of a previewed outbound call. The value is the same as that of controllid in the previewed outbound call event.

Response Description

Triggered Event

• AgentOther_PhoneAlerting
• AgentOther_PhoneOffhook
• AgentEvent_Talking
• AgentEvent_Call_Out_Fail

Error Code

• 000-002
• 100-006
• 100-007
• 200-001
• 200-036

Example

• Message header

  Content-Type:application/json; charset=UTF-8
  Guid: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.AgentGateway1

• Request parameter

  {
      "called": "88889039",
      "callcontrolid": "11776"
  }

• Response parameter

  {
      "message": "",
      "retcode": "0",
      "result": "1455885056-1095"
  }