Show / Hide Table of Contents

Class CustomerServiceAgent

Proxy class for the CustomerService Agent Used when communicating remote using WebServices. Avoid using directly. Use the AgentFactory to create the proxy instead.

Inheritance
object
CustomerServiceAgent
Implements
ICustomerServiceAgent
IAgent
Inherited Members
object.ToString()
object.Equals(object)
object.Equals(object, object)
object.ReferenceEquals(object, object)
object.GetHashCode()
object.GetType()
object.MemberwiseClone()
Namespace: SuperOffice.CRM.Services
Assembly: SuperOffice.Services.Implementation.dll
Syntax
public class CustomerServiceAgent : ICustomerServiceAgent, IAgent

Constructors

CustomerServiceAgent(IChatSessionImplementation, ICsFeatureToggleImplementation, ICsSessionKeyImplementation, ICustomerCenterConfigImplementation, ICustomerServiceConfigImplementation, ICustomerServiceStartupImplementation, IEventDataImplementation, IMailboxImplementation, IMailboxEntityImplementation, IPreviewFaqEntryImplementation, IPreviewQuickReplyImplementation, IPreviewReplyTemplateImplementation, IReplyTemplateParsedImplementation, ISmsConfigImplementation, ISmtpTestResultImplementation, IStatisticsDataSetImplementation, ISystemTemplateSettingsImplementation, ITicketInfoImplementation, ISoRequestItemsAccessor)

Proxy class for the CustomerService Agent Used when communicating remote using WebServices. Avoid using directly. Use the AgentFactory to create the proxy instead.

Declaration
public CustomerServiceAgent(IChatSessionImplementation chatSessionImplementation, ICsFeatureToggleImplementation csFeatureToggleImplementation, ICsSessionKeyImplementation csSessionKeyImplementation, ICustomerCenterConfigImplementation customerCenterConfigImplementation, ICustomerServiceConfigImplementation customerServiceConfigImplementation, ICustomerServiceStartupImplementation customerServiceStartupImplementation, IEventDataImplementation eventDataImplementation, IMailboxImplementation mailboxImplementation, IMailboxEntityImplementation mailboxEntityImplementation, IPreviewFaqEntryImplementation previewFaqEntryImplementation, IPreviewQuickReplyImplementation previewQuickReplyImplementation, IPreviewReplyTemplateImplementation previewReplyTemplateImplementation, IReplyTemplateParsedImplementation replyTemplateParsedImplementation, ISmsConfigImplementation smsConfigImplementation, ISmtpTestResultImplementation smtpTestResultImplementation, IStatisticsDataSetImplementation statisticsDataSetImplementation, ISystemTemplateSettingsImplementation systemTemplateSettingsImplementation, ITicketInfoImplementation ticketInfoImplementation, ISoRequestItemsAccessor accessor)
Parameters
Type Name Description
IChatSessionImplementation chatSessionImplementation
ICsFeatureToggleImplementation csFeatureToggleImplementation
ICsSessionKeyImplementation csSessionKeyImplementation
ICustomerCenterConfigImplementation customerCenterConfigImplementation
ICustomerServiceConfigImplementation customerServiceConfigImplementation
ICustomerServiceStartupImplementation customerServiceStartupImplementation
IEventDataImplementation eventDataImplementation
IMailboxImplementation mailboxImplementation
IMailboxEntityImplementation mailboxEntityImplementation
IPreviewFaqEntryImplementation previewFaqEntryImplementation
IPreviewQuickReplyImplementation previewQuickReplyImplementation
IPreviewReplyTemplateImplementation previewReplyTemplateImplementation
IReplyTemplateParsedImplementation replyTemplateParsedImplementation
ISmsConfigImplementation smsConfigImplementation
ISmtpTestResultImplementation smtpTestResultImplementation
IStatisticsDataSetImplementation statisticsDataSetImplementation
ISystemTemplateSettingsImplementation systemTemplateSettingsImplementation
ITicketInfoImplementation ticketInfoImplementation
ISoRequestItemsAccessor accessor

