logo

Send Notification

This interface is used for external system notification push interface

Request Method

post /agent_notices

Request Parameters (Request String)

Parameter NameTypeRequiredDescription
agent_noticeObjectYesNotification object

Notification Object

Parameter NameTypeRequiredDescription
contentStringYesNotification content
targetsString ArrayYesNotification target identifier (ID, email, work ID)
target_typeStringYesNotification target category (user: agent, group: agent group)
target_find_methodStringYesNotification target search method. Agent supports by_id: by ID, by_work_id: by work ID, by_email: by email; Agent group supports by_id: by agent group ID
external_sourceStringNoChannel name, default is administrator

Response Data

Attribute NameTypeDescription
codeIntegerExecution result code, 1000 means success
messageStringExecution result description
idIntegerNotification ID

Example

curl --location -g --request POST 'https://{{subdomain}}.udesk.cn/open_api_v1/agent_notices?email={{email}}&sign_version=v2&nonce={{nonce}}&timestamp={{timestamp}}&sign={{sign}}' \
--header 'Content-Type: application/json' \
--data-raw '{
"agent_notice": {
"target_type": "user",
"target_find_method": "by_id",
"targets": [1],
"content": "OpenApi test",
"external_source": "OpenApi"
}
}'