JOIN AGENT SESSION
                                                        This help page is for Studio. This information is also available for Desktop Studio.
| 
                                                                         
                                                                              | 
                                                                    
                                                                         An API action that joins an existing agent session.  | 
                                                                
Supported Script Types
| 
                                                                         
                                                                              | 
                                                                    
                                                                         
                                                                              | 
                                                                    
                                                                         
                                                                              | 
                                                                    
                                                                         
                                                                              | 
                                                                    
                                                                         
                                                                              | 
                                                                    
                                                                         
                                                                              | 
                                                                    
                                                                         
                                                                              | 
                                                                
| 
                                                                         Generic  | 
                                                                    Chat | Phone | Voicemail | Work Item | SMS | 
Input Properties
These properties define data that the action uses when executing.
| 
                                                                     Property  | 
                                                                
                                                                     Description  | 
                                                            
|---|---|
| 
                                                                     Add Caption  | 
                                                                
                                                                     Enter a short phrase that uniquely identifies this action in the script. The caption appears on the script canvas under the action icon.  | 
                                                            
| 
                                                                     Security User  | 
                                                                The output value of the SetSecurityUser action which authenticates a selected agent based on their permissions in the security profile. The default value is SecurityUser (same default output value of SetSecurityUser). You do not need to use curly brackets ( {} ) with this property. | 
| 
                                                                     Session Id  | 
                                                                The unique ID assigned to the agent's login session within the CXone Mpower system. | 
Result Branch Conditions
Result branch conditions allow you to create branches in your script to handle different outcomes when an action executes.
| 
                                                                     Condition  | 
                                                                
                                                                     Description  | 
                                                            
|---|---|
| 
                                                                     Default  | 
                                                                Path taken unless the script meets a condition that requires it to take one of the other branches. It is also taken if the action's other branches are not defined. | 
| Success | Path taken if the action completes without errors and any API calls or data returns were successful (2xx response codes). | 
| InvalidSecurityUser | Path taken when an invalid security user is used. | 
| InvalidAgentSession | Path taken if the Session Id entered is invalid. | 
| InvalidAgentId | The path taken when the agent ID is not valid. | 
| ImpersonateNotEnabled | 
                                                                     Path taken if impersonate is not enabled.  |