Cordial Email

The following channel-specific fields are shown for Cordial email channels:

General Tab

      Re-subscribe contacts: as per Salesforce Marketing Cloud email channel.

Channel Specific Tab

      Recipient email: as per Salesforce Marketing Cloud email channel.

The following properties are exposed within the Service Credentials section:

      Service URL: this mandatory text property allows you to specify the API service URL used to connect to the Cordial service.  It defaults to the value 'https://api.cordial.io', and accepts a maximum of 1000 characters.

      API key: this mandatory, password-masked text field is also used when connecting to Cordial.  It accepts a maximum of 100 characters.

The following properties are exposed within the Suppressions section:

      Auto-suppress: as per Salesforce Marketing Cloud email channel.

      Custom suppression table: as per Salesforce Marketing Cloud email channel.

      Suppression table name: as per Salesforce Marketing Cloud email channel.

The following properties are exposed within the Audience Export Settings section:

      Export location: this dropdown field exposes values 'External Content Provider' (the default) and 'FTP Location'.  It allows you to specify the export location to which exported files will be uploaded.

      Export external folder: this property is only displayed when Export location is set to 'External Content Provider'.  When displayed, you must select an RPI external folder (AWS S3 or Google Cloud Storage only).

      Export FTP location: this property is only displayed when Export location is set to 'FTP Location'.  When displayed, you must select an RPI FTP location.

      Custom Cordial contact FTP: this checkbox, which is unchecked by default, is displayed if Export location is set to 'FTP Location'.  If checked, you can override the contact export FTP location settings used by Cordial.

      Transport type: this dropdown property is enabled when Custom Cordial contact FTP is checked.  It allows you to specify the type of transport to be used to connect to the FTP server.  A dropdown list, it exposes values 'SFTP' (the default - used to establish a secure connection) and 'FTP'.

      Host name: this mandatory text property is enabled when Custom Cordial contact FTP is checked.  It allows you to specify a host name to be used when connecting to the Cordial FTP server.  The property is empty by default.

      Host port number: this mandatory integer property is also enabled when Custom Cordial contact FTP is checked.  It is used in conjunction with Host name, and allows you to specify a port number to be used when connecting to the Cordial FTP server.  The property defaults to the value '22'.

      Login username: this mandatory text property is enabled when Custom Cordial contact FTP is checked.  It allows you to specify a user name to be used when connecting to the Cordial FTP server.

      Login password: this mandatory, password-masked field is enabled when Custom Cordial contact FTP is checked.  It is used in conjunction with Login username when connecting to the Cordial FTP server.

      Folder path: this mandatory text property is enabled when Custom Cordial contact FTP is checked.  It allows you to specify a folder path where contact CSV files are to be uploaded at Cordial.

      Account list: this property is only enabled when Cordial credentials have been provided.  It allows you to select an account list, as configured at Cordial.  Having chosen an account list, you can clear your selection.

      Batch export: this checkbox is unchecked by default.  If checked, the batching of records to be exported to the specified export external folder is enabled.

      Max. export batch size: this mandatory numeric property defaults to 1000, and accepts a range of values from 1000 to 500,000.  It allows you to specify the maximum number of contact records that can be written to an exported file.

The following properties are exposed within the Audience Activity Import Settings section:

      Email events location: this this dropdown field exposes values 'External Content Provider' (the default) and 'FTP Location'.  It allows you to specify the export location to which imported files will be uploaded.

      Import external folder: this property is only displayed when Email events location is set to 'External Content Provider'.  When displayed, you must select an RPI external folder (AWS S3 or Google Cloud Storage only).

      Import FTP location: this property is only displayed when Email events location is set to 'FTP Location'.  When displayed, you must select an RPI FTP location.

      Custom Cordial event FTP: this checkbox, which is unchecked by default, is displayed if Email events location is set to 'FTP Location'.  If checked, you can override the event export FTP location settings used by Cordial.

      Transport type: this dropdown property is enabled when Custom Cordial event FTP is checked.  It allows you to specify the type of transport to be used to connect to the FTP server.  A dropdown list, it exposes values 'SFTP' (the default - used to establish a secure connection) and 'FTP'.

      Host name: this mandatory text property is enabled when Custom Cordial event FTP is checked.  It allows you to specify a host name to be used when connecting to the Cordial FTP server.  The property is empty by default.

      Host port number: this mandatory integer property is also enabled when Custom Cordial event FTP is checked.  It is used in conjunction with Host name, and allows you to specify a port number to be used when connecting to the Cordial FTP server.  The property defaults to the value '22'.

      Login username: this mandatory text property is enabled when Custom Cordial event FTP is checked.  It allows you to specify a user name to be used when connecting to the Cordial FTP server.

      Login password: this mandatory, password-masked field is enabled when Custom Cordial event FTP is checked.  It is used in conjunction with Login username when connecting to the Cordial FTP server.

      Folder path: this mandatory text property is enabled when Custom Cordial event FTP is checked.  It allows you to specify a folder path where event CSV files are to be uploaded at Cordial.

      Max. email events batch size: this mandatory numeric property defaults to 1000, and accepts a range of values from 10 to 500,000.  It allows you to specify the maximum number of contact records that can be written to an exported file.

The following properties are exposed within the Miscellaneous section:

      Custom subscriber key: this property is optional unless a custom primary key has been enabled at Cordial.  It allows you to select a database column attribute with a name exactly matching that of the Cordial primary custom field.  If an attribute is not specified, the default Email Address will be used as the primary key.

      Message classification: this dropdown property allows you to specify the type of message classification to use when creating Cordial email message templates.  It exposes values 'Promotional' (the default) and 'Transactional'.

      Request timeout: as per SendGrid email channel.

      Monitor import job timeout:  this numeric property is set to 60 by default, and accepts a range of values from 15 to 1,440.  It represents a timeout period, in minutes, for which RPI will monitor for the completion of an import job.

      Max send thresholds: this numeric property, which defaults to 10, and which accepts a range of values from 1 to 30, allows you to specify the maximum number of concurrent connections that will be used to send emails.

Web Adapters Tab

All types of web adapters are supported.

Advanced Tab

      External folder: as per Acoustic email channel.

      Enable trace: as per SendGrid email channel.

      API call max. re-try: this integer property defaults to 10, and accepts a range of values from 5 to 60.  It represents the number of retry attempts to be undertaken if a call to the provider's API fails.

      Move hashtags to end of URL: as per Salesforce Marketing Cloud email channel.