# Mail

The *E-mail* notification provider in BuildingPro Suites enables the configuration and management of email notifications to send alarms and other notifications via an email system.

<div data-full-width="true"><figure><img src="https://3489494878-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9GvUpaatBiReR43XFSMg%2Fuploads%2F9bfnbdfcu7gtPSs3WGna%2Femail.png?alt=media&#x26;token=21a7db7b-9509-4ec4-b8fb-57e4ff07a374" alt=""><figcaption></figcaption></figure></div>

## Configuration

Navigate to: **Engineering → Notifications Providers → E-mail**

In the view **\[A]**, the following options are available:

<table data-full-width="true"><thead><tr><th width="66.19998168945312">No.</th><th width="219">Field / Option</th><th>Description</th></tr></thead><tbody><tr><td>A1</td><td>Note</td><td>Internal note for this configuration.</td></tr><tr><td>A2</td><td>Host</td><td>SMTP server via which emails are sent.</td></tr><tr><td>A3</td><td>Sender Name</td><td>Name that is displayed as the sender in emails.</td></tr><tr><td>A4</td><td>Sender Email</td><td>Email address that is used as the sender.</td></tr><tr><td>A5</td><td>Authentication required</td><td>Activate/deactivate whether SMTP authentication is used.</td></tr><tr><td>A6</td><td>User</td><td>Username / email address for SMTP authentication.</td></tr><tr><td>A7</td><td>Password</td><td>Password for SMTP authentication.</td></tr><tr><td>A8</td><td>Port</td><td>Port of the SMTP server (e.g. 25, 465, or 587).</td></tr><tr><td>A9</td><td>Pool</td><td>Activates sending via an SMTP pool.</td></tr><tr><td>A10</td><td>Secure</td><td>Activates the use of a secure connection (STARTTLS/SSL).</td></tr><tr><td>A11</td><td>Strict SSL/TLS</td><td>Enforces a strict SSL/TLS connection.</td></tr><tr><td>A12</td><td>Rate Limit</td><td>Maximum allowed number of emails per defined interval.</td></tr><tr><td>A13</td><td>Rate Delta</td><td>Time interval for the rate limit in seconds.</td></tr><tr><td>A14</td><td>Max Connections</td><td>Maximum number of simultaneous SMTP connections.</td></tr><tr><td>A15</td><td>Save</td><td>Apply changes to the configuration.</td></tr></tbody></table>

{% hint style="info" %}
Make sure that the SMTP server is set up correctly, otherwise no emails can be sent.
{% endhint %}

## E-mail Templates

BuildingPro Suites allows you to customize individual email templates for various notifications. This applies not only to **alarm emails** but also to ***Ticket Email Content*** and ***Password Reset Email Content***. By customizing these templates, you can optimally tailor the design, style, and content of your emails to your needs.

Click on <img src="https://3489494878-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9GvUpaatBiReR43XFSMg%2Fuploads%2FEbbuNfEueICryAY1kvFh%2Fimage.png?alt=media&#x26;token=a29e66fc-95f3-4311-a2c4-a6af063ec2df" alt="" data-size="line"> on the right in the **Template \[C]** to edit a pre-built template.

<div data-full-width="true"><figure><img src="https://3489494878-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9GvUpaatBiReR43XFSMg%2Fuploads%2FA6YY7ErPJXIzWSKMzxoa%2Femail%20(1).png?alt=media&#x26;token=20c8a198-cb5b-40f7-8357-fa3f7a984fa2" alt=""><figcaption></figcaption></figure></div>

### Override standard

To customize the selected template, select the **Override standard \[D]** option. This allows you to make individual changes to the template instead of using the standard template.

### Change email subject

Once the **"Override standard"** option is activated, you can customize the subject of the email **\[E]**. Enter an individual subject here that will be used for all future alarm emails.

◈ *Only alarm variables can be used in the email subject:*[ → Alarm Template](/collection/academy/twig-templating-in-eliona.md#alarm-template): Available Variables.\
▷ *The subject of ticket and password reset emails is fixed and cannot be changed.*

### Edit format & style

{% hint style="info" %}
You can find which variables can be specifically customized here: [↗ Templates](/collection/academy/twig-templating-in-eliona.md)
{% endhint %}

Under **Alarm Email Content \[F]**, **Ticket Email Content**, or **Password Reset Email Content**, you can edit the HTML code of the respective email. This code determines the layout, colors, and structure of the email.

**Alarm Email Content**: Is used for notifications that are sent about triggered alarms.

**Ticket Email Content**: Is used for emails that are sent as part of the ticket system, e.g., to inform about newly created tickets or status changes.

**Password Reset Email Content**: This template is used for password reset emails when a user resets their password.

With HTML and CSS, you can make changes to the design and formatting, such as the font, colors, or the insertion of images:

```html
<h2 style="color: #4CAF50;">New Alarm: [Alarm type]</h2>
<p>An alarm was triggered at [Alarm time].</p>
<p>Details:</p>
<ul>
  <li><strong>Alarm ID:</strong> [Alarm ID]</li>
  <li><strong>Priority:</strong> [Alarm priority]</li>
</ul>
```

After you have edited the template, click on Save in the bottom left to ensure that all future emails use the updated content.

{% hint style="info" %}
Test the customized template after every change to ensure that it is displayed correctly and does not contain any syntax errors in the HTML code.
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.buildings.ability.abb/collection/platform/platform-core/alert-and-escalation/escalations/notification-provider/mail.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.