Page tree

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: removed defunct 'localhost' option

The system's outbound email account is defined during the initial setup. By default, all outbound emails are sent from the system account. If you want certain tables to appear to send email from a different address, you can configure additional outbound accounts on a per-table basis. The outbound email configuration defines the characteristics of emails sent automatically from a table or manually by users from within the system.

Tip

Though you may add any number of custom outbound accounts, Agiloft's default system outbound account is always used for authentication and outgoing messages. If you add custom addresses, you must grant those addresses Send As permissions to send as the default account. For Microsoft integrations, see Microsoft's documentation for instructions. For Gmail integrations, see Google's documentation.

Outbound email configuration defines the default outbound addresses used for each table and some characteristics of emails sent by the system or manually by users from within the system. You must have a valid outbound email address when sending mail, or emails won't be sent. This is important to remember if you use a field value as the outbound address, rather than an explicit email address. Do not use a field value unless you can be sure that the field always has a value.

Additionally, emails won't be sent if they contain attachments that are cumulatively larger than the size defined in the Max Email Attach Size global variable or if the body of the email is larger than the size defined in the Max Email Body Size (without attachments) global variable. If an email is not sent due to the attachment or body size, the sender receives an error message. Similarly, even if an email's body size and attachments size falls within their respective limits, your email won't be successfully sent if its overall size (body and attachements) exceeds the limits set by your SMTP.

While hosting your knowledgebase on 

Companyname
 servers, you may elect to use "localhost" as your mail server; however, the spam score calculated and assigned to your mail by receiving servers will be worsened because the domain of the sending email address doesn't match the domain in the SMTP server name. Hosted servers do not support IP whitelisting, so if you need to whitelist 
Companyname
 servers, use a Sender Policy Framework (SPF) to do so.

Configuring Outbound Email

The Outbound Email wizard is used to set up outbound email options on a per-table basis. Those . The options can be inherited by subtables, so you may simply set up one set of options for each top-level table and it will apply the settings to all subtables.

Adding an Outbound Account

Follow these steps to configure an outbound email account:

  1. Go to Setup > Email and SMS > Configure Outbound Email
  2. On the Table tab, select a table.the table for which you want to add an outbound account.
  3. Click Next to configure From optionsNavigate through all the tabs listed belowRemember that your changes won't be saved until you click Finish on the final tab.

From Options

On this tab, select options for the source side of communications.

  1. Select which groups have access to the email icon on the action bar. Groups without access can still automatically generate emails through rules and workflow.
  2. Configure the default From address for system-generated emails. The From address defines the account the email originates from in the email header. Note that this can be any address, and it only gives the appearance of being sent from that sender to the recipient, whose response will be sent to the Reply-to address.
  3. Configure the default Reply-to address for system-generated emails. If an inbound email account is configured for this table, and responses should be mapped back to the appropriate record, set the Reply-To address to the table's inbound email address. When email recipients reply to system-generated emails, their replies are sent to this address, regardless of what appears in the From address. 
  4. Next, configure default From and Reply-to addresses for emails manually created by users. Depending on their permissions, users can override these default addresses manually with an explicit email address or a selected field linked to an email address. User list and email list fields display all fields of type Email or Email Pager in the current table , and also include fields that are linked to or copied from the Login or Full Name field of any sub-table of the Contacts table.

  5. Finally, configure the default From address for emails created in the EUI. Typically, users sending emails from the EUI should be using their own email addresses, so there is a separate default setting for them.
  6. Now that you have default From and Reply-to addresses for each scenario, set the address to send bounced emails to. If the system sends an email that bounces, the bounce notification can be forwarded to the address selected here. We recommend using a person related to the record, such as the Assigned Person, rather than sending it back to the table's incoming address because the bounce notification may strip out the encrypted ID in the subject line, which prevents it from being attached to the correct record.
  7. Configure which groups can see and change the From and Reply-to address for manual emails. In order to change the From or Reply-to field, users must also belong to a group that has view and edit permission to the corresponding field in the Communications table. This option is a way of turning off access to a particular table while leaving it enabled on others. 
  8. Click Next to configure To options.

To Options

