Description

Retrieve the count of pending todo tasks by business type.

Request Specification

Method: POST + application/json

Endpoint: https://${cloud-domain}/cgi/crm/v2/special/getUserTodoStats?thirdTraceId=${Random String}

Headers: Refer to Common Parameters

Request Parameters

Parameter	Type	Required	Description
includeNull	Boolean	No	Whether to include null fields. false: not returned, true: returned. Default is false
appId	String	No	Filter by application ID. Leave empty to query all
data	Map	Yes	Choose either data.app or data.bizTypes
app	String	No	Corresponds to a BOC type. Priority field. Options: ALL (all apps), CRM (all CRM sub-types), TASK (task apps)
bizType	List	No	Specific business types

Request Example

{
  "includeNull": true,
  "data": {
    "app": "",
    "bizType": ""
  },
  "appId": ""
}

Response Parameters

Parameter	Type	Description
traceId	string	Unique request ID
data	List	Dataset
errorDescription	string	Error description
errorMessage	string	Error message
errorCode	Int	Error codes

Response Example

{
  "traceId": "E-O.827xxxxxx",
  "data": [
    {
      "bizType": "452",
      "notReadCount": 0,
      "notDealCount": 0,
      "notDealTemporaryCount": 0,
      "extendCount": [
        {
          "key": "452_notDeal",
          "notReadCount": 0,
          "notDealCount": 0
        },
        {
          "key": "452_notDealTemporary",
          "notReadCount": 0,
          "notDealCount": 0
        }
      ]
    }
  ],
  "errorDescription": "success",
  "errorMessage": "OK",
  "errorCode": 0
}

Notes

• Do not use the message field in the response for logical judgment as errorMessage may change.

Special Instructions

bizTypes Parameter Details

APP	Business Name	Included Todo Types (bizType)
CRM	CRM Todos (approvals, workflows, CRM objects)	452: Pending approvals 457: Pending workflows 401: Pending lead assignments 402: Pending lead follow-ups 404: Pending order confirmations 406: Pending stage confirmations 408: Pending refund confirmations 410: Pending invoice requests 411: Pending return orders 456: Pending order shipments 460: Pending stage tasks 403: Pending customer registrations
FEED	Feed business	MyTodoTask: Task todos 20: Receipt required 11: Pending report reviews 13: Pending collaborative approvals 12: Pending instructions 15: Pending instruction reviews
ORDER	Deep Research Work Orders	waitApproval: Pending approvals waitAssign: Pending assignments waitCheckins: Pending services waitDeal: Pending processing
ALL	All todo types	All above bizTypes