CustomerServiceAgent(IChatSessionImplementation, ICsFeatureToggleImplementation, ICsSessionKeyImplementation, ICustomerCenterConfigImplementation, ICustomerServiceConfigImplementation, ICustomerServiceStartupImplementation, IEventDataImplementation, IMailboxImplementation, IMailboxEntityImplementation, IPreviewFaqEntryImplementation, IPreviewQuickReplyImplementation, IPreviewReplyTemplateImplementation, IReplyTemplateParsedImplementation, ISmsConfigImplementation, ISmtpTestResultImplementation, IStatisticsDataSetImplementation, ISystemTemplateSettingsImplementation, ITicketInfoImplementation, ISoRequestItemsAccessor, IDebugUser, IServiceCallsRepository, IScriptingConfiguration, IOnlineConfiguration)

Proxy class for the CustomerService Agent Used when communicating remote using WebServices. Avoid using directly. Use the AgentFactory to create the proxy instead.

Declaration
public CustomerServiceAgent(IChatSessionImplementation chatSessionImplementation, ICsFeatureToggleImplementation csFeatureToggleImplementation, ICsSessionKeyImplementation csSessionKeyImplementation, ICustomerCenterConfigImplementation customerCenterConfigImplementation, ICustomerServiceConfigImplementation customerServiceConfigImplementation, ICustomerServiceStartupImplementation customerServiceStartupImplementation, IEventDataImplementation eventDataImplementation, IMailboxImplementation mailboxImplementation, IMailboxEntityImplementation mailboxEntityImplementation, IPreviewFaqEntryImplementation previewFaqEntryImplementation, IPreviewQuickReplyImplementation previewQuickReplyImplementation, IPreviewReplyTemplateImplementation previewReplyTemplateImplementation, IReplyTemplateParsedImplementation replyTemplateParsedImplementation, ISmsConfigImplementation smsConfigImplementation, ISmtpTestResultImplementation smtpTestResultImplementation, IStatisticsDataSetImplementation statisticsDataSetImplementation, ISystemTemplateSettingsImplementation systemTemplateSettingsImplementation, ITicketInfoImplementation ticketInfoImplementation, ISoRequestItemsAccessor accessor, IDebugUser debugUser, IServiceCallsRepository serviceCallsRepository, ConfigFile.IScriptingConfiguration scriptingConfiguration, ConfigFile.IOnlineConfiguration onlineConfiguration)
Parameters
Type Name Description
IChatSessionImplementation chatSessionImplementation
ICsFeatureToggleImplementation csFeatureToggleImplementation
ICsSessionKeyImplementation csSessionKeyImplementation
ICustomerCenterConfigImplementation customerCenterConfigImplementation
ICustomerServiceConfigImplementation customerServiceConfigImplementation
ICustomerServiceStartupImplementation customerServiceStartupImplementation
IEventDataImplementation eventDataImplementation
IMailboxImplementation mailboxImplementation
IMailboxEntityImplementation mailboxEntityImplementation
IPreviewFaqEntryImplementation previewFaqEntryImplementation
IPreviewQuickReplyImplementation previewQuickReplyImplementation
IPreviewReplyTemplateImplementation previewReplyTemplateImplementation
IReplyTemplateParsedImplementation replyTemplateParsedImplementation
ISmsConfigImplementation smsConfigImplementation
ISmtpTestResultImplementation smtpTestResultImplementation
IStatisticsDataSetImplementation statisticsDataSetImplementation
ISystemTemplateSettingsImplementation systemTemplateSettingsImplementation
ITicketInfoImplementation ticketInfoImplementation
ISoRequestItemsAccessor accessor
IDebugUser debugUser
IServiceCallsRepository serviceCallsRepository
IScriptingConfiguration scriptingConfiguration
IOnlineConfiguration onlineConfiguration

Methods

AddMessageFromMailDataAsync(int, string, CancellationToken)

This method will add a message to an existing request in the sam way as importMail would do it from an email. It accepts RFC822 formatted data

Declaration
public Task<TicketInfo> AddMessageFromMailDataAsync(int ticketId, string data, CancellationToken cancellationToken = default)
Parameters
Type Name Description
int ticketId

The id of the ticket to add a message

string data

RFC822 formatted data to import as a message

CancellationToken cancellationToken

This operation cannot be cancelled; the cancellationToken parameter is ignored

Returns
Type Description
Task<TicketInfo>

An object containing some meta data for the ticket

