core_v2_statusMessage Script API

Verint | Telligent Community — Wed, 14 May 2025 17:08:23 GMT

Current Revision posted to API Documentation by Verint | Telligent Community on 05/14/2025 17:08:23

Enables scripted content fragments to use StatusMessages

Properties

Name	Access	Type	Description
ContentTypeId	Read	`[[Guid Script API Type\|Guid]]`	Status messages content type identifier
StoryTypeId	Read	`[[Guid Script API Type\|Guid]]`	Story Type Id

Methods

CanUpdate

Returns whether accessing user can update a status message

Velocity

#set($booleanResponse = $core_v2_statusMessage.CanUpdate($messageId))

JavaScript

var booleanResponse = core_v2_statusMessage.CanUpdate(messageId);

Parameters

Name	Type	Description	Required	Default	Options
messageId	`[[Guid Script API Type\|Guid]]`	Message Id	Required

Returns

[[Boolean Script API Type|Boolean]]

Create

Create Overload 1

Creates a new status message by the accessing user

Velocity

#set($statusMessageResponse = $core_v2_statusMessage.Create($messageBody))

JavaScript

var statusMessageResponse = core_v2_statusMessage.Create(messageBody);

Parameters

Name	Type	Description	Required	Default	Options
messageBody	`[[String Script API Type\|String]]`	Message Body	Required

Create Overload 2

Creates a new status message by the accessing user

Velocity

#set($statusMessageResponse = $core_v2_statusMessage.Create($messageBody, "%{ AttachedUrl = $attachedUrlArg, GroupId = $groupIdArg }"))

JavaScript

var statusMessageResponse = core_v2_statusMessage.Create(messageBody, { AttachedUrl: attachedUrlArg, GroupId: groupIdArg });

Parameters

Name	Type	Description	Required
messageBody	`[[String Script API Type\|String]]`	Message Body	Required
options	Options	Set of optional parameters including:	Required
AttachedUrl	`[[String Script API Type\|String]]`	URL to attach to this status message	Optional
GroupId	`[[String Script API Type\|String]]`	Group Id	Optional

Returns

[[StatusMessage Script API Type|StatusMessage]]

Delete

Deletes a status message

Velocity

#set($additionalInfoResponse = $core_v2_statusMessage.Delete($messageId))

JavaScript

var additionalInfoResponse = core_v2_statusMessage.Delete(messageId);

Parameters

Name	Type	Description	Required	Default	Options
messageId	`[[Guid Script API Type\|Guid]]`	Message Id	Required

Returns

[[AdditionalInfo Script API Type|AdditionalInfo]]

Get

Gets a status message

Velocity

#set($statusMessageResponse = $core_v2_statusMessage.Get($messageId))

JavaScript

var statusMessageResponse = core_v2_statusMessage.Get(messageId);

Parameters

Name	Type	Description	Required	Default	Options
messageId	`[[Guid Script API Type\|Guid]]`	Message Id	Required

Returns

[[StatusMessage Script API Type|StatusMessage]]

GetCount

Gets the count of status messages by an author.

Velocity

#set($numberResponse = $core_v2_statusMessage.GetCount($userId))

JavaScript

var numberResponse = core_v2_statusMessage.GetCount(userId);

Parameters

Name	Type	Description	Required	Default	Options
userId	`[[Number Script API Type\|Number]]`	User Id	Required

Returns

[[Number Script API Type|Number]]

List

List Overload 1

Lists status messages

Velocity

#set($apiListResponse = $core_v2_statusMessage.List())

JavaScript

var apiListResponse = core_v2_statusMessage.List();

List Overload 2

Lists status messages. Due to performance considerations, the result may not always return the requested PageSize of results, but it is guaranteed to return at least 1 result if any results exist when using an open-ended date range. By default, the method will first query for the last 48 hours, then for the last 96 hours, and then for all time, returning when it finds at least 1 result that matches the other given criteria. It also will not return the TotalItems value. It is recommended to page by StartDate and/or EndDate instead of PageIndex and PageSize.

