Interface IAgent
- All Superinterfaces:
IDisposable, IEntity
Represents an agent.
-
Method Summary
Modifier and TypeMethodDescriptionvoidRegisters the AgentInCampaignCanOpenListener.voidRegisters the AgentInCampaignsOperationEndedListener.voidRegisters the AgentInCampaignsOperationRequestListener.voidaddAgentMessageListener(AgentMessageListener listener) Registers the AgentMessageListener.voidRegisters the AgentMessageOfTheDayChangedListener.voidaddCustomDataListener(CustomDataListener listener) Registers the CustomDataListener.voidaddEmailErrorListener(EmailErrorListener listener) Registers the EmailErrorListener.voidRegisters the ExtensionChangedListener.voidRegisters the ExtensionClearedListener.voidaddGatewayListener(GatewayListener listener) Registers the GatewayListener.voidRegisters the IncomingSessionListener.voidRegisters the LoginGroupChangedListener.voidRegisters the NotReadyReasonsChangedListener.voidRegisters the SkillsChangedListener.voidaddSocialErrorListener(SocialErrorListener listener) Registers the SocialErrorListener.voidaddTeamMessageListener(TeamMessageListener listener) Registers the TeamMessageListener.voidRegisters the TeamMessageOfTheDayChangedListener.voidRegisters the WorkflowErrorListener.intagentInCampaignsOperation(String[] campaignNames, AgentInCampaignOperation operation, boolean setAgentUnavailable, String notReadyReason) Executes the required operations to evolve the state of the agent in a set of campaigns, to a target state.getAgentInCampaignById(int campaignId) Gets the agent assigned to the specified campaign.getAgentInCampaignByName(String campaignName) Gets the agent assigned to the specified campaign.int[]Campaign ids assigned to the agent.String[]Campaign names assigned to the agent.Campaigns assigned to the agent.Represents the operations that the agent can perform on uAgent.String[]Gets the names of the assigned teams of the agent.Default extension of the agent.Default site name of the agent.Current extension of the agent.Switch type of the current extension of the agent.booleanIf true, the default extension is forced.Full name of the agent.intgetId()Identifier of the agent.Identifier of the agent in the external authentication provider.String with the agent ID in the switch.getInfo()Gets information about the agent.Instance associated to the agent.booleanSwitch supervisor option.Login group in which the agent is logged in the switch.Login message of the day for the agent.getName()User name of the agent.booleanIftrue, all calls of the agent will be recorded.booleanIftrue, all screens of the agent will be recorded.getSession(int sessionId) Gets the session associated with the specified identifier.ISession[]Active sessions of an agent.Site name of the agent or an empty string.SoftPhone object used to interact with the soft phone component.Status of the agent.Message of the day for the team where the agent is assigned.Team name of the agent or an empty string.getType()Type of the agent.getUrl()Gets the URL of the Agent object in the IntegrationServer.Gets global information about the agent in the campaigns.getWorkingInCampaignsMedia(int mediaId) Gets media information about the agent in the campaigns.Retrieves the workstation of the agent.instantMessagingConnect(String agentName, String campaignName, boolean synchronous) Creates an instant messaging interaction in a new session.instantMessagingConnectMedia(int mediaId, String agentName, String campaignName, boolean synchronous) Creates an instant messaging interaction in a new session.instantMessagingConnectMediaToAddress(int mediaId, String fromAddress, String toAddress, String campaignName, boolean synchronous) Creates an instant messaging interaction in a new session.Makes a phone call in a new session.phoneDial(String agentName, String number, boolean usesDoNotCallList, String uniqueIdInDoNotCallList, boolean synchronous) Makes a phone call in a new session.phoneDialMedia(int mediaId, String agentName, String number, boolean usesDoNotCallList, boolean synchronous) Makes a phone call in a new session.phoneDialMedia(int mediaId, String agentName, String number, boolean usesDoNotCallList, String uniqueIdInDoNotCallList, boolean synchronous) Makes a phone call in a new session.voidphoneHangUp(boolean synchronous) Hangs up the phone call.voidpickUpEmail(int interactionId, boolean synchronous) Picks up an email.voidpickUpSocial(int interactionId, boolean synchronous) Picks up a social.voidpickUpWorkflowTask(int taskId, boolean synchronous) Picks up an workflow task.voidUnregisters the AgentInCampaignCanOpenListener.voidUnregisters the AgentInCampaignsOperationEndedListener.voidUnregisters the AgentInCampaignsOperationRequestListener.voidUnregisters the AgentMessageListener.voidUnregisters the AgentMessageOfTheDayChangedListener.voidremoveCustomDataListener(CustomDataListener listener) Unregisters the CustomDataListener.voidremoveEmailErrorListener(EmailErrorListener listener) Unregisters the EmailErrorListener.voidUnregisters the ExtensionChangedListener.voidUnregisters the ExtensionClearedListener.voidremoveGatewayListener(GatewayListener listener) Unregisters the GatewayListener.voidUnregisters the IncomingSessionListener.voidUnregisters the LoginGroupChangedListener.voidUnregisters the NotReadyReasonsChangedListener.voidUnregisters the SkillsChangedListener.voidremoveSocialErrorListener(SocialErrorListener listener) Unregisters the SocialErrorListener.voidremoveTeamMessageListener(TeamMessageListener listener) Unregisters the TeamMessageListener.voidUnregisters the TeamMessageOfTheDayChangedListener.voidUnregisters the WorkflowErrorListener.voidsetExtension(String extension) Changes the extension of the agent.voidsetLoginContext(String siteName, String teamName) Changes the site and team of the agent.voidsupervise(String agentName, SupervisionMode supervisionMode) Allows a supervisor to issue supervision requests either after an agent asks for help or spontaneously.tryGetAgentInCampaignById(int campaignId) Gets the agent assigned to the specified campaign or null if the campaign does not exist.tryGetAgentInCampaignByName(String campaignName) Gets the agent assigned to the specified campaign or null if the campaign does not exist.tryGetSession(int sessionId) Gets the session associated with the specified identifier or null if the session does not exist.vBoxListen(String listeningPrefix, String number, boolean synchronous) Listens to an extension or to a QRP in a VBox.Methods inherited from interface IDisposable
addDisposedListener, removeDisposedListenerMethods inherited from interface IEntity
getUserContext, setUserContext
-
Method Details
-
addAgentInCampaignCanOpenListener
Registers the AgentInCampaignCanOpenListener.- Parameters:
listener- Event listener to add.
-
removeAgentInCampaignCanOpenListener
Unregisters the AgentInCampaignCanOpenListener.- Parameters:
listener- Event listener to remove.
-
addAgentInCampaignsOperationEndedListener
Registers the AgentInCampaignsOperationEndedListener.- Parameters:
listener- Event listener to add.
-
removeAgentInCampaignsOperationEndedListener
Unregisters the AgentInCampaignsOperationEndedListener.- Parameters:
listener- Event listener to remove.
-
addAgentInCampaignsOperationRequestListener
Registers the AgentInCampaignsOperationRequestListener.- Parameters:
listener- Event listener to add.
-
removeAgentInCampaignsOperationRequestListener
void removeAgentInCampaignsOperationRequestListener(AgentInCampaignsOperationRequestListener listener) Unregisters the AgentInCampaignsOperationRequestListener.- Parameters:
listener- Event listener to remove.
-
addAgentMessageListener
Registers the AgentMessageListener.- Parameters:
listener- Event listener to add.
-
removeAgentMessageListener
Unregisters the AgentMessageListener.- Parameters:
listener- Event listener to remove.
-
addAgentMessageOfTheDayChangedListener
Registers the AgentMessageOfTheDayChangedListener.- Parameters:
listener- Event listener to add.
-
removeAgentMessageOfTheDayChangedListener
Unregisters the AgentMessageOfTheDayChangedListener.- Parameters:
listener- Event listener to remove.
-
addCustomDataListener
Registers the CustomDataListener.- Parameters:
listener- Event listener to add.
-
removeCustomDataListener
Unregisters the CustomDataListener.- Parameters:
listener- Event listener to remove.
-
addEmailErrorListener
Registers the EmailErrorListener.- Parameters:
listener- Event listener to add.
-
removeEmailErrorListener
Unregisters the EmailErrorListener.- Parameters:
listener- Event listener to remove.
-
addExtensionChangedListener
Registers the ExtensionChangedListener.- Parameters:
listener- Event listener to add.
-
removeExtensionChangedListener
Unregisters the ExtensionChangedListener.- Parameters:
listener- Event listener to remove.
-
addExtensionClearedListener
Registers the ExtensionClearedListener.- Parameters:
listener- Event listener to add.
-
removeExtensionClearedListener
Unregisters the ExtensionClearedListener.- Parameters:
listener- Event listener to remove.
-
addGatewayListener
Registers the GatewayListener.- Parameters:
listener- Event listener to add.
-
removeGatewayListener
Unregisters the GatewayListener.- Parameters:
listener- Event listener to remove.
-
addIncomingSessionListener
Registers the IncomingSessionListener.- Parameters:
listener- Event listener to add.
-
removeIncomingSessionListener
Unregisters the IncomingSessionListener.- Parameters:
listener- Event listener to remove.
-
addLoginGroupChangedListener
Registers the LoginGroupChangedListener.- Parameters:
listener- Event listener to add.
-
removeLoginGroupChangedListener
Unregisters the LoginGroupChangedListener.- Parameters:
listener- Event listener to remove.
-
addNotReadyReasonsChangedListener
Registers the NotReadyReasonsChangedListener.- Parameters:
listener- Event listener to add.
-
removeNotReadyReasonsChangedListener
Unregisters the NotReadyReasonsChangedListener.- Parameters:
listener- Event listener to remove.
-
addSkillsChangedListener
Registers the SkillsChangedListener.- Parameters:
listener- Event listener to add.
-
removeSkillsChangedListener
Unregisters the SkillsChangedListener.- Parameters:
listener- Event listener to remove.
-
addSocialErrorListener
Registers the SocialErrorListener.- Parameters:
listener- Event listener to add.
-
removeSocialErrorListener
Unregisters the SocialErrorListener.- Parameters:
listener- Event listener to remove.
-
addTeamMessageListener
Registers the TeamMessageListener.- Parameters:
listener- Event listener to add.
-
removeTeamMessageListener
Unregisters the TeamMessageListener.- Parameters:
listener- Event listener to remove.
-
addTeamMessageOfTheDayChangedListener
Registers the TeamMessageOfTheDayChangedListener.- Parameters:
listener- Event listener to add.
-
removeTeamMessageOfTheDayChangedListener
Unregisters the TeamMessageOfTheDayChangedListener.- Parameters:
listener- Event listener to remove.
-
addWorkflowErrorListener
Registers the WorkflowErrorListener.- Parameters:
listener- Event listener to add.
-
removeWorkflowErrorListener
Unregisters the WorkflowErrorListener.- Parameters:
listener- Event listener to remove.
-
agentInCampaignsOperation
int agentInCampaignsOperation(String[] campaignNames, AgentInCampaignOperation operation, boolean setAgentUnavailable, String notReadyReason) throws Exception, altitude.integrationServer.exceptions.ISException Executes the required operations to evolve the state of the agent in a set of campaigns, to a target state.- Parameters:
campaignNames- Name of the campaigns to update. Ifnullthen the operation is executed in all campaigns assigned to the agent.operation- Operation that identifies the target state. Examples: if operation is SetReady, then Open, SignOn, SetReady operations are executed if required; if operation is Open and the agent already is Ready in a campaign, then the state of the agent will not be updated in this campaign.setAgentUnavailable- Iftruethe agent will be unavailable to receive interactions while the state of the agent on the campaigns is being updated to "ready" or "not ready", in order to guarantee interactions with higher priority are delivered first.notReadyReason- Not ready reason used to set the agent not ready when operation isSetNotReady.- Returns:
- The identifier of the operation to correlate with the
AgentInCampaignsOperationEndedEvent.OperationId - Throws:
Exceptionaltitude.integrationServer.exceptions.ISException
-
getAgentInCampaignById
IAgentInCampaign getAgentInCampaignById(int campaignId) throws Exception, altitude.integrationServer.exceptions.ISException Gets the agent assigned to the specified campaign.- Parameters:
campaignId- Identifier of the campaign.- Returns:
- The
IAgentInCampaignobject. - Throws:
Exceptionaltitude.integrationServer.exceptions.ISException
-
getAgentInCampaignByName
IAgentInCampaign getAgentInCampaignByName(String campaignName) throws Exception, altitude.integrationServer.exceptions.ISException Gets the agent assigned to the specified campaign.- Parameters:
campaignName- Name of the campaign.- Returns:
- The
IAgentInCampaignobject. - Throws:
Exceptionaltitude.integrationServer.exceptions.ISException
-
getAgentInCampaignIds
-
getAgentInCampaignNames
-
getAgentInCampaigns
IAgentInCampaign[] getAgentInCampaigns() throws Exception, altitude.integrationServer.exceptions.ISExceptionCampaigns assigned to the agent.- Throws:
Exceptionaltitude.integrationServer.exceptions.ISException
-
getAllowedOperations
AgentCanDo getAllowedOperations() throws Exception, altitude.integrationServer.exceptions.ISExceptionRepresents the operations that the agent can perform on uAgent.- Throws:
Exceptionaltitude.integrationServer.exceptions.ISException
-
getAssignedTeamNames
-
getDefaultExtension
-
getDefaultSiteName
-
getExtension
-
getExtensionSwitchType
SwitchType getExtensionSwitchType() throws Exception, altitude.integrationServer.exceptions.ISExceptionSwitch type of the current extension of the agent.- Throws:
Exceptionaltitude.integrationServer.exceptions.ISException
-
getForceDefaultExtension
-
getFullName
-
getId
-
getIdInExternalProvider
-
getIdInSwitch
-
getInfo
-
getInstance
-
getIsSwitchSupervisor
-
getLoginGroup
-
getMessageOfTheDay
-
getName
-
getRecordAllCalls
-
getRecordAllScreens
-
getSession
ISession getSession(int sessionId) throws Exception, altitude.integrationServer.exceptions.ISException Gets the session associated with the specified identifier.- Parameters:
sessionId- Session identifier.- Returns:
- The
ISessionobject. - Throws:
Exceptionaltitude.integrationServer.exceptions.ISException
-
getSessions
-
getSiteName
-
getSoftPhone
SoftPhone object used to interact with the soft phone component.- Throws:
Exceptionaltitude.integrationServer.exceptions.ISException
-
getStatus
Status of the agent.- Throws:
Exceptionaltitude.integrationServer.exceptions.ISException
-
getTeamMessageOfTheDay
-
getTeamName
-
getType
-
getWorkingInCampaigns
AgentInCampaignInfo[] getWorkingInCampaigns() throws Exception, altitude.integrationServer.exceptions.ISExceptionGets global information about the agent in the campaigns.- Throws:
Exceptionaltitude.integrationServer.exceptions.ISException
-
getWorkingInCampaignsMedia
AgentInCampaignMediaInfo[] getWorkingInCampaignsMedia(int mediaId) throws Exception, altitude.integrationServer.exceptions.ISException Gets media information about the agent in the campaigns.- Parameters:
mediaId- Identifier of the media.- Returns:
- The array of
AgentInCampaignMediaInfoobjects. - Throws:
Exceptionaltitude.integrationServer.exceptions.ISException
-
getWorkstation
-
instantMessagingConnect
ISession instantMessagingConnect(String agentName, String campaignName, boolean synchronous) throws Exception, altitude.integrationServer.exceptions.ISException Creates an instant messaging interaction in a new session.- Parameters:
agentName- Name of the agent.campaignName- Name of the campaign.synchronous- If true, the method is synchronous.- Returns:
- An
ISessionobject with the new session. - Throws:
Exceptionaltitude.integrationServer.exceptions.ISException
-
instantMessagingConnectMedia
ISession instantMessagingConnectMedia(int mediaId, String agentName, String campaignName, boolean synchronous) throws Exception, altitude.integrationServer.exceptions.ISException Creates an instant messaging interaction in a new session.- Parameters:
mediaId- Identifier of the media.agentName- Name of the agent.campaignName- Name of the campaign.synchronous- If true, the method is synchronous.- Returns:
- An
ISessionobject with the new session. - Throws:
Exceptionaltitude.integrationServer.exceptions.ISException
-
instantMessagingConnectMediaToAddress
ISession instantMessagingConnectMediaToAddress(int mediaId, String fromAddress, String toAddress, String campaignName, boolean synchronous) throws Exception, altitude.integrationServer.exceptions.ISException Creates an instant messaging interaction in a new session.- Parameters:
mediaId- Identifier of the media.fromAddress- Address of the sender. The value must match a dnis configured in the InstantMessaging gateway assigned to the target campaign, and an entry point configured in the Media Channels Service.toAddress- Address of the contact. This parameter is only taked into consideration ifagentNameis null.campaignName- Name of the campaign.synchronous- If true, the method is synchronous.- Returns:
- An
ISessionobject with the new session. - Throws:
Exceptionaltitude.integrationServer.exceptions.ISException
-
phoneDial
ISession phoneDial(String agentName, String number, boolean usesDoNotCallList, boolean synchronous) throws Exception, altitude.integrationServer.exceptions.ISException Makes a phone call in a new session.- Parameters:
agentName- Name of the agent.number- Phone number to dial.usesDoNotCallList- If true, the do not call list is used.synchronous- If true, the method is synchronous.- Returns:
- An
ISessionobject with the new session. - Throws:
Exceptionaltitude.integrationServer.exceptions.ISException
-
phoneDial
ISession phoneDial(String agentName, String number, boolean usesDoNotCallList, String uniqueIdInDoNotCallList, boolean synchronous) throws Exception, altitude.integrationServer.exceptions.ISException Makes a phone call in a new session.- Parameters:
agentName- Name of the agent.number- Phone number to dial.usesDoNotCallList- If true, the do not call list is used.uniqueIdInDoNotCallList- Unique identifier of the contact profile to look in the do not call list. This parameter is optional, and will only be considered ifusesDoNotCallListis true.synchronous- If true, the method is synchronous.- Returns:
- An
ISessionobject with the new session. - Throws:
Exceptionaltitude.integrationServer.exceptions.ISException
-
phoneDialMedia
ISession phoneDialMedia(int mediaId, String agentName, String number, boolean usesDoNotCallList, boolean synchronous) throws Exception, altitude.integrationServer.exceptions.ISException Makes a phone call in a new session.- Parameters:
mediaId- Identifier of the media.agentName- Name of the agent.number- Phone number to dial.usesDoNotCallList- If true, the do not call list is used.synchronous- If true, the method is synchronous.- Returns:
- An
ISessionobject with the new session. - Throws:
Exceptionaltitude.integrationServer.exceptions.ISException
-
phoneDialMedia
ISession phoneDialMedia(int mediaId, String agentName, String number, boolean usesDoNotCallList, String uniqueIdInDoNotCallList, boolean synchronous) throws Exception, altitude.integrationServer.exceptions.ISException Makes a phone call in a new session.- Parameters:
mediaId- Identifier of the media.agentName- Name of the agent.number- Phone number to dial.usesDoNotCallList- If true, the do not call list is used.uniqueIdInDoNotCallList- Unique identifier of the contact profile to look in the do not call list. This parameter is optional, and will only be considered ifusesDoNotCallListis true.synchronous- If true, the method is synchronous.- Returns:
- An
ISessionobject with the new session. - Throws:
Exceptionaltitude.integrationServer.exceptions.ISException
-
phoneHangUp
-
pickUpEmail
void pickUpEmail(int interactionId, boolean synchronous) throws Exception, altitude.integrationServer.exceptions.ISException Picks up an email.- Parameters:
interactionId- Identifier of the interaction.synchronous- If true, the method is synchronous.- Throws:
Exceptionaltitude.integrationServer.exceptions.ISException
-
pickUpSocial
void pickUpSocial(int interactionId, boolean synchronous) throws Exception, altitude.integrationServer.exceptions.ISException Picks up a social.- Parameters:
interactionId- Identifier of the interaction.synchronous- If true, the method is synchronous.- Throws:
Exceptionaltitude.integrationServer.exceptions.ISException
-
pickUpWorkflowTask
void pickUpWorkflowTask(int taskId, boolean synchronous) throws Exception, altitude.integrationServer.exceptions.ISException Picks up an workflow task.- Parameters:
taskId- Identifier of the workflow task.synchronous- If true, the method is synchronous.- Throws:
Exceptionaltitude.integrationServer.exceptions.ISException
-
setExtension
-
setLoginContext
void setLoginContext(String siteName, String teamName) throws Exception, altitude.integrationServer.exceptions.ISException Changes the site and team of the agent.- Parameters:
siteName- Site name of the agent.teamName- Team name of the agent.- Throws:
Exceptionaltitude.integrationServer.exceptions.ISException
-
supervise
void supervise(String agentName, SupervisionMode supervisionMode) throws Exception, altitude.integrationServer.exceptions.ISException Allows a supervisor to issue supervision requests either after an agent asks for help or spontaneously. Currently this feature is only available when using Alcatel OXE- Parameters:
agentName- Name of the agent to supervise.supervisionMode- Mode of supervison request.- Throws:
Exceptionaltitude.integrationServer.exceptions.ISException
-
tryGetAgentInCampaignById
IAgentInCampaign tryGetAgentInCampaignById(int campaignId) throws Exception, altitude.integrationServer.exceptions.ISException Gets the agent assigned to the specified campaign or null if the campaign does not exist.- Parameters:
campaignId- Identifier of the campaign.- Returns:
- The
IAgentInCampaignobject. - Throws:
Exceptionaltitude.integrationServer.exceptions.ISException
-
tryGetAgentInCampaignByName
IAgentInCampaign tryGetAgentInCampaignByName(String campaignName) throws Exception, altitude.integrationServer.exceptions.ISException Gets the agent assigned to the specified campaign or null if the campaign does not exist.- Parameters:
campaignName- Name of the campaign.- Returns:
- The
IAgentInCampaignobject. - Throws:
Exceptionaltitude.integrationServer.exceptions.ISException
-
tryGetSession
ISession tryGetSession(int sessionId) throws Exception, altitude.integrationServer.exceptions.ISException Gets the session associated with the specified identifier or null if the session does not exist.- Parameters:
sessionId- Session identifier.- Returns:
- The
ISessionobject. - Throws:
Exceptionaltitude.integrationServer.exceptions.ISException
-
vBoxListen
ISession vBoxListen(String listeningPrefix, String number, boolean synchronous) throws Exception, altitude.integrationServer.exceptions.ISException Listens to an extension or to a QRP in a VBox.- Parameters:
listeningPrefix- Listening prefix.number- Phone number to listen.synchronous- If true, the method is synchronous.- Returns:
- An
ISessionobject with the session. - Throws:
Exceptionaltitude.integrationServer.exceptions.ISException
-
getUrl
-