ChatSessionsForUserAsync(CancellationToken)

Get all chat TOPICS which this user is a member of. Members means that you have at least one of: Can Respond, Notifications, Listen or Manager

Declaration
public Task<ChatSession[]> ChatSessionsForUserAsync(CancellationToken cancellationToken = default)
Parameters
Type Name Description
CancellationToken cancellationToken

This operation cannot be cancelled; the cancellationToken parameter is ignored

Returns
Type Description
Task<ChatSession[]>

Array of chat TOPIC ids the current user can access. NOT chat sessions.

CheckIfCustomizedTemplatesAsync(CancellationToken)

Checks whether the core html templates are customized

Declaration
public Task<bool> CheckIfCustomizedTemplatesAsync(CancellationToken cancellationToken = default)
Parameters
Type Name Description
CancellationToken cancellationToken

This operation cannot be cancelled; the cancellationToken parameter is ignored

Returns
Type Description
Task<bool>

True if the templates are customized

CheckSymmetricEncryptionAsync(string, CancellationToken)

Do a test to check that we are using the same encryption keys

Declaration
public Task<string> CheckSymmetricEncryptionAsync(string encryptedString, CancellationToken cancellationToken = default)
Parameters
Type Name Description
string encryptedString

An encrypted version of the string

CancellationToken cancellationToken

This operation cannot be cancelled; the cancellationToken parameter is ignored

Returns
Type Description
Task<string>

Encrypted version of the string done by NetServer

CreateDefaultCustomerCenterConfigAsync(CancellationToken)

Loading default values into a new CustomerCenterConfig.

Declaration
public Task<CustomerCenterConfig> CreateDefaultCustomerCenterConfigAsync(CancellationToken cancellationToken = default)
Parameters
Type Name Description
CancellationToken cancellationToken

This operation cannot be cancelled; the cancellationToken parameter is ignored

Returns
Type Description
Task<CustomerCenterConfig>

New CustomerCenterConfig with default values

CreateDefaultMailboxEntityAsync(CancellationToken)

Loading default values into a new MailboxEntity.

Declaration
public Task<MailboxEntity> CreateDefaultMailboxEntityAsync(CancellationToken cancellationToken = default)
Parameters
Type Name Description
CancellationToken cancellationToken

This operation cannot be cancelled; the cancellationToken parameter is ignored

Returns
Type Description
Task<MailboxEntity>

New MailboxEntity with default values

CreateSessionAsync(string, CancellationToken)

Creates a login session for a CS user

Declaration
public Task<CsSessionKey> CreateSessionAsync(string remoteIp, CancellationToken cancellationToken = default)
Parameters
Type Name Description
string remoteIp

The ip of the client creating the session

CancellationToken cancellationToken

This operation cannot be cancelled; the cancellationToken parameter is ignored

Returns
Type Description
Task<CsSessionKey>

The session key information

CreateTicketFromMailDataAsync(int, string, CancellationToken)

This method create a new ticket in the same way as importMail would import an email. It accepts RFC822 formatted data

Declaration
public Task<TicketInfo> CreateTicketFromMailDataAsync(int mailboxId, string data, CancellationToken cancellationToken = default)
Parameters
Type Name Description
int mailboxId

The id of the Service mailbox

string data

RFC822 formatted data to import as a ticket

CancellationToken cancellationToken

This operation cannot be cancelled; the cancellationToken parameter is ignored

Returns
Type Description
Task<TicketInfo>

An object containing some meta data for the created ticket

DeleteChatSessionsAsync(int[], CancellationToken)

Deletes the specified chat sessions.

Declaration
public Task DeleteChatSessionsAsync(int[] ids, CancellationToken cancellationToken = default)
Parameters
Type Name Description
int[] ids

The ids of the chat sessions to delete

CancellationToken cancellationToken

This operation cannot be cancelled; the cancellationToken parameter is ignored

Returns
Type Description
Task

This method has no return value

DeleteCustomerCenterConfigAsync(int, CancellationToken)

Deletes the CustomerCenterConfig

Declaration
public Task DeleteCustomerCenterConfigAsync(int customerCenterConfigId, CancellationToken cancellationToken = default)
Parameters
Type Name Description
int customerCenterConfigId

The identity of the CustomerCenterConfig

