<h2>Introduction</h2>Reducing the time spent on creating a session for agents is crucial for efficiency.&nbsp;By following a few simple steps, you can optimize the process using copy and paste and declarative coding methods. This documentation provides step-by-step instructions to streamline the session creation workflow.<h2>Prerequisites</h2>Before proceeding, ensure that you have already set up a chat bot and embedded chat. If you need assistance with these setups, you can refer to the following resources:<a target="_blank" rel="noopener noreferrer nofollow" href="https://trailhead.salesforce.com/content/learn/projects/build-a-community-with-knowledge-and-chat">https://trailhead.salesforce.com/content/learn/projects/build-a-community-with-knowledge-and-chat</a> <a target="_blank" rel="noopener noreferrer nofollow" href="https://trailhead.salesforce.com/content/learn/modules/einstein-bots-project-planning">https://trailhead.salesforce.com/content/learn/modules/einstein-bots-project-planning</a><h3>Setting up the code</h3>To begin, create the class that will be called by the chat bot to initiate the session. Follow the instructions below:<ol><li>Navigate to the "Apex Classes" section in the setup menu by using the quick search.</li><li>Click on "Apex Classes" to access the class list.</li><li>Create a new class by selecting "Create New."</li><li>Copy and paste the following code into the code editor:</li></ol><pre><code class="language-plaintext">public with sharing class SessionCreateQuickAction {

 public class SessionCreationInput {
 @invocableVariable(required=true)
 public string description;

 @invocableVariable(required=true)
 public string sessionType;

 @invocableVariable(required=true)
 public string parentType;

 @invocableVariable(required=true)
 public string parentId;
 }

 public class SessionCreateResponse {
 @InvocableVariable(required=true)
 public screenmeet__Live_Session__c record;
 }

 // Return service account to set is as the owner of the session
 // extrenal ACL will determine which agent its the actuall owner
 // by looking the owner of the parent object
 public static Id getServiceAccount() {
 PermissionSet pSet = [SELECT Id FROM PermissionSet where NamespacePrefix = 'screenmeet' and Name = 'ScreenMeet_Service' limit 1];

 PermissionSetAssignment pSetAssignment = [SELECT AssigneeId,IsActive,PermissionSetId FROM PermissionSetAssignment WHERE IsActive = true and PermissionSetId = :pSet.Id];

 return pSetAssignment.AssigneeId;

 }

 @InvocableMethod(label='Create a Screenmeet Session' description='Creates and returns a screenmeet session')
 public static List&lt;SessionCreateResponse&gt; QuickActionTest(List&lt;SessionCreationInput&gt; inputs) {
 List&lt;SessionCreateResponse&gt; response = new List&lt;SessionCreateResponse&gt;();
 string SERVICE_ACCOUNT_ID = getServiceAccount();

 for (SessionCreationInput input : inputs) {
 screenmeet.ScreenMeetAPI.ScreenMeetSessionParams newSession = new screenmeet.ScreenMeetAPI.ScreenMeetSessionParams(
 input.sessionType, //session type
 input.parentId, //parentObjectId - in this case, the Service Appointment ID
 input.parentType, //owner object type which will show back up in the ScreenMeet Live Session table
 SERVICE_ACCOUNT_ID, //owner id to enable ScreenMeet ACL functionality
 input.description, //the description of the call
 'svc_acc' //name of the owner
 );
 Map&lt;String, Object&gt; SMresponse = screenmeet.ScreenMeetApi.createSession(newSession);

 // Get the salesforce ID from the response
 Id extObjId = SMresponse.get('externalSessionObjectId').toString();

 // Grab the session from salesforce
 screenmeet__Live_Session__c ls = [SELECT Id,screenmeet__pin__c,screenmeet__Session_Id__c,screenmeet__user_url__c, screenmeet__parentObjectId__c, screenmeet__parentObjectType__c FROM screenmeet__Live_Session__c WHERE Id = :extObjId];

 // Create instance of the rurn type
 SessionCreateResponse s = new SessionCreateResponse();
 s.record = ls;

 // Add it to the response
 response.add(s);
 }

 return response;
 }

}
</code></pre><h4>Notes</h4>If you cannot find the "Apex Classes" menu or the "Create New" option, please request assistance from your Salesforce Admin.&nbsp;They can provide the necessary permissions or help you with this step. If your organization has a Salesforce Developer, you can reach out to them for support.<h3>Permissions</h3>Determine the user account that runs your bot. By default, this is the Integration User. Follow the steps below to create a new permission set and assign the required permissions:<ol><li>Go to the setup menu and search for "Permission Sets" in the quick find box. Select "Permission Sets" from the search results.</li><li>Click on "New" to create a new permission set.</li><li>Fill out the form with the following values:</li></ol><table style="min-width: 50px;"><tbody><tr><th colspan="1" rowspan="1">Field</th><th colspan="1" rowspan="1">Value</th></tr><tr><td colspan="1" rowspan="1">Label</td><td colspan="1" rowspan="1">Create Session Quick Action Perm Set</td></tr><tr><td colspan="1" rowspan="1">API Name</td><td colspan="1" rowspan="1">Create_Session_Quick_Action_Perm_Set</td></tr><tr><td colspan="1" rowspan="1">Description</td><td colspan="1" rowspan="1">Permission Set used to grant minimal access required to be able to execute the Create Session quick Action</td></tr></tbody></table>&nbsp; &nbsp;4. Click "Save" and proceed to assign permissions.Apex Class Access:<ul><li>Click on "Apex Class Access."</li><li>Click "Edit" and add the following classes to the permission set:</li></ul><ol><li>SessionCreateQuickAction</li><li>Screenmeet.ScreenMeetAPIHelper</li><li>Screenmeet.ScreenMeetAPI</li></ol>Object Settings:<ol><li>Select "ScreenMeet Live Sessions" from the Object Permissions list.</li><li>Enable Read access for the object.</li><li>Under Field Permissions, enable Read access for the following fields:</li></ol><ul><li>PIN</li><li>Session Id</li><li>User URL</li></ul>&nbsp; &nbsp; 4. Click "Save" and return to the Permission Set Overview.System Permissions:<ol><li>Select "System Permissions" and click "Edit."</li><li>Enable the "View Setup and Configuration" permission.</li><li>Click "Save" and proceed to the next step.</li></ol>Manage Assignments:<ol><li>Click "Save" and then select "Manage Assignments."</li><li>Add an assignment and search for the user you are using for your bot (typically named "Integration User").</li><li>Do not assign an expiration date.</li></ol><h3>Integrate it with your existing bot</h3>In this section, we will cover the basics of creating a session using the Apex action. You can choose where to add this action based on your requirements. Assuming you have identified the appropriate location, follow these steps:<ol><li>Define the two out of the four inputs required for the "Create a Screen Meet Session" action:</li></ol><table style="min-width: 50px;"><tbody><tr><th colspan="1" rowspan="1">Input</th><th colspan="1" rowspan="1">Description</th></tr><tr><td colspan="1" rowspan="1">description</td><td colspan="1" rowspan="1">Just a description for the session, you could either ask the user for one, hardcode some text or use the subject if you have access to it</td></tr><tr><td colspan="1" rowspan="1">sessionType</td><td colspan="1" rowspan="1">It indicates the type of session to be created and must be one of the following values: <code>live</code>, <code>support</code>, <code>cobrowse</code>, <code>replay</code></td></tr></tbody></table>&nbsp; &nbsp; 2. Drag and drop the Apex action from the Dialog Component Library to the desired location.&nbsp; &nbsp; 3. Configure the action as follows:Action Details:<table style="min-width: 50px;"><tbody><tr><th colspan="1" rowspan="1">Field</th><th colspan="1" rowspan="1">Value</th></tr><tr><td colspan="1" rowspan="1">Action Type</td><td colspan="1" rowspan="1">Apex</td></tr><tr><td colspan="1" rowspan="1">Action Name</td><td colspan="1" rowspan="1">Create a ScreenMeet Session</td></tr></tbody></table>Inputs:<table style="min-width: 75px;"><tbody><tr><th colspan="1" rowspan="1">Input Name</th><th colspan="1" rowspan="1">Source</th><th colspan="1" rowspan="1">Value</th></tr><tr><td colspan="1" rowspan="1">parentId</td><td colspan="1" rowspan="1">Variable</td><td colspan="1" rowspan="1">RoutableId</td></tr><tr><td colspan="1" rowspan="1">parentType</td><td colspan="1" rowspan="1">value</td><td colspan="1" rowspan="1">livechattranscript</td></tr><tr><td colspan="1" rowspan="1">description</td><td colspan="1" rowspan="1">Either Value if you want to hardcode or variable</td><td colspan="1" rowspan="1">a hardcoded text or a variable storing your desired description</td></tr><tr><td colspan="1" rowspan="1">sessionType</td><td colspan="1" rowspan="1">&nbsp;Either Value if you want to hardcode or variable</td><td colspan="1" rowspan="1">a hardcoded session type or a variable that contains your desired Session Type</td></tr></tbody></table>Output: You can store the output in a variable or ignore it, as the session is already attached to the chat transcript.<h2>When to use ScreenMeet with your chat bot</h2>Listed below are some chat topics that may lead to a ScreenMeet Session.<h3>Employee Help Desk</h3><ul><li>Password change / reset</li><li>Administrator access</li><li>Email setup on phone</li><li>Can’t receive email</li><li>Can’t send email</li><li>Email sync issues</li><li>Email setup</li><li>Outlook calendar issues</li><li>Email client is slow</li><li>Email setup on Gmail</li><li>Recover deleted emails.</li><li>Upgrade an app on device / desktop</li><li>Adding a new app to a device / desktop</li><li>Camera not working</li><li>Microphone not working</li><li>Speaker not working</li><li>Desktop computer running slow</li><li>Can’t connect to VPN</li><li>Device running hot</li><li>Device port not being recognized</li><li>Device freezes</li><li>Device won’t restart</li><li>Interference in video</li></ul><h3>Customer Technical Support</h3><ul><li>Hardware</li><li>Password change / reset</li><li>Device running hot</li><li>Device port not being recognized</li><li>Device freezes</li><li>Device won’t restart</li><li>Apps on device not working</li><li>Apps on device not working after upgrade</li><li>Systems</li><li>How do I do a specific function</li><li>When I do x, y happens</li><li>I don’t have access to a feature</li><li>I don’t have permission to use a specific feature</li><li>Where do I find training</li><li>Where do I find documentation</li><li>Who is my account rep</li></ul><h3>Customer General Support (Consumer Goods, Finance, Education, Hospitality, Healthcare, Telecom)</h3><ul><li>How do I use a feature of your product</li><li>Something on my product is not working</li><li>I need a replacement part</li><li>Set up auto pay</li><li>Pay a bill</li><li>Understand details of a bill</li><li>Transfer funds</li><li>Schedule an appointment</li><li>Make a reservation</li><li>Change my plan</li></ul><h3>Sales</h3><ul><li>Product comparison</li><li>Choosing the right product</li><li>Choosing products that work together</li><li>Determining how much to buy</li><li>Searching for a specific item</li><li>Adjusting contents of shopping cart</li><li>Payment information entry</li><li>Gift card and coupon entry</li><li>Multiple payment types for a purchase</li><li>Shipping instructions</li><li>Returning something</li><li>Exchanging something</li></ul><h3>&nbsp;Example of a ScreenMeet + Virtual Agent Flow</h3><ul><li>Bot: &nbsp;How Can I Help<ul><li>Customer: &nbsp;I can’t do, this is broke, where do I find, etc.</li></ul></li><li>Bot: &nbsp;AI Answer<ul><li>Customer: I still need help</li></ul></li><li>Bot: &nbsp;What would you like to do (show a subset of these based on use case)<ul><li>Chat with a human agent -&gt; &nbsp;chat</li><li>Have a video call with an agent -&gt; &nbsp;Live</li><li>Show my screen -&gt; &nbsp;Live</li><li>Record my question/issue -&gt; &nbsp;Replay</li><li>Have an agent fix my equipment –&gt; Remote Support</li><li>Shop with an agent -&gt; CoBrowse</li></ul></li></ul><h2>Conclusion</h2>By following the steps outlined in this documentation, you can optimize session creation for your agents. With a streamlined workflow, agents can quickly initiate sessions, saving valuable time. Now your chat setup should resemble the following example:Now, after completing the steps mentioned above, you can save your changes, activate your bot, and test it using the preview functionality within the bot builder.

