core_v2_conversation Script API

Verint | Telligent Community — Wed, 14 May 2025 17:07:45 GMT

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

Enables scripted content fragments to use Conversations

Properties

Name	Access	Type	Description
ContentTypeId	Read	`[[Guid Script API Type\|Guid]]`	Content type identifier for conversations
Current	Read	`[[Conversation Script API Type\|Conversation]]`	Current

Methods

CanStartConversationWith

Identifies whether the accessing user can start a conversation with the provided user.

Velocity

#set($booleanResponse = $core_v2_conversation.CanStartConversationWith($userName))

JavaScript

var booleanResponse = core_v2_conversation.CanStartConversationWith(userName);

Parameters

Name	Type	Description	Required	Default	Options
userName	`[[String Script API Type\|String]]`	User Name	Required

Returns

[[Boolean Script API Type|Boolean]]

Create

Create Overload 1

Obsolete in 10: Use Create(body, usernames) instead. Obsolete in 10: Use Create(body, usernames) instead.

Velocity

#set($conversationResponse = $core_v2_conversation.Create($subject, $body, $usernames))

JavaScript

var conversationResponse = core_v2_conversation.Create(subject, body, usernames);

Parameters

Name	Type	Description	Required
subject	`[[String Script API Type\|String]]`	Obsolete in 10	Required
body	`[[String Script API Type\|String]]`	Body of the conversation's first message	Required
usernames	`[[String Script API Type\|String]]`	One or more usernames to include in the conversation (comma separated).	Required

Create Overload 2

Creates a new conversation

Velocity

#set($conversationResponse = $core_v2_conversation.Create($body, $usernames))

JavaScript

var conversationResponse = core_v2_conversation.Create(body, usernames);

Parameters

Name	Type	Description	Required	Default	Options
body	`[[String Script API Type\|String]]`	Body of the conversation's first message	Required
usernames	`[[String Script API Type\|String]]`	One or more usernames to include in the conversation (comma separated).	Required

Returns

[[Conversation Script API Type|Conversation]]

Delete

Delete/hide a conversation. The conversation will be deleted when all participants delete or leave the conversation. If any participant replies, all participants who deleted the conversation will see the full conversation again.

Velocity

#set($additionalInfoResponse = $core_v2_conversation.Delete($id))

JavaScript

var additionalInfoResponse = core_v2_conversation.Delete(id);

Parameters

Name	Type	Description	Required	Default	Options
id	`[[Guid Script API Type\|Guid]]`	Id conversation to delete	Required

Returns

[[AdditionalInfo Script API Type|AdditionalInfo]]

Get

Get Overload 1

Gets a conversation

Velocity

#set($conversationResponse = $core_v2_conversation.Get($conversationId))

JavaScript

var conversationResponse = core_v2_conversation.Get(conversationId);

Parameters

Name	Type	Description	Required	Default	Options
conversationId	`[[Guid Script API Type\|Guid]]`	Conversation identifier	Required

Get Overload 2

Velocity

#set($conversationResponse = $core_v2_conversation.Get($usernames))

JavaScript

var conversationResponse = core_v2_conversation.Get(usernames);

Parameters

Name	Type	Description	Required	Default	Options
usernames	`[[String Script API Type\|String]]`	Usernames	Required

Returns

[[Conversation Script API Type|Conversation]]

HasLeft

Identifies if a participant has left the conversation.

Velocity

#set($booleanResponse = $core_v2_conversation.HasLeft($id, $userId))

JavaScript

var booleanResponse = core_v2_conversation.HasLeft(id, userId);

Parameters

Name	Type	Description	Required	Default	Options
id	`[[Guid Script API Type\|Guid]]`	Id of the conversation	Required
userId	`[[Number Script API Type\|Number]]`	The user ID of the participant to review.	Required

Returns

[[Boolean Script API Type|Boolean]]

Leave

Leave a conversation. The conversation will be deleted when all participants delete or leave the conversation. If any participant replies, participants who have left will not be reactivated in the conversation but can be reactivated manually by other participants.

Velocity

#set($additionalInfoResponse = $core_v2_conversation.Leave($id))

JavaScript

var additionalInfoResponse = core_v2_conversation.Leave(id);

Parameters

Name	Type	Description	Required	Default	Options
id	`[[Guid Script API Type\|Guid]]`	Id conversation to leave	Required

Returns

[[AdditionalInfo Script API Type|AdditionalInfo]]

List

List Overload 1

List conversations

Velocity

#set($pagedListResponse = $core_v2_conversation.List())

JavaScript

var pagedListResponse = core_v2_conversation.List();

List Overload 2

List conversations

Velocity

#set($pagedListResponse = $core_v2_conversation.List("%{ PageIndex = $pageIndexArg, PageSize = $pageSizeArg, ReadStatus = $readStatusArg }"))

JavaScript

var pagedListResponse = core_v2_conversation.List({ PageIndex: pageIndexArg, PageSize: pageSizeArg, ReadStatus: readStatusArg });

Parameters

Name	Type	Description	Required	Default	Options
options	Options	Set of optional parameters including:	Required
PageIndex	`[[Number Script API Type\|Number]]`	Specify the page number of paged results to return. Zero-based index.	Optional	0
PageSize	`[[Number Script API Type\|Number]]`	Specify the number of results to return per page.	Optional	20
ReadStatus	`[[String Script API Type\|String]]`	Read Status	Optional	NotSet	NotSet, Read, Unread

Returns

[[PagedList Script API Type|PagedList]] of [[Conversation Script API Type|Conversation]]

MarkAsRead

Mark a conversation as read

Velocity

$core_v2_conversation.MarkAsRead($id)

JavaScript

core_v2_conversation.MarkAsRead(id);

Parameters

Name	Type	Description	Required	Default	Options
id	`[[Guid Script API Type\|Guid]]`	Id conversation to mark as read	Required

Returns

Nothing

MarkAsUnread

Mark a conversation as unread

Velocity

$core_v2_conversation.MarkAsUnread($id)

JavaScript

core_v2_conversation.MarkAsUnread(id);

Parameters

Name	Type	Description	Required	Default	Options
id	`[[Guid Script API Type\|Guid]]`	Id conversation to mark as unread	Required

Returns

Nothing

ReadCount

Number of read conversations.

Velocity

#set($numberResponse = $core_v2_conversation.ReadCount())

JavaScript

var numberResponse = core_v2_conversation.ReadCount();

Returns

[[Number Script API Type|Number]]

Restore

Restore a participant who has left the conversation. If the requestor can start a conversation with the requested user and the user had previously left the conversation, the requested user will be restored in the conversation.

Velocity

#set($additionalInfoResponse = $core_v2_conversation.Restore($id, $userId))

JavaScript

var additionalInfoResponse = core_v2_conversation.Restore(id, userId);

Parameters

Name	Type	Description	Required	Default	Options
id	`[[Guid Script API Type\|Guid]]`	Id of the conversation	Required
userId	`[[Number Script API Type\|Number]]`	The user ID of the partipiant who left that should be restored.	Required

Returns

[[AdditionalInfo Script API Type|AdditionalInfo]]

ToString

Velocity

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

JavaScript

var stringResponse = core_v2_conversation.ToString();

Returns

[[String Script API Type|String]]

UnreadCount

Number of unread conversations.

Velocity

#set($numberResponse = $core_v2_conversation.UnreadCount())

JavaScript

var numberResponse = core_v2_conversation.UnreadCount();

Returns

[[Number Script API Type|Number]]