# 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)

  1. Users send information
  2. 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)
  3. Follow Service Account
  4. Scan QR code
  5. 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 NameEnglish nameRequest Path
Add customer service accountaddkfaccount/customservice/kfaccount/add
Get all customer service accountsgetkflist/cgi-bin/customservice/getkflist
Get an online customer service listgetonlinekflist/cgi-bin/customservice/getonlinekflist
Modify customer service accountupdatekfaccount/customservice/kfaccount/update
Delete customer service accountdelkfaccount/customservice/kfaccount/del
Set up customer service avataruploadkfheadimg/customservice/kfaccount/uploadheadimg
Invite to bind customer service accountinvitekfworker/customservice/kfaccount/inviteworker

# Session Control

Interface NameEnglish nameRequest Path
Create a sessioncreatekfsession/customservice/kfsession/create
Get a list of customer service sessionsgetkfsessionlist/customservice/kfsession/getsessionlist
Get the client session stategetkfsession/customservice/kfsession/getsession
Get a list of unanswered callsgetwaitcase/customservice/kfsession/getwaitcase
Close the sessioncloseSession/customservice/kfsession/close

# Customer Service Messages

Interface NameEnglish nameRequest Path
Get a chat loggetMsgList/customservice/msgrecord/getmsglist
Send customer service messagessendCustomMessage/cgi-bin/message/custom/send
Customer Service Enter Statustyping/cgi-bin/message/custom/typing