tencent cloud

Cloud Contact Center

Announcement
What's New
Cloud Contact Center Terminology Update
What is Tencent Cloud Contact Center
Overview
Feature List
Terms Introduction
Handling Firewall Restrictions
AI Voicebot
Billing Guide
Voice Call Billing Overview
Desk Billing Overview
View Billing
Refund Policy
New User Guide
Voice Guide
Desk Guide
Use Case
Inbound: Customer Experience
Outbound: Telemarketing
Auto Dialer: Voice Notification
Integration Use Case (SDK）
Administrator Guide
Voice Guide
Desk Guide
Member Guide
Voice Guide
Desk Guide
AI Voice Agent Guide
Introducing AI Voice Agent
AI Voice Agent Practical Tutorial
Set Up Your AI Voice Agent
Activate AI Voice Agent Call
AI Voice Agent Call Logs
Developer Guide
SDK Development Guide
Data Push
Voice API Reference
History
Introduction
API Category
Making API Requests
Agent APIs
Skill Group APIs
Number APIs
Dual Call APIs
Predictive Outbound Call APIs
SIP Phone APIs
Call Service Record APIs
Billing APIs
Other APIs
Outbound Call APIs
Speech Intelligent Agent APIs
Data Types
Error Codes
Desk API Reference
API Reference
Callback Configuration
FAQs
Data Deletion Guide
Legal
Privacy Policy
Data Processing And Security Agreement
Service Level Agreements
TENCENT CLOUD CONTACT CENTRE TERMS OF USE
Glossary
Contact Us
DokumentasiCloud Contact CenterDesk API ReferenceAPI ReferenceSession APIsProactively Contact User

Proactively Contact User

Mode fokus
Ukuran font
Terakhir diperbarui: 2025-04-07 11:12:41

API Call Description

This interface allows selecting a customer service account, assigning a specific agent, or targeting a group to proactively contact users for a live conversation.

Sample Request URL

https://console.tim.qq.com/v4/desk_http_svc/contact_user?sdkappid=88888888&identifier=admin&usersig=xxx&random=99999999&contenttype=json

Request Parameters

The following table only lists the parameters involved in modification when calling this API and their descriptions. For more details about the parameters, please refer to REST API Introduction.
Parameter
Description
v4/desk_http_svc/contact_user
Request API.
sdkappid
Assigned SDKAppID in the IM console when creating an application.
identifier
Must be an App administrator account. For more details, see App Administrator.
usersig
Generated signature of the App administrator account. For specific operations, see Generate UserSig.
random
Enter a random 32-bit unsigned integer in the range of 0 to 4294967295.
contenttype
The request format has a fixed value of json.

Sample Request Packet

{
    "IMAgentUserID": "@customer_service_account",
    "ClientUserID": "1289314544",
    "GroupId": 9465,
    "MemberId": "1289316687@qq.com"
}

Request Packet Fields

Field
Type
Required
Description
IMAgentUserId
String
Required
UserID of the customer service account.
ClientUserId
String
Required
The user ID of the contacted user.
GroupId
Integer
Optional.
Specified assignment of agent group. If left blank, agents will be assigned according to the default policy.
MemberId
String
Optional.
Specified agent ID. If left blank, agents will be assigned according to the default policy.

Response Package Example

{
    "ActionStatus": "OK",
    "ErrorInfo": "",
    "ErrorCode": 0,
    "MemberId": "1289316687@qq.com"
}

Response Packet Fields

Field
Type
Description
ErrorCode
Integer
Error Code:
0 indicates success.
Non-zero indicates failure.
ErrorInfo
String
Error message.
ActionStatus
String
Result of request processing.
MemberId
String
Assigned agent.

Error Code Description

Unless a network error (such as 502 error) occurs, the HTTP return code of this API is 200. The actual error code and error information are indicated by ErrorCode and ErrorInfo in the response packet body.
For common error codes (60000 to 79999), see the Error Code document.
The private error codes of this API are as follows:
Error Code
Description
141000
Calling this interface is not allowed for applications that are not desk applications.
141001
Failed to assign a human customer service agent. No available agents online.
141002
Internal system error, please retry.
141003
This session cannot be transferred to a live agent.
141004
Invalid request parameters, please check and retry.
141011
Agent is offline. Please check whether agent is online.
141012
Agent has reached the maximum number of receptions.
141013
Agent is on a short break. Please try again after it becomes available for reception.
141014
The feature to contact the user is disabled.
141015
User account does not exist. Check whether the user account is correct.
141016
The user is in an artificial conversation.
141017
Failed to assign any agent. Check whether there are no agents online.
141018
The skill group has no permission for this customer service account. Please check the skill group configuration of the customer service account.
141019
Group is invalid. Please check whether the skill group is correct.

API Debugging Tool

Debug this interface through the Online Debugging Tool for REST API.
Topik sebelumnya: Agent TransferTopik selanjutnya: Query the Chat Record of the Specified Session

Bantuan dan Dukungan

Apakah halaman ini membantu?

masukan