About

The Chatandcollaboration module adds chat, collaboration, and other interaction tools to your event site, so attendees can take part in your events. These tools appear in the chat and collaboration panel, an engagement panel on the right side of the session page.

Configure

1. Go to your Configuration Management console, locate the Chatandcollaboration module in the left panel, then select it. You can also navigate directly using a link: https://{your_site_url}/admin/config/tab/chatandcollaboration

The Chatandcollaboration page displays.

2. Configure the following:

• enabled - Set to Yes to enable the module.
• Comments - Turn on comments on your site. This field requires the mediapage and mediaedit Theming features to be set to Yes.
• legalPrompts - Add the legal text that shows if you turn on legal prompts in the ChatandcollaborationAdmin module. Click + Add "legalPrompts". More fields appear.

  

  • language - Set the language of the legal text. You can add legal text in more than one language to match your site languages. You can save the module without it, but the widget doesn't load on your site until you set it.
  • legalPrompts - Click Upload legal text to add the legal text, or Remove to remove it.
• customTranslation - Upload a JSON file with your custom translations for the chat and collaboration panel. In the file, group the translations by language code, such as en for English or fr for French. For each language, include each key with its custom translation.

  Uploading a file overrides all existing translations.

• defaultUserSettings - Set the default value for each user setting: Notifications, ChatandCollaboration, and Show full name.
• defaultChannelModeration - Select Yes to turn on Q&A threads on channel pages, or No to turn them off.
• defaultEntryModeration - Select On to turn on Q&A threads on media pages, Off to turn them off, or According to schedule to turn them on based on the media schedule.
• usersSearch - Select On to add a search box to the chat widget, so users can find other users on your site and chat with them. Select Off to hide it.
• usersChat - Select On to let users chat with each other one-on-one, or Off to turn off one-on-one chat.
• channelGroupChat - Turn on group chat for all channels on your site, and choose how it looks. Select one of the following options:
  • Disabled - Group chat is off.
  • Comments - Group chat shows as a comments thread.
  • Group chat - Group chat shows in the group chat view.
• entryGroupChat - Turn on group chat for all media on your site, and choose how it looks. Select one of the following options:
  • Disabled - Group chat is off.
  • Comments - Group chat shows as a comments thread.
  • Group chat - Group chat shows in the group chat view.
• toastTimeout - Enter how long, in milliseconds, pop-up notifications (toasts) stay on screen before they close.
• excludePath - Hide the chat and collaboration panel on specific pages of your site. Click + Add "ExcludePath" for each page you want to exclude. A new field is added.

  

  • Path - Enter the full URL of the page or part of it, with or without the domain name. To exclude a specific media entry or category, enter its ID.
• enableWithNoCookieConsent - Set to Yes or No, based on the customer's cookie policy and how the event uses cookies.
• sentimentAnalysisAllowedUsersOrRoles - Select who can turn on AI sentiment analysis for media they own or co-edit. Select one of the following options:
  • privateOnly Role
  • admin Role
  • unmoderatedAdmin Role
  • Specific Users / Groups - Then select the users or groups who can turn on sentiment analysis.
  If you select a role, users with any higher role can also turn on sentiment analysis.
• OpenByDefault - Set to Yes to open the panel by default for all users. It opens on the first item in the list. Users can still close it.
• liveStageSvgIcon - Upload a custom SVG file that replaces the Live chat icon.
• allowMultipleContextThreads - Choose how chat with the moderator works on the Q&A tab: one conversation thread per user, or multiple threads per user. Multiple threads is the default.
• mediaChat - Set the default settings for media chat features, including Public Q&A.
• enableMediaChatType - Turn on media chat. You must turn it on before you can use any media chat experience.

  Setting enableMediaChatType to Enabled doesn't turn on Public Q&A by itself. It's a prerequisite. You then select Public Q&A in the schedule-based chat type settings.

  After you turn on media chat, more fields appear.

  

  • scheduleMediaChatType - Set whether chat follows the session schedule. If it does, you can set a different chat type before, during, and after the session.
  • preScheduleChatType - Set the chat experience before the session starts. Use it when you want a different experience before the event goes live.
  • duringScheduleChatType - Set the chat experience during the live session. This is the main setting for Public Q&A during the session.
  • postScheduleChatType - Set the chat experience after the session ends. You can use it to keep the discussion open, change the chat type, or limit interaction after the session.
  • preScheduleTimeOut - Open chat before the session. Enter the number of minutes before the scheduled start time.
  • postScheduleTimeOut - Keep chat open after the session. Enter the number of minutes after the scheduled end time.

  If your main goal is Q&A during the live session, start with duringScheduleChatType. Then decide whether you also want discussion before or after the session.

• reactions - Show or hide reactions on your site.

3. Click Save.