# Customer Service Message Introduction
When a user interacts with Service Account for specific actions (see below for a list of actions),WeChat will push the message data to the developer, who can call the customer service interface for a period of time to send a message to a normal user by POST a JSON packet.This interface is mainly used for functions such as customer service with human message processing, so that developers can provide more quality service to users.
The list of currently allowed actions is as follows (the public platform will update the list based on operational conditions, and the customer service interfaces allowed when different actions are triggered)
- Users send information
- Click on custom menus (Only three menu types - click push events, scan push events, and scan push events that pop up the "Message Received" prompt box - trigger the customer service interface)
- Follow Service Account
- Scan QR code
- The payment was successful
# Rules for sending customer service messages:
scene | Amount of withdrawal | Amount validity period |
---|---|---|
Users send messages | 5 Rules | 48 hours |
Click on the custom menu | 3 Rules | 1 minute |
Follow Service Account | 3 Rules | 1 minute |
Scan QR code | 3 Rules | 1 minute |
The payment was successful | limitless | 48 hours |
Special Note: When the user clicks the menu message, it is triggered by the clicking of the menu event, and the message rule corresponding to the clicking on the custom menu in scenario 2 does not generate the customer service message dispatch quota for the user's message scenario.
In addition, to help Service Account use different customer service identities to serve different user groups, the customer service interface has been upgraded to allow developers to manage customer service accounts and set their profile and nickname.This capability is available to all service numbers with customer service interface rights.
Also, please note that everywhere you use media_id in this interface, you can now use media_id as a permanent asset in asset management.
# List of customer service message interfaces
# Customer Service Management
Interface Name | English name | Request Path |
---|---|---|
Add customer service account | addkfaccount | /customservice/kfaccount/add |
Get all customer service accounts | getkflist | /cgi-bin/customservice/getkflist |
Get an online customer service list | getonlinekflist | /cgi-bin/customservice/getonlinekflist |
Modify customer service account | updatekfaccount | /customservice/kfaccount/update |
Delete customer service account | delkfaccount | /customservice/kfaccount/del |
Set up customer service avatar | uploadkfheadimg | /customservice/kfaccount/uploadheadimg |
Invite to bind customer service account | invitekfworker | /customservice/kfaccount/inviteworker |
# Session Control
Interface Name | English name | Request Path |
---|---|---|
Create a session | createkfsession | /customservice/kfsession/create |
Get a list of customer service sessions | getkfsessionlist | /customservice/kfsession/getsessionlist |
Get the client session state | getkfsession | /customservice/kfsession/getsession |
Get a list of unanswered calls | getwaitcase | /customservice/kfsession/getwaitcase |
Close the session | closeSession | /customservice/kfsession/close |
# Customer Service Messages
Interface Name | English name | Request Path |
---|---|---|
Get a chat log | getMsgList | /customservice/msgrecord/getmsglist |
Send customer service messages | sendCustomMessage | /cgi-bin/message/custom/send |
Customer Service Enter Status | typing | /cgi-bin/message/custom/typing |