Velocity

#set($apiListResponse = $core_v2_statusMessage.List("%{ AfterDate = $afterDateArg, BeforeDate = $beforeDateArg, GroupId = $groupIdArg, Include = $includeArg, PageSize = $pageSizeArg, UserId = $userIdArg, Username = $usernameArg }"))

JavaScript

var apiListResponse = core_v2_statusMessage.List({ AfterDate: afterDateArg, BeforeDate: beforeDateArg, GroupId: groupIdArg, Include: includeArg, PageSize: pageSizeArg, UserId: userIdArg, Username: usernameArg });

Parameters

Name	Type	Description	Required	Default	Options
options	Options	Set of optional parameters including:	Required
AfterDate	`[[DateTime Script API Type\|DateTime]]`	Retrieve status messages posted after the date specified	Optional
BeforeDate	`[[DateTime Script API Type\|DateTime]]`	Specify BeforeDate to only retrieve activity messages posted from that date and before	Optional
GroupId	`[[Number Script API Type\|Number]]`	Optional to return group messages.	Optional
Include	`[[String Script API Type\|String]]`	Comma-separated list	Optional		following, groups, replies
PageSize	`[[Number Script API Type\|Number]]`	Specify the number of results to return per page.	Optional	20
UserId	`[[Number Script API Type\|Number]]`	Either the UserId or Username is required	Optional
Username	`[[String Script API Type\|String]]`	Either the UserId or Username is required	Optional

Returns

[[ApiList Script API Type|ApiList]] of [[StatusMessage Script API Type|StatusMessage]]

PreviewAttachment

PreviewAttachment Overload 1

Previews embedded or explicit attachments

Velocity

#set($stringResponse = $core_v2_statusMessage.PreviewAttachment($messageBody))

JavaScript

var stringResponse = core_v2_statusMessage.PreviewAttachment(messageBody);

Parameters

Name	Type	Description	Required	Default	Options
messageBody	`[[String Script API Type\|String]]`	Message Body	Required

PreviewAttachment Overload 2

Previews embedded or explicit attachments

Velocity

#set($stringResponse = $core_v2_statusMessage.PreviewAttachment($messageBody, "%{ AttachedUrl = $attachedUrlArg, GroupId = $groupIdArg }"))

JavaScript

var stringResponse = core_v2_statusMessage.PreviewAttachment(messageBody, { AttachedUrl: attachedUrlArg, GroupId: groupIdArg });

Parameters

Name	Type	Description	Required
messageBody	`[[String Script API Type\|String]]`	Message Body	Required
options	Options	Set of optional parameters including:	Required
AttachedUrl	`[[String Script API Type\|String]]`	URL to attach to this status message	Optional
GroupId	`[[String Script API Type\|String]]`	Group Id	Optional

Returns

[[String Script API Type|String]]

ToString

Velocity

#set($stringResponse = $core_v2_statusMessage.ToString())

JavaScript

var stringResponse = core_v2_statusMessage.ToString();

Returns

[[String Script API Type|String]]

Update

Updates an existing status message

Velocity

#set($statusMessageResponse = $core_v2_statusMessage.Update($id, $messageBody, "%{ AttachedUrl = $attachedUrlArg, GroupId = $groupIdArg }"))

JavaScript

var statusMessageResponse = core_v2_statusMessage.Update(id, messageBody, { AttachedUrl: attachedUrlArg, GroupId: groupIdArg });

Parameters

Name	Type	Description	Required
id	`[[Guid Script API Type\|Guid]]`	Id	Required
messageBody	`[[String Script API Type\|String]]`	Message Body	Required
options	Options	Set of optional parameters including:	Required
AttachedUrl	`[[String Script API Type\|String]]`	URL to attach to this status message. When null, leaves unchanged. When empty, removes existing.	Optional
GroupId	`[[String Script API Type\|String]]`	Group Id	Optional

Returns

[[StatusMessage Script API Type|StatusMessage]]