Cisco Cisco Computer Telephony Integration Option 8.5 Developer's Guide

Page of 500
   
4-30
CTI OS Developer’s Guide for Cisco Unified ICM/Contact Center Enterprise & Hosted
Release 7.5(1)
Chapter 4      Building Your Application
Logging In and Logging Out an Agent
{
  m_ctiSession->Disconnect();
}
Logging In and Logging Out an Agent
How to Log In an Agent
When the connection to the CTIOS Server is established and the mode set, you log in the agent. 
Note
Before attempting to log in an agent, you would typically request global configuration data, in order 
to correctly handle a duplicate log in attempt. For more information, see the section 
To log in the agent, in the SetAgentModeEvent() event:
Step 1
Create an instance of the Arguments class.
Step 2
Set log in values for the agent in the Arguments instance.
Note
The properties required for the agent depend on the type of ACD you are using. The following 
example demonstrates the required properties for Unified CC.
Step 3
Log in the agent.
The following example, which assumes the Agent object has been created, demonstrates this task in Java:
public void SetAgentMode(Arguments rArgs) {
 /* 1. Create Arguments object*/
 Arguments rArgs = new Arguments();
 /
* 2. Set log in values.*/
 rArgs.SetValue(CtiOs_IKeywordIDs.CTIOS_AGENTID, “275”);
 rArgs.SetValue(CtiOs_IKeywordIDs.CTIOS_PERIPHERALID, “5002”);
 rArgs.SetValue(CtiOs_IKeywordIDs.CTIOS_AGENTINSTRUMENT, “5002”)
 rArgs.SetValue(CtiOs_IKeywordIDs.CTIOS_AGENTPASSWORD, “********”);
 rArgs.SetValue(CtiOs_IKeywordIDs.CTIOS_AUTOLOGIN, “1”);
 /* 3. Log in the agent.*/
 int returnValue = agent.Login(rArgs);
}
Note
It is the client application’s responsibility to keep track of whether the log in attempt is the first 
attempt, or during failover, and branch accordingly in the SetAgentMode() event to avoid calling the 
Login() method during failover.
The Login() method generates the following events:
QueryAgentStateConf()
AgentStateEvent(), if the agent is unknown or is logged out.