Interface IMarketingAgent
Namespace: SuperOffice.WebApi.AgentsAssembly: SuperOffice.WebApi.dll Agent used for Marketing functions, such as Forms
Implements
IAgentBase, IDisposableMethods
CalculateMailingStatisticsAsync(int, RequestOptions)
Calculate open and click rates for one or more mailingsParameters
shipmentId int
If 0, calculate rates for all dirty (are_statistics_dirty) shipments
requestOptions RequestOptions
Override language/culture codes on this request.
Returns
Task<int> Number of shipments updated with calculated statisticsCreateDefaultAvailableFontAsync(RequestOptions)
Create an return an empty fontParameters
requestOptions RequestOptions
Override language/culture codes on this request.
Returns
Task<AvailableFont> Returns the created default fontCreateDefaultFormEntityAsync(RequestOptions)
Set default values into a new FormEntity. NetServer calculates default values on the entity, which is required when creating/storing a new instanceParameters
requestOptions RequestOptions
Override language/culture codes on this request.
Returns
Task<FormEntity> A blank FormEntityCreateDefaultFormSubmissionEntityAsync(RequestOptions)
Set default values into a new FormSubmissionEntity. NetServer calculates default values on the entity, which is required when creating/storing a new instanceParameters
requestOptions RequestOptions
Override language/culture codes on this request.
Returns
Task<FormSubmissionEntity> A blank FormSubmissionEntityCreateDefaultMailingEntityAsync(RequestOptions)
Set default values into a new MailingEntity. NetServer calculates default values on the entity, which is required when creating/storing a new instanceParameters
requestOptions RequestOptions
Override language/culture codes on this request.
Returns
Task<MailingEntity> A blank MailingEntityCreateDefaultShipmentMessageBlockEntityAsync(RequestOptions)
Set default values into a new ShipmentMessageBlockEntity. NetServer calculates default values on the entity, which is required when creating/storing a new instanceParameters
requestOptions RequestOptions
Override language/culture codes on this request.
Returns
Task<ShipmentMessageBlockEntity> A blank ShipmentMessageBlockEntityCreateDefaultShipmentMessageEntityAsync(RequestOptions)
Set default values into a new ShipmentMessageEntity. NetServer calculates default values on the entity, which is required when creating/storing a new instanceParameters
requestOptions RequestOptions
Override language/culture codes on this request.
Returns
Task<ShipmentMessageEntity> A blank ShipmentMessageEntityDeleteAvailableFontAsync(int, RequestOptions)
Delete the font with the provided idParameters
availableFontId int
The id of the font to delete
requestOptions RequestOptions
Override language/culture codes on this request.
Returns
Task<bool> Returns true if the font was deletedDeleteFormEntityAsync(int, RequestOptions)
Deletes the FormEntityParameters
formEntityId int
The identity of the FormEntity
requestOptions RequestOptions
Override language/culture codes on this request.
Returns
TaskDeleteFormSubmissionEntityAsync(int, RequestOptions)
Deletes the FormSubmissionEntityParameters
formSubmissionEntityId int
The identity of the FormSubmissionEntity
requestOptions RequestOptions
Override language/culture codes on this request.
Returns
TaskDeleteMailingEntityAsync(int, RequestOptions)
Deletes the MailingEntityParameters
mailingEntityId int
The identity of the MailingEntity
requestOptions RequestOptions
Override language/culture codes on this request.
Returns
TaskDeleteMessageAndShipmentAsync(int, RequestOptions)
Delete the message and the shipment the message (MessageId) belongs toParameters
messageId int
Message id
requestOptions RequestOptions
Override language/culture codes on this request.
Returns
TaskDeleteShipmentMessageBlockEntityAsync(int, RequestOptions)
Deletes the ShipmentMessageBlockEntityParameters
shipmentMessageBlockEntityId int
The identity of the ShipmentMessageBlockEntity
requestOptions RequestOptions
Override language/culture codes on this request.
Returns
TaskDeleteShipmentMessageEntityAsync(int, RequestOptions)
Deletes the ShipmentMessageEntityParameters
shipmentMessageEntityId int
The identity of the ShipmentMessageEntity
requestOptions RequestOptions
Override language/culture codes on this request.
Returns
TaskGetAvailableFontAsync(int, RequestOptions)
Get an available font by idParameters
availableFontId int
The id of the font to retrieve
requestOptions RequestOptions
Override language/culture codes on this request.
Returns
Task<AvailableFont> Returns the requested font or null if it does not existGetFormEntityAsync(int, RequestOptions)
Gets a specific FormEntity object.Parameters
formEntityId int
The identifier of the FormEntity object
requestOptions RequestOptions
Override language/culture codes on this request.
Returns
Task<FormEntity> FormEntityGetFormSubmissionEntityAsync(int, RequestOptions)
Gets a specific FormSubmissionEntity object.Parameters
formSubmissionEntityId int
The identifier of the FormSubmissionEntity object
requestOptions RequestOptions
Override language/culture codes on this request.
Returns
Task<FormSubmissionEntity> FormSubmissionEntityGetFormSubmissionsCountAsync(int, FormSubmissionStatus, RequestOptions)
Get counnt of submissions for given form and status. Count for all forms is returned if negative formId is givenParameters
formId int
If 0 or less, return count for all forms
status FormSubmissionStatus
Which status the submissions should have. If Unknown, return count of all statuses
requestOptions RequestOptions
Override language/culture codes on this request.
Returns
Task<int> Number of formsubmissionsGetMailingEntityAsync(int, RequestOptions)
Gets a specific MailingEntity object.Parameters
mailingEntityId int
The identifier of the MailingEntity object
requestOptions RequestOptions
Override language/culture codes on this request.
Returns
Task<MailingEntity> MailingEntityGetPreviewMailingAsync(int, RequestOptions)
Get a shipment message from its shipment address idParameters
shipmentAddrId int
Shipment address id
requestOptions RequestOptions
Override language/culture codes on this request.
Returns
Task<PreviewMailing> PreviewMailingGetPreviewMailingHeaderAsync(int, RequestOptions)
Get a shipment from its shipment idParameters
shipmentId int
Shipment id
requestOptions RequestOptions
Override language/culture codes on this request.
Returns
Task<PreviewMailingHeader> PreviewMailingHeaderGetShipmentMessageBlockEntityAsync(int, RequestOptions)
Gets a specific ShipmentMessageBlockEntity object.Parameters
shipmentMessageBlockEntityId int
The identifier of the ShipmentMessageBlockEntity object
requestOptions RequestOptions
Override language/culture codes on this request.
Returns
Task<ShipmentMessageBlockEntity> ShipmentMessageBlockEntityGetShipmentMessageEntityAsync(int, RequestOptions)
Gets a specific ShipmentMessageEntity object.Parameters
shipmentMessageEntityId int
The identifier of the ShipmentMessageEntity object
requestOptions RequestOptions
Override language/culture codes on this request.
Returns
Task<ShipmentMessageEntity> ShipmentMessageEntityGetUserBlocksAsync(int, RequestOptions)
Get the saved user blocks to be used in a shipment/mailing messageParameters
associateId int
The associate id to get the user blocks. 0 will get all saved blocks
requestOptions RequestOptions
Override language/culture codes on this request.
Returns
Task<ShipmentMessageBlockEntity[]> An array of user blocksMoveFormsToFolderAsync(int[], int, RequestOptions)
Move one or more forms into the given folder. FolderId -1 = root. Only the folder reference is written - Save would rewrite the whole form, including a re-sanitized Config, and would bump Updated (the thumbnail cache-buster).Parameters
formIds int[]
Ids of the forms to move (form.form_id)
folderId int
Target folder id (s_picture_folder.id, formFolder type); -1 = root
requestOptions RequestOptions
Override language/culture codes on this request.
Returns
TaskMoveMailingsToFolderAsync(int[], int, RequestOptions)
Move one or more mailings (shipments) into the given folder. FolderId -1 = root.Parameters
mailingIds int[]
Shipment ids of the mailings to move (s_shipment.id)
folderId int
Target folder id (s_picture_folder.id, shipmentFolder type); -1 = root
requestOptions RequestOptions
Override language/culture codes on this request.
Returns
TaskReloadAndSendMailingAsync(int, RequestOptions)
Reload and send a mailingParameters
mailingId int
Mailing id
requestOptions RequestOptions
Override language/culture codes on this request.
Returns
Task<bool> Did the operation succeed?RenameMailingByMessageIdAsync(int, string, RequestOptions)
Change the mailing name (shipment description) that the given message (MessageId) belongs toParameters
messageId int
Message id
name string
The new name
requestOptions RequestOptions
Override language/culture codes on this request.
Returns
TaskSaveAvailableFontAsync(AvailableFont, RequestOptions)
Saves the font and returns it with correct rankParameters
font AvailableFont
The font to save
requestOptions RequestOptions
Override language/culture codes on this request.
Returns
Task<AvailableFont> Returns the saved font with correct rankSaveFormEntityAsync(FormEntity, RequestOptions)
Updates the existing FormEntity or creates a new FormEntity if the id parameter is 0.Parameters
formEntity FormEntity
The FormEntity that is saved.
requestOptions RequestOptions
Override language/culture codes on this request.
Returns
Task<FormEntity> New or updated FormEntitySaveFormSubmissionEntityAsync(FormSubmissionEntity, RequestOptions)
Updates the existing FormSubmissionEntity or creates a new FormSubmissionEntity if the id parameter is 0.Parameters
formSubmissionEntity FormSubmissionEntity
The FormSubmissionEntity that is saved.
requestOptions RequestOptions
Override language/culture codes on this request.
Returns
Task<FormSubmissionEntity> New or updated FormSubmissionEntitySaveMailingEntityAsync(MailingEntity, RequestOptions)
Updates the existing MailingEntity or creates a new MailingEntity if the id parameter is 0.Parameters
mailingEntity MailingEntity
The MailingEntity that is saved.
requestOptions RequestOptions
Override language/culture codes on this request.
Returns
Task<MailingEntity> New or updated MailingEntitySaveShipmentMessageBlockEntityAsync(ShipmentMessageBlockEntity, RequestOptions)
Updates the existing ShipmentMessageBlockEntity or creates a new ShipmentMessageBlockEntity if the id parameter is 0.Parameters
shipmentMessageBlockEntity ShipmentMessageBlockEntity
The ShipmentMessageBlockEntity that is saved.
requestOptions RequestOptions
Override language/culture codes on this request.
Returns
Task<ShipmentMessageBlockEntity> New or updated ShipmentMessageBlockEntitySaveShipmentMessageEntityAsync(ShipmentMessageEntity, RequestOptions)
Updates the existing ShipmentMessageEntity or creates a new ShipmentMessageEntity if the id parameter is 0.Parameters
shipmentMessageEntity ShipmentMessageEntity
The ShipmentMessageEntity that is saved.
requestOptions RequestOptions
Override language/culture codes on this request.
Returns
Task<ShipmentMessageEntity> New or updated ShipmentMessageEntitySetAllFormFieldRestrictionsAsync(FormFieldRestriction[], RequestOptions)
Sets the list of form field restrictions. Note: This list is the conclusion of what should exist in the table. Restrictions that already exists in the table are edited, new ones are added, and if they are not in this list, they will be deletedParameters
formFieldRestrictions FormFieldRestriction[]
All the restrictions to set. Restrictions not included, will be deleted
requestOptions RequestOptions
Override language/culture codes on this request.
Returns
TaskSetFontRankAsync(int, int, RequestOptions)
Set the rank on the font and reorder the rest of the fonts accordinglyParameters
availableFontId int
The id of the available font to set the rank on
rank int
The new rank to set on the font
requestOptions RequestOptions
Override language/culture codes on this request.
Returns
Task<bool> Returns true if the new rank on the font and surrounding reranks went wellVerifyGoogleRecaptchaAsync(string, string, RequestOptions)
This method will try to verify a Google recaptcha token. The token is gained from the recaptcha frontend componentParameters
token string
The token to be verified
optionalSecretKey string
Use an optional secret key instead of the system wide
requestOptions RequestOptions
Override language/culture codes on this request.