Interface ChatBotModifier
ChatBot
- Since:
- 12.21
-
Method Summary
Modifier and TypeMethodDescriptionaddAssignedCategories
(Category... categories) Assign the passed categories to the chatbot.Get the current chatbot agentRoutingTimeout which is held in thisChatBotModifier
.Get the current chatbot botRoutingTimeout which is held in thisChatBotModifier
.Get the current categories assigned to the chatbot which are held in thisChatBotModifier
.Get the current chatbot description which is held in thisChatBotModifier
.Get the current chatbot inactivityTimeout which is held in thisChatBotModifier
.Get the current chatbot knowledgeBaseAgentName which is held in thisChatBotModifier
.getName()
Get the current chatbot name which is held in thisChatBotModifier
.Get the current chatbot nickname which is held in thisChatBotModifier
.Get the current chatbot restUrl which is held in thisChatBotModifier
.Get the current chatbot routeToAgentTimeout which is held in thisChatBotModifier
.Get the current chatbot tenant which is held in thisChatBotModifier
.boolean
Get the current chatbot enabled value which is held in thisChatBotModifier
.boolean
Get the current chatbot sendTypingEnabled value which is held in thisChatBotModifier
.removeAssignedCategories
(Category... categories) Remove the assignment the passed categories to the chatbot.setAgentRoutingTimeout
(Long agentRoutingTimeout) Change the agentRoutingTimeout of the associatedChatBot
.setBotRoutingTimeout
(Long botRoutingTimeout) Change the botRoutingTimeout of the associatedChatBot
.setDescription
(String description) Change the description of the associatedChatBot
.setEnabled
(boolean enabled) Change the enabled value of the associatedChatBot
.setInactivityTimeout
(Long inactivityTimeout) Change the inactivityTimeout of the associatedChatBot
.setKnowledgeBaseAgentName
(String knowledgeBaseAgentName) Change the knowledgeBaseAgentName of the associatedChatBot
.Change the name of the associatedChatBot
.setNickname
(String nickname) Change the nickname of the associatedChatBot
.setRestUrl
(String restUrl) Change the restUrl of the associatedChatBot
.setRouteToAgentTimeout
(Long routeToAgentTimeout) Change the routeToAgentTimeout of the associatedChatBot
.setSendTypingEnabled
(boolean sendTypingEnabled) Change the sendTypingEnabled value of the associatedChatBot
.Change the tenant of the associatedChatBot
.boolean
validateAgentRoutingTimeout
(Long agentRoutingTimeout) Validate the given agentRoutingTimeout.boolean
validateBotRoutingTimeout
(Long botRoutingTimeout) Validate the given botRoutingTimeout.boolean
validateEnabled
(boolean enabled) Validate the given enabled state.boolean
validateInactivityTimeout
(Long inactivityTimeout) Validate the given inactivityTimeout.boolean
validateKnowledgeBaseAgentName
(String knowledgeBaseAgentName) Validate the given knowledgeBaseAgentName.boolean
validateName
(String name) Validate the given name.boolean
validateNickname
(String nickname) Validate the given nickname.boolean
validateRestUrl
(String restUrl) Validate the given restUrl.boolean
validateRouteToAgentTimeout
(Long routeToAgentTimeout) Validate the given routeToAgentTimeout.boolean
validateSendTypingEnabled
(boolean sendTypingEnabled) Validate the given sendTypingEnabled state.boolean
validateTenant
(Tenant tenant) Validate the given tenant.
-
Method Details
-
getName
String getName()Get the current chatbot name which is held in thisChatBotModifier
.- Returns:
- the name as String
- Since:
- 12.21
-
setName
Change the name of the associated
ChatBot
.The change is applied after the
Modifier.write()
method is called.- Parameters:
name
- the new name as String- Returns:
- the
ChatBotModifier
- Throws:
ValidationException
- if the name is invalid- Since:
- 12.21
-
validateName
Validate the given name.- Parameters:
name
- the name to validate- Returns:
- true if the name is valid
- Throws:
ValidationException
- if the name is invalid- Since:
- 12.21
-
getDescription
String getDescription()Get the current chatbot description which is held in thisChatBotModifier
.- Returns:
- the description as String
- Since:
- 12.21
-
setDescription
Change the description of the associated
ChatBot
.The change is applied after the
Modifier.write()
method is called.- Parameters:
description
- the new description as String- Returns:
- the
ChatBotModifier
- Since:
- 12.21
-
isEnabled
boolean isEnabled()Get the current chatbot enabled value which is held in thisChatBotModifier
.- Returns:
- the enabled value as boolean
- Since:
- 12.21
-
setEnabled
Change the enabled value of the associated
ChatBot
.The change is applied after the
Modifier.write()
method is called.- Parameters:
enabled
- the new enabled value as boolean- Returns:
- the
ChatBotModifier
- Throws:
ValidationException
- if the change is invalid- Since:
- 12.21
-
validateEnabled
Validate the given enabled state.- Parameters:
enabled
- the new enabled state- Returns:
- true if the change is valid
- Throws:
ValidationException
- if the change is invalid- Since:
- 12.21
-
getTenant
Tenant getTenant()Get the current chatbot tenant which is held in thisChatBotModifier
.- Returns:
- the tenant as Tenant
- Since:
- 12.21
-
setTenant
Change the tenant of the associated
ChatBot
.The change is applied after the
Modifier.write()
method is called. If the tenant is set to null, all tenants are associated with the chatbot.- Parameters:
tenant
- the new tenant as Tenant- Returns:
- the
ChatBotModifier
- Throws:
ValidationException
- if the tenant is deleted or not persistent- Since:
- 12.21
-
validateTenant
Validate the given tenant.- Parameters:
tenant
- the tenant to validate- Returns:
- true if the tenant is valid (or null)
- Throws:
ValidationException
- if the tenant is deleted or not persistent- Since:
- 12.21
-
getNickname
String getNickname()Get the current chatbot nickname which is held in thisChatBotModifier
.- Returns:
- the nickname as String If no nickname is defined (empty string) the system setting or default nickname will be used.
- Since:
- 12.21
-
setNickname
Change the nickname of the associated
ChatBot
.If the nickname is set to an empty string the system setting or default nickname will be used. The change is applied after the
Modifier.write()
method is called.- Parameters:
nickname
- the new nickname as String- Returns:
- the
ChatBotModifier
- Throws:
ValidationException
- if the nickname is not valid- Since:
- 12.21
-
validateNickname
Validate the given nickname.- Parameters:
nickname
- the nickname to validate- Returns:
- true if the nickname is valid (or null)
- Throws:
ValidationException
- if the nickname is not valid- Since:
- 12.21
-
getRestUrl
String getRestUrl()Get the current chatbot restUrl which is held in thisChatBotModifier
.- Returns:
- the restUrl as String
- Since:
- 12.21
-
setRestUrl
Change the restUrl of the associated
ChatBot
.The change is applied after the
Modifier.write()
method is called.- Parameters:
restUrl
- the new restUrl as String- Returns:
- the
ChatBotModifier
- Throws:
ValidationException
- if the restUrl is not valid- Since:
- 12.21
-
validateRestUrl
Validate the given restUrl.- Parameters:
restUrl
- the restUrl to validate- Returns:
- true if the restUrl is valid
- Throws:
ValidationException
- if the restUrl is is not valid- Since:
- 12.21
-
getKnowledgeBaseAgentName
String getKnowledgeBaseAgentName()Get the current chatbot knowledgeBaseAgentName which is held in thisChatBotModifier
.- Returns:
- the knowledgeBaseAgentName as String If the returned value is an empty string, the default agent will be used.
- Since:
- 12.21
-
setKnowledgeBaseAgentName
Change the knowledgeBaseAgentName of the associated
ChatBot
.If the knowledgeBaseAgentName is set to an empty string, the default agent will be used. The change is applied after the
Modifier.write()
method is called.- Parameters:
knowledgeBaseAgentName
- the new knowledgeBaseAgentName as String- Returns:
- the
ChatBotModifier
- Throws:
ValidationException
- if the knowledgeBaseAgentName is not valid- Since:
- 12.21
-
validateKnowledgeBaseAgentName
Validate the given knowledgeBaseAgentName.- Parameters:
knowledgeBaseAgentName
- the knowledgeBaseAgentName to validate- Returns:
- true if the knowledgeBaseAgentName is valid (or null)
- Throws:
ValidationException
- if the knowledgeBaseAgentName is not valid- Since:
- 12.21
-
getInactivityTimeout
Long getInactivityTimeout()Get the current chatbot inactivityTimeout which is held in thisChatBotModifier
. The wait time that determines when inactive chatbot chats should be automatically closed.- Returns:
- the inactivityTimeout as Long or null, if the timeout is inactive
- Since:
- 12.21
-
setInactivityTimeout
Change the inactivityTimeout of the associated
ChatBot
.The change is applied after the
Modifier.write()
method is called. If the timeout is set to null, it will be inactive.- Parameters:
inactivityTimeout
- the new inactivityTimeout as Long in seconds- Returns:
- the
ChatBotModifier
- Throws:
ValidationException
- if timeout has negative value- Since:
- 12.21
-
validateInactivityTimeout
Validate the given inactivityTimeout.- Parameters:
inactivityTimeout
- the inactivityTimeout to validate- Returns:
- true if the inactivityTimeout is valid
- Throws:
ValidationException
- if timeout has negative value- Since:
- 12.21
-
getRouteToAgentTimeout
Long getRouteToAgentTimeout()Get the current chatbot routeToAgentTimeout which is held in thisChatBotModifier
. If a previous customer chat was assigned to an agent, a following chat from the same customer will get routed to an agent in this time period- Returns:
- the routeToAgentTimeout as Long or null, if the timeout is inactive
- Since:
- 12.21
-
setRouteToAgentTimeout
Change the routeToAgentTimeout of the associated
ChatBot
.The change is applied after the
Modifier.write()
method is called. If the timeout is set to null, it will be inactive.- Parameters:
routeToAgentTimeout
- the new routeToAgentTimeout as Long in seconds- Returns:
- the
ChatBotModifier
- Throws:
ValidationException
- if timeout has negative value- Since:
- 12.21
-
validateRouteToAgentTimeout
Validate the given routeToAgentTimeout.- Parameters:
routeToAgentTimeout
- the routeToAgentTimeout to validate- Returns:
- true if the routeToAgentTimeout is valid
- Throws:
ValidationException
- if timeout has negative value- Since:
- 12.21
-
getBotRoutingTimeout
Long getBotRoutingTimeout()Get the current chatbot botRoutingTimeout which is held in thisChatBotModifier
. Determines the wait time for a chatbot that is no longer reachable before it gets rerouted to an agent.- Returns:
- the botRoutingTimeout as Long or null, if the timeout is inactive
- Since:
- 12.21
-
setBotRoutingTimeout
Change the botRoutingTimeout of the associated
ChatBot
.The change is applied after the
Modifier.write()
method is called. If the timeout is set to null, it will be inactive.- Parameters:
botRoutingTimeout
- the new botRoutingTimeout as Long in seconds- Returns:
- the
ChatBotModifier
- Throws:
ValidationException
- if timeout has negative value- Since:
- 12.21
-
validateBotRoutingTimeout
Validate the given botRoutingTimeout.- Parameters:
botRoutingTimeout
- the botRoutingTimeout to validate- Returns:
- true if the botRoutingTimeout is valid
- Throws:
ValidationException
- if timeout negative value- Since:
- 12.21
-
getAgentRoutingTimeout
Long getAgentRoutingTimeout()Get the current chatbot agentRoutingTimeout which is held in thisChatBotModifier
. If no agent accepts the chat which was handed over by the chatbot within the specified timeframe, the chat will be returned to the chatbot.- Returns:
- the agentRoutingTimeout as Long or null, if the timeout is inactive
- Since:
- 12.21
-
setAgentRoutingTimeout
Change the agentRoutingTimeout of the associated
ChatBot
.The change is applied after the
Modifier.write()
method is called. If the timeout is set to null, it will be inactive.- Parameters:
agentRoutingTimeout
- the new agentRoutingTimeout as Long in seconds- Returns:
- the
ChatBotModifier
- Throws:
ValidationException
- if timeout has negative value- Since:
- 12.21
-
validateAgentRoutingTimeout
Validate the given agentRoutingTimeout.- Parameters:
agentRoutingTimeout
- the agentRoutingTimeout to validate- Returns:
- true if the agentRoutingTimeout is valid
- Throws:
ValidationException
- if timeout has negative value- Since:
- 12.21
-
isSendTypingEnabled
boolean isSendTypingEnabled()Get the current chatbot sendTypingEnabled value which is held in thisChatBotModifier
.- Returns:
- the sendTypingEnabled value as boolean
- Since:
- 12.21
-
setSendTypingEnabled
Change the sendTypingEnabled value of the associated
ChatBot
.The change is applied after the
Modifier.write()
method is called.- Parameters:
sendTypingEnabled
- the new sendTypingEnabled value as boolean- Returns:
- the
ChatBotModifier
- Throws:
ValidationException
- if the change is invalid- Since:
- 12.21
-
validateSendTypingEnabled
Validate the given sendTypingEnabled state.- Parameters:
sendTypingEnabled
- the new sendTypingEnabled state- Returns:
- true if the change is valid
- Throws:
ValidationException
- if the change is invalid- Since:
- 12.21
-
getCategories
Get the current categories assigned to the chatbot which are held in thisChatBotModifier
.- Returns:
- the categories as a list of type Category
- Since:
- 12.21
-
addAssignedCategories
Assign the passed categories to the chatbot.
The change is applied after the
Modifier.write()
method is called.- Parameters:
categories
- the categories the chatbot should be assigned to- Returns:
- the
ChatBotModifier
- Throws:
ValidationException
- if a category is null- Since:
- 12.21
-
removeAssignedCategories
Remove the assignment the passed categories to the chatbot.
The change is applied after the
Modifier.write()
method is called.- Parameters:
categories
- the categories for which the assignment should be removed- Returns:
- the
ChatBotModifier
- Throws:
ValidationException
- if a category is null- Since:
- 12.21
-