On this tab, select options for the target side of communications.

  1. Define the default To field for the power and end user interfaces.
  2. Choose whether to include the original text when replying to an email.
  3. Select the formatting for the original quoted text, if it is included.
  4. Choose the default format, HTML or plain text, for outgoing emails.
  5. If desired, you can automatically CC or BCC other specified users whenever someone sends an email from this address.
  6. Select any fields you want to include by default in emails going out from this address. If you select any fields, also select how to interpret permissions when sending field contents:
    • All Fields includes all fields that the person sending the email has the right to view.
    • Based on Recipient's Access Permissions sends all fields that both the person sending the email and the person receiving it have the right to view. 
    • Selected Fields sends the fields selected in the box, provided the sender has view permissions
    Note

    If new email templates are created for this table, the templates will automatically include the chosen fields. Any existing email templates are not affected.

  7. The "Select Related Tables/Linked Sets to allow related record attachments" option lets you identify linked relationships with other tables, where it makes sense to offer files from those tables so they can be attached in the Send Email editor. For example, when emailing a Contract record to someone, you might want to attach a file from the Contract Attachments table. 

    Tip

    When setting up outbound email in a table for the first time, this drop-down list appears to be empty. After you complete the rest of the settings and click Finish, click Configure Outbound Email again, select the table, and return to the To Options tab to set up this feature.

    1. Select the related table or linked field that connects the current table to the table where the attached files are stored.

    2. Click Add Table.
    3. Then, next to the relationship you added, use the drop-down list to select the field that contains the file that should be attached to the email
    4. If you add the wrong relationship by mistake, select the checkbox next to it and click Remove Table.
  8. Choose whether the encrypted record ID is included in the subject line by default. This option can be overridden in a particular email template or by the user when sending manually. The ID is also encrypted in the email header, but adding it in the subject line can be useful as a backup in case a program removes the header information.
  9. Choose whether to include a hidden code in the email to allow truncating replies. Including this code won't automatically truncate replies, which is determined in the inbound email settings, but if you don't include this code, truncation won't be possible.
  10. If this outbound address often sends the same message to multiple people separately, with slight variations, you might want to enable the option to include a list of recipients in the email. If this is not a common practice, it's usually best to leave this disabled and use the standard CC line.
  11. If necessary, select "Send same email to all recipients" to enforce uniform messages. Note that with this checkbox selected, all email text is generated based on the first recipient in the To line, and that text is sent to all other recipients, including any $name variables and SSO hotlinks.
  12. Click Next to set up email marketing and tracking if desired.

Marketing

On this tab, set up marketing for emails if needed, with tracking of email bounces, click rates, and subscribe requests. For more information, see Email Marketing. If this outbound account won't be used for marketing communications, simply set the first option to No and click Finish.

...

  1. Set Enable Email Marketing on this table? to Yes or No. If you set this to Yes, additional options are enabled.
  2. Choose whether to track sent emails. If you select Yes, 
    Companyname
     automatically does the following:
    1. Adds a unique one-pixel image to emails. This allows the system to determine if the image was opened.
    2. Tracks if a user clicks on a hotlink to a record.
    3. Tracks bounced emails.
  3. Select the recipient email field and the email status field from the drop-down menus.
  4. Configure the Unsubscribe link that's added to each email. It's possible to disable this feature, but it is recommended for compliance with the CAN-SPAM law. If clicked, this updates the mapped email status field in both the user record and the communication record.
  5. If desired, specify an additional field to update when someone clicks the Unsubscribe link.
  6. Select the table that stores your marketing campaigns. When users send marketing emails, they must first select a particular campaign. These are stored in the Campaign table by default, and we recommend using that table because it already has reporting configured. If necessary, you can map to a different table and field here. The results are tracked in the Campaign table where each record corresponds to a campaign. The Email Results tab of the campaign shows the number of emails sent and the percent read, clicked on, and unsubscribed.
  7. If desired, select a filter to limit the campaigns available for selection. For example, you might use a filter so that users can only select active campaigns for outgoing emails.
  8. Click Finish.

If you want to configure accounts for additional tables, repeat the steps above.

Using Email Signatures

Setting You can set up email signatures allows and allow users to add preconfigured signature blocks into their emails and email templates.  Once Once signatures have been configured, they can be inserted from from Insert > Insert signature > Search... in the email editor, or by inserting $formula($global.my_signature_content) into an email template. Follow the steps below to configure signatures.

If your KB doesn't already have a Signature table:

...

  1. Go to Setup > Email and SMS.
  2. Click Communications Table Outbound Behavior.
  3. At the bottom, select Email Signatures.
  4. Under Name Field, select the Signature Name field.
  5. Under Content Field, select the Signature Content field.

...

If you use the 

Companyname
 email service, we recommend using Sender Policy Framework. SPF is an open standard that specifies a technical method to prevent sender address forgery, or spoofing. More specifically, the current version of SPF protects the envelope sender address, which is used for the delivery of messages. This allows the receiving mail servers to confirm and verify the authenticity of messages it receives to protect against malicious emails.

...

Companyname

...

Companyname

...

  1. .

...

SPF Records

To use SPF, you need to publish an SPF record into your domain's DNS. An SPF record is a type of DNS TXT record that contains host names and/or IP addresses authorized to send email via your domain. An example SPF record for the example.net domain may look like this:

example.net TXT "v=spf1 mx a:pluto.example.net include:aspmx.googlemail.com -all"

The parts of this SPF record mean the following:

  • v=spf1: The record uses SPF version 1.
  • mx: The incoming email servers (MXes) of the domain are authorized to also send email for example.net.
  • a:pluto.example.net: The machine pluto.example.net is authorized to send email.
  • include:aspmx.gmail.com: All email considered legitimate by gmail.com is also legitimate for example.net.
  • -all: All other machines are not authorized.

To whitelist all 

Companyname
 mail servers, add the following line to your SPF record:

include:spf.agiloft.com

You can test SPF records using online tools, such as MX Toolbox. For an example SPF record, you can view 

Companyname
's current SPF record using MX Toolbox. For more information about creating an SPF record and publishing into a DNS, contact your DNS provider, or see this page from DMARC.

Hide If
displayprintable

Content by Label
showLabelsfalse
max5
spacesPROD
showSpacefalse
sortmodified
reversetrue
typepage
cqllabel = "email" AND label not in ("graph","exchange","gmail","smtp") and label = "configure" and type = "page" and space = currentSpace()
labelsemail