Chat

If set to false, will create a new chat message using the following properties from the data parameter:

When show is false, chat will examine the channel parameter (automatically added when calling between parties) to determine the sender. However, since in a multi-party chat the sender may be relaying chat from another party, the connection name may also be sent to identify the chat originator.

An additional getSharingDescription property is used to return a description of the sharing in the "content" property. This is used internally by the chat step type and should not otherwise be used at it may change between versions.

An array of objects which specify the other parties to the chat, or a single object.

Each object has two properties: role (to identify the party) and action (to identify the action to call on the party).

The action defaults to the same action as the caller's chat.

If passed as a single string, it is assumed to be the role.

This means that in a typical case, the role will simply identify the role of the other party. Assuming the caller's chat step has a name of "chat", the following are equivalent.

"role": [
  {
    "role": "respondent",
    "action": "chat"
  }
]

"role": "respondent"

The config property is named "role" to make is consistent with other steps when the simple form is used.

A role that ends in a wildcard means "all connections with a role that matches", e.g. "share.*" would match "share.1", "share.2" and "share.banana".

An object that controls the features available on the editor. See the Editor topic in the development guide for details. Leave blank for a basic editor (equivalent to {"nonbasic":false}). This can be useful to remove features from the chat.

Set to false to turn off the editor and just show a plain text box.

Name of an action that can be called to perform a notification that a new chat has arrived. This will be passed a data block with descriptioin, suppressUser and sender properties.

Description and suppressUser can be passed directly into the Notify step. The sender property can be used to build a title for the notification, e.g. "Chat from %{param:data.sender}".

If the notifyAction is not given, no notifications are created.

Set to true for "readonly" mode, in which the message and attachments areas are not shown and there is no submit button. Other fields remain as is.

Additional content to show at the top of the page. Works in the same way as content on the Form script type.

Lists the active connections for the chat. The list is above the chat, below the content.

List of event types to include in the chat. If omitted or zero length, all event types are included. If you use include, remember to include the eventType itself. May be event type references or reference/name.

List of event types to exclude in the chat. If omitted or zero length, no event types are excluded. May be event type references or reference/name.

Caption to show on the button. Defaults to "Send". If using chat as a notes area (no connection), this might more usefully be called "Save".

Whether to show the check for new messages button. Default is true.

If set to true, set the actionRequired indicator when a message is received, and unset it when the message is read. This is suitable for processes that are centred around a chat interaction.

If set to content, set the worker message to the content when a message is received, and unset it when the message is read.

The chat message is internally known as the "message" and is written to the event description. This is a different message, the worker message. In some configurations, setting the worker message produces a notification.