Create Sessions directly with your chatbot

Customer initiated sessions with a chatbot

Getting Application from ServiceNow Store

Using your Azure Blob for ScreenMeet File Storage

Minimal Cobrowse Script

Frequently Asked Questions

Timeout Settings

July

Remote Control

IP Access Control Feature

Live Release Notes Q2 2024

Video Chat Integration

Cobrowse Settings

CoBrowse Release Notes Q2 23

Connecting to Mac devices

Connecting to a Device Using Beam

Windows Tools

Starting a session

CoBrowse Release Notes Q1 22

Remote Support Release Notes Q4 24

Clipboard

Release Summer 21 (1.14)

Virtual Agent Integration w/ ScreenMeet

Android SDK Quickstart

Security

Remote Support Release Notes Q3 23

Replay Settings

Custom Copy

CoBrowse Deployments

AI Summary History

Integration Signing Key

Microsoft D365 Release Notes Q4 2022

Replay Release Notes Q2 24

October

Live Settings

ScreenMeet Console Customers

Hosting a Desktop Session

Remote Support Release Notes Q2 23

Creating a Replay Recording

AI Assist Overview

Included Reports and how to add them into Dashboards

Custom Domain

Networking Configuration

AI Summarization

Remote Support

Overview

Remote Support Settings