CancellationToken cancellationToken

This operation cannot be cancelled; the cancellationToken parameter is ignored

Returns
Type Description
Task

This method has no return value

EventHandlerExistsAsync(EventHandlerType, CancellationToken)

Check if an eventhandler exists for a given enum

Declaration
public Task<bool> EventHandlerExistsAsync(EventHandlerType eventHandlerType, CancellationToken cancellationToken = default)
Parameters
Type Name Description
EventHandlerType eventHandlerType

The EventHandlerType we are checking

CancellationToken cancellationToken

This operation cannot be cancelled; the cancellationToken parameter is ignored

Returns
Type Description
Task<bool>

True if it exists

EventHandlersExistsAsync(EventHandlerType[], CancellationToken)

Check if any given eventhandler exists

Declaration
public Task<EventHandlerType[]> EventHandlersExistsAsync(EventHandlerType[] eventHandlerTypes, CancellationToken cancellationToken = default)
Parameters
Type Name Description
EventHandlerType[] eventHandlerTypes

The EventHandlerTypes we are checking

CancellationToken cancellationToken

This operation cannot be cancelled; the cancellationToken parameter is ignored

Returns
Type Description
Task<EventHandlerType[]>

The existing event handlers

ExecuteEventHandlersAsync(EventData, CancellationToken)

This method will execute event handlers in CRMScript for a given event.

Declaration
public Task<EventData> ExecuteEventHandlersAsync(EventData eventData, CancellationToken cancellationToken = default)
Parameters
Type Name Description
EventData eventData

The EventData instance sent to the event handler

CancellationToken cancellationToken

This operation cannot be cancelled; the cancellationToken parameter is ignored

Returns
Type Description
Task<EventData>

The EventData instance after event handler execution

FindTicketsByTitleOrIdAsync(string, int, CancellationToken)

This method wil search for tickets matching title or id

Declaration
public Task<TicketInfo[]> FindTicketsByTitleOrIdAsync(string titleOrId, int maxRows, CancellationToken cancellationToken = default)
Parameters
Type Name Description
string titleOrId

The search string. If this is a number, it will also search for a matching ticket id

int maxRows

The maximum number of rows to be returned

CancellationToken cancellationToken

This operation cannot be cancelled; the cancellationToken parameter is ignored

Returns
Type Description
Task<TicketInfo[]>

An array of objects containing some meta data for matching tickets

GetAllCustomerCenterConfigsAsync(CancellationToken)

Get all rows from cust_config as an array of CustomerCenterConfig entities

Declaration
public Task<CustomerCenterConfig[]> GetAllCustomerCenterConfigsAsync(CancellationToken cancellationToken = default)
Parameters
Type Name Description
CancellationToken cancellationToken

This operation cannot be cancelled; the cancellationToken parameter is ignored

Returns
Type Description
Task<CustomerCenterConfig[]>

An array of CustomerCenterConfig entities

GetCustomerCenterConfigAsync(int, CancellationToken)

Gets a CustomerCenterConfig object.

Declaration
public Task<CustomerCenterConfig> GetCustomerCenterConfigAsync(int customerCenterConfigId, CancellationToken cancellationToken = default)
Parameters
Type Name Description
int customerCenterConfigId

The identifier of the CustomerCenterConfig object

CancellationToken cancellationToken

This operation cannot be cancelled; the cancellationToken parameter is ignored

Returns
Type Description
Task<CustomerCenterConfig>

A single CustomerCenterConfig

GetCustomerServiceStartupAsync(CancellationToken)

Get the carrier with data that Service needs when starting up

Declaration
public Task<CustomerServiceStartup> GetCustomerServiceStartupAsync(CancellationToken cancellationToken = default)
Parameters
Type Name Description
CancellationToken cancellationToken

This operation cannot be cancelled; the cancellationToken parameter is ignored

Returns
Type Description
Task<CustomerServiceStartup>

The carrier containing the startup data

GetCustomerServiceStartupByOwnerAsync(int, CancellationToken)

Get the carrier with data that Service needs when starting up for a specific user

Declaration
public Task<CustomerServiceStartup> GetCustomerServiceStartupByOwnerAsync(int userId, CancellationToken cancellationToken = default)
Parameters
Type Name Description
int userId

