Nurama Developers
Notification types

chatCreateMessage

Fired when a new message is created in a chat (user messages, public/guest messages, AI assistant replies and system messages).

Delivered as the notification socket event with type set to chatCreateMessage.

Fired when a new message is created in a chat (user messages, public/guest messages, AI assistant replies and system messages).

Fired when a new message is created in a chat. Published on chat/{chatId}, the topic resource channel(s) and user/{userId} for member chats.

Payload for the chatCreateMessage event.

Token keys marked with (*) will be deprecated in a future release and should not be used for new development; replace them with the values and objects in the changes key in existing implementations.

Payload

PropertyTypeRequiredDescription
typestringyesThe specific type of notification event (matches the top-level key, e.g., 'workspaceCreate'). Every value in notificationTemplates (config/notifications.js) is documented in this tag.
initiatorIdstring (uuid)noID of the user or system that initiated the event. Null if initiatorType is 'system'.
initiatorType"user" | "system"yesType of initiator (user or system).
initiatorobject | nullnoPopulated initiator user object (if initiatorType is 'user').
resourceIdstring (uuid)yesID of the primary resource this notification pertains to.
resourceTypestringyesType of the primary resource this notification pertains to.
channelsstring[]noThe specific channels this notification was published on. Present on notification objects returned by the REST API only; the socket 'notification' payload omits it (and id).
createdAtstring (date-time)yesTimestamp when the notification was created.
tokensobjectno
changesobjectnochanges.create holds the message and changes.update the parent chat (lastMessage etc.). When the message creates the chat itself (first message in a new topic chat) the chat entry appears in changes.create instead of changes.update.

tokens

PropertyTypeRequiredDescription
(*)requesterIdstring (uuid)noDeprecated. Use initiatorId.
(*)requesterobjectnoDeprecated. Use initiator.
(*)chatIdstring (uuid)noDeprecated.
(*)messageIdstring (uuid)noDeprecated.
(*)resourceTypestringnoDeprecated. Topic/scope resource type of the chat (e.g. 'project', 'asset', 'task', 'public').
(*)resourceIdstring (uuid)noDeprecated.
(*)visibilitystring[]noDeprecated.
(*)mentionsobject[]noDeprecated. Mentions contained in the message.
(*)messageobjectnoDeprecated. The created message object. Use resource from changes.create.

changes

PropertyTypeRequiredDescription
createobject[]no
updateobject[]no

create (items)

PropertyTypeRequiredDescription
resourceIdstring (uuid)no
resourceType"chatMessage"no
resourceobjectnoThe created message.

update (items)

PropertyTypeRequiredDescription
resourceIdstring (uuid)no
resourceType"chat" | "chatMember" | "chatSubmission"no
resourceobjectnoThe chat the message belongs to (resourceType reflects the chat model: 'chat' for topic chats, 'chatMember' for member chats, 'chatSubmission' for submission chats).

On this page