Browse Platform API
Platform API

Before one-to-one online push

Copy

Adjust target users or push policy before an online one-to-one push.

HTTP request

POST {WEBHOOK_ADDRESS}/callbackBeforeOnlinePushCommand

Request body

PropertyTypeDescription
callbackCommandstringcallbackBeforeOnlinePushCommand.
operationIDstringOpenIM operation trace ID.
platformIDintClient platform ID.
platformstringClient platform name.
userIDListstring[]Target user IDs.
titlestringPush title.
descstringPush summary.
exstringExtension data.
iOSPushSoundstringiOS notification sound.
iOSBadgeCountbooleanWhether to update the iOS badge.
clientMsgIDstringClient message ID.
sendIDstringSender user ID.
groupIDstringGroup ID when present.
contentTypeintMessage content type.
sessionTypeintConversation type.
atUserIDListstring[]Mentioned user IDs.
contentstringMessage content JSON string.

Response

Return the common before-event fields from Webhooks overview. userIDList may replace the push recipients and offlinePushInfo may replace push metadata.

Processing rules

  • Configuration key: beforeOnlinePush.
  • OpenIM waits synchronously; timeout behavior follows failedContinue.