The user for which we want to fetch the startup values for

CancellationToken cancellationToken

This operation cannot be cancelled; the cancellationToken parameter is ignored

Returns
Type Description
Task<CustomerServiceStartup>

The carrier containing the startup data

GetFaqForCustomerAsync(int, CancellationToken)

Get a FAQ entry, ment to be displayed for a customer. This can either be a link to the FAQ entry on Custom Center, or it can be the answer and question. This is dependent on Registry setting with reg_id=157

Declaration
public Task<string> GetFaqForCustomerAsync(int faqEntryId, CancellationToken cancellationToken = default)
Parameters
Type Name Description
int faqEntryId

The id of the FAQ entry to get. Only FAQ entries with access level public (both for unauthenticated and autenticated customer) will be returned

CancellationToken cancellationToken

This operation cannot be cancelled; the cancellationToken parameter is ignored

Returns
Type Description
Task<string>

The FAQ to show to the customer. Either a clickable link or the question/answer itself.

GetMailboxEntityAsync(int, CancellationToken)

Gets a MailboxEntity object.

Declaration
public Task<MailboxEntity> GetMailboxEntityAsync(int mailboxEntityId, CancellationToken cancellationToken = default)
Parameters
Type Name Description
int mailboxEntityId

The identifier of the MailboxEntity object

CancellationToken cancellationToken

This operation cannot be cancelled; the cancellationToken parameter is ignored

Returns
Type Description
Task<MailboxEntity>

A single MailboxEntity

GetMailboxesAsync(CancellationToken)

This method will get all registered mailboxes in Service

Declaration
public Task<Mailbox[]> GetMailboxesAsync(CancellationToken cancellationToken = default)
Parameters
Type Name Description
CancellationToken cancellationToken

This operation cannot be cancelled; the cancellationToken parameter is ignored

Returns
Type Description
Task<Mailbox[]>

An array of Mailbox objects

GetParsedTemplateAsync(int, int, int, int, CancellationToken)

Get a specific langauge version of the reply template, and run this trough the parser

Declaration
public Task<ReplyTemplateParsed> GetParsedTemplateAsync(int replyTemplateId, int languageId, int personId, int ticketId, CancellationToken cancellationToken = default)
Parameters
Type Name Description
int replyTemplateId

The id of the reply template

int languageId

The language id (prefered language). If 0 is given, the language of the person will be used

int personId

The id of the person that will be populated into the parser

int ticketId

The id of the ticket that will be populated into the parser

CancellationToken cancellationToken

This operation cannot be cancelled; the cancellationToken parameter is ignored

Returns
Type Description
Task<ReplyTemplateParsed>

The parsed reply template

GetPreviewFaqEntryAsync(int, CancellationToken)

Get a faq entry from its faq entry id

Declaration
public Task<PreviewFaqEntry> GetPreviewFaqEntryAsync(int kbEntryId, CancellationToken cancellationToken = default)
Parameters
Type Name Description
int kbEntryId

FAQ entry ID

CancellationToken cancellationToken

This operation cannot be cancelled; the cancellationToken parameter is ignored

Returns
Type Description
Task<PreviewFaqEntry>

FAQ entry suitable for preview

GetPreviewQuickReplyAsync(int, CancellationToken)

Get a quick reply from its quick reply id

Declaration
public Task<PreviewQuickReply> GetPreviewQuickReplyAsync(int quickReplyId, CancellationToken cancellationToken = default)
Parameters
Type Name Description
int quickReplyId

Quick reply ID

CancellationToken cancellationToken

This operation cannot be cancelled; the cancellationToken parameter is ignored

Returns
Type Description
Task<PreviewQuickReply>

Quick reply suitable for preview

GetPreviewReplyTemplateAsync(int, CancellationToken)

Get a reply template from its reply template id

Declaration
public Task<PreviewReplyTemplate> GetPreviewReplyTemplateAsync(int replyTemplateId, CancellationToken cancellationToken = default)
Parameters
Type Name Description
int replyTemplateId

Reply template ID

CancellationToken cancellationToken

This operation cannot be cancelled; the cancellationToken parameter is ignored

Returns
Type Description
Task<PreviewReplyTemplate>

Reply template suitable for preview

GetProgramUrlAsync(string, bool, CancellationToken)