CoBrowse Release Notes Q2 24

Sign in to console.screenmeet.com

Multiple Domain and Subdomain support

February

File Transfer Settings

Exporting ScreenMeet + Salesforce data to third party visualization tools

Beam Release Notes Q1 24

Regional Geo-Fencing

Custom Branding

AI Assist

Configure API service

Beam Release Notes Q3 23

Joining & Completing a Live Plus session

Egress IP Addresses

Custom URL

Starting a Session from within Salesforce

Settings and Policies

Requirements

How To Install ScreenMeet in Your Genesys Instance

Localization

Configuring Environment Variables

Reviewing a Session

August

Remote Support Release Notes Q1 23

Live Release Notes Q2 22

Release Summer 2020 (1.9)

Device Requirements

System Information

Create Multiple Sessions

ServiceNow Release Notes Q4 24

403 Forbidden while making API request

Manage Beam Group Permission Set

ScreenMeet Platform Release Notes Q3 23

Remote Support Release Notes - Q1 22

Screen Annotation

Creating a Session

Custom Background

Remote Support Release Notes Q2 24

AI Summary Studio

Instructions to Person at End Point Device

Beam Client: Installation, Deployment, and Configuration Guide

Beam Groups: Setup, Settings, and Access Management

Component settings

ScreenMeet 2024 Release Notes

Package Installation Error - Case-Case Layout: feedLayout is not supported for this layout

Developer Notes (3.0.11)

Starting a Session from Dynamics

ScreenMeet Platform Release Notes Q1 23

Remote Support Release Notes Q2 22