This method will convert a module name into a Service URL.

Declaration
public Task<string> GetProgramUrlAsync(string programName, bool external, CancellationToken cancellationToken = default)
Parameters
Type Name Description
string programName

In this parameter you must specify which CS program you want to create an URL for. Valid examples are "ticket", "rms", "spm" etc.

bool external

If set to true, this will generate URLs that are accesible from the outside (for example Internet)

CancellationToken cancellationToken

This operation cannot be cancelled; the cancellationToken parameter is ignored

Returns
Type Description
Task<string>

Returns a valid Service URL composed of the give parameters.

GetSmsConfigAsync(CancellationToken)

Get the SmsConfig settings for Customer Service sms providers.

Declaration
public Task<SmsConfig> GetSmsConfigAsync(CancellationToken cancellationToken = default)
Parameters
Type Name Description
CancellationToken cancellationToken

This operation cannot be cancelled; the cancellationToken parameter is ignored

Returns
Type Description
Task<SmsConfig>

Current SMS configuration.

GetStatisticsAsync(StatusScreenPanelType[], CancellationToken)

Returns the calculated results for the required statistics for the Customer Service Status Page

Declaration
public Task<StatisticsDataSet[]> GetStatisticsAsync(StatusScreenPanelType[] functions, CancellationToken cancellationToken = default)
Parameters
Type Name Description
StatusScreenPanelType[] functions

List of functions to calculate and return

CancellationToken cancellationToken

This operation cannot be cancelled; the cancellationToken parameter is ignored

Returns
Type Description
Task<StatisticsDataSet[]>

Array of StatisticsDataSet

GetSystemTemplateSettingsAsync(CancellationToken)

Returns system template settings

Declaration
public Task<SystemTemplateSettings> GetSystemTemplateSettingsAsync(CancellationToken cancellationToken = default)
Parameters
Type Name Description
CancellationToken cancellationToken

This operation cannot be cancelled; the cancellationToken parameter is ignored

Returns
Type Description
Task<SystemTemplateSettings>

System template settings item

GetUnparsedTemplateAsync(int, int, CancellationToken)

Get a specific langauge version of the reply template. No parsing is performed.

Declaration
public Task<ReplyTemplateParsed> GetUnparsedTemplateAsync(int replyTemplateId, int languageId, CancellationToken cancellationToken = default)
Parameters
Type Name Description
int replyTemplateId

The id of the reply template

int languageId

The language id (prefered language). If 0 is given, the language of the person will be used

CancellationToken cancellationToken

This operation cannot be cancelled; the cancellationToken parameter is ignored

Returns
Type Description
Task<ReplyTemplateParsed>

The unparsed reply template, but using the same return data structure

HasChatNotifyAsync(CancellationToken)

Check if user has any chat notification

Declaration
public Task<bool> HasChatNotifyAsync(CancellationToken cancellationToken = default)
Parameters
Type Name Description
CancellationToken cancellationToken

This operation cannot be cancelled; the cancellationToken parameter is ignored

Returns
Type Description
Task<bool>

True if the user has at least one notification setting on

RemoveSessionAsync(int, CancellationToken)

Remove a login session for a CS user

Declaration
public Task RemoveSessionAsync(int loginId, CancellationToken cancellationToken = default)
Parameters
Type Name Description
int loginId

The login id to remove

CancellationToken cancellationToken

This operation cannot be cancelled; the cancellationToken parameter is ignored

Returns
Type Description
Task

ReportSessionActiveAsync(string, CancellationToken)

Report a session as being 'active'; will update the corresponding row in login table, but not more than once per minute/session

Declaration
public Task<int> ReportSessionActiveAsync(string sessionKey, CancellationToken cancellationToken = default)
Parameters
Type Name Description
string sessionKey

CS session key, matching the 'login' table

CancellationToken cancellationToken

This operation cannot be cancelled; the cancellationToken parameter is ignored

Returns
Type Description
Task<int>

The ID of the login table row, or 0 if not found

SaveAllCustomerCenterConfigsAsync(CustomerCenterConfig[], CancellationToken)

Save an array of CustomerCenterConfig entities to the database

Declaration
public Task SaveAllCustomerCenterConfigsAsync(CustomerCenterConfig[] custConfigs, CancellationToken cancellationToken = default)
Parameters
Type Name Description
CustomerCenterConfig[] custConfigs

The CustomerCenterConfig entities to be saved. If the id does not exists, a new one will be created. Unknown ids will be skipped

CancellationToken cancellationToken

This operation cannot be cancelled; the cancellationToken parameter is ignored

Returns
Type Description
Task

void

SaveCustomerCenterConfigAsync(CustomerCenterConfig, CancellationToken)

Updates the existing CustomerCenterConfig or creates a new CustomerCenterConfig if the id parameter is 0.

Declaration
public Task<CustomerCenterConfig> SaveCustomerCenterConfigAsync(CustomerCenterConfig customerCenterConfig, CancellationToken cancellationToken = default)
Parameters
Type Name Description
CustomerCenterConfig customerCenterConfig

The CustomerCenterConfig that is saved

CancellationToken cancellationToken

This operation cannot be cancelled; the cancellationToken parameter is ignored

Returns
Type Description
Task<CustomerCenterConfig>

New or updated CustomerCenterConfig

SaveMailboxEntityAsync(MailboxEntity, CancellationToken)

Updates the existing MailboxEntity or creates a new MailboxEntity if the id parameter is 0.

Declaration
public Task<MailboxEntity> SaveMailboxEntityAsync(MailboxEntity mailboxEntity, CancellationToken cancellationToken = default)
Parameters
Type Name Description
MailboxEntity mailboxEntity

The MailboxEntity that is saved

CancellationToken cancellationToken

This operation cannot be cancelled; the cancellationToken parameter is ignored

Returns
Type Description
Task<MailboxEntity>

New or updated MailboxEntity

SaveSystemTemplateSettingsAsync(SystemTemplateSettings, CancellationToken)

Saves and validates updated system templates. Throws exception if validation fails

Declaration
public Task<SystemTemplateSettings> SaveSystemTemplateSettingsAsync(SystemTemplateSettings systemTemplateSettings, CancellationToken cancellationToken = default)
Parameters
Type Name Description
SystemTemplateSettings systemTemplateSettings

System template settings item with updated values

CancellationToken cancellationToken

This operation cannot be cancelled; the cancellationToken parameter is ignored

Returns
Type Description
Task<SystemTemplateSettings>

Updated system template settings

SessionIsValidAsync(string, CancellationToken)

Check if a CS session is valid

Declaration
public Task<bool> SessionIsValidAsync(string csSessionKey, CancellationToken cancellationToken = default)
Parameters
Type Name Description
string csSessionKey

The CS session key to check

CancellationToken cancellationToken

This operation cannot be cancelled; the cancellationToken parameter is ignored

Returns
Type Description
Task<bool>

True if there is a valid CS session based on the session key

TestSmtpServerAsync(string, string, bool, CancellationToken)

This method will do a test of a SMTP account, by sending an email to a special @superoffice.com account

Declaration
public Task<SmtpTestResult> TestSmtpServerAsync(string smtpUri, string from, bool useStoredPassword, CancellationToken cancellationToken = default)
Parameters
Type Name Description
string smtpUri

An URI containing information to connect to the SMTP server, eg. smtps://myuser:mypassword@smtp.myserver.com:465. Note that username and password must be url encoded

string from

The from-address used in the test

bool useStoredPassword

Use database persisted password

CancellationToken cancellationToken

This operation cannot be cancelled; the cancellationToken parameter is ignored

Returns
Type Description
Task<SmtpTestResult>

Contains the result of the test

UpdateFeatureTogglesAsync(CsFeatureToggle[], CancellationToken)

Update the cached FeatureToggles for CS

Declaration
public Task UpdateFeatureTogglesAsync(CsFeatureToggle[] featureToggles, CancellationToken cancellationToken = default)
Parameters
Type Name Description
CsFeatureToggle[] featureToggles

Feature toggle name / state

CancellationToken cancellationToken

This operation cannot be cancelled; the cancellationToken parameter is ignored

Returns
Type Description
Task

Implements

ICustomerServiceAgent
IAgent
© SuperOffice. All rights reserved.
SuperOffice |  Community |  Release Notes |  Privacy |  Site feedback |  Search Docs |  About Docs |  Contribute |  Back to top