# Virtual Email Receiver

Hi, and welcome to another evalink tutorial!&#x20;

In this tutorial, we will add and set up a new integration, the **Virtual Email Receiver** into your evalink talos account.

{% embed url="<https://www.youtube.com/watch?v=S2pL-jjXKfg>" %}

Before you start, you will need a dedicated e-mail address like `talos@sitasys.com`.

Your system administrator can help you to get the necessary credentials:

* an IMAP host such as `outlook.office365.com`,
* an IMAP port, which is usually port `993`
* and a set of username and password.

Once your email address is set up, you will need to add the integration into your evalink talos account.

From your evalink talos dashboard, navigate to the menu `Company`, and click on the tab `Integrations`.

Search for Virtual Email Receiver and click on: `Add Integration`.

Now, let’s configure the **Virtual Email Receiver** integration.

Enter:

* the IMAP host and port
* the username and password provided by your administrator
* and finally, select the IMAP folder that should be monitored by evalink talos.

To finish the integration click on `Submit`.

The state should now change to "Enabled". If not, you should double check the credentials you entered in the previous step.

Now, the next step is to enable and configure the **Virtual Email Receiver** on your site, so that you can allow the conversion of emails into alarms for a particular site.

To add the **Virtual Email Receiver** integration to a site, navigate to the menu `Sites`, pick the site to configure, click on the tab `Integrations`, and then click on `Email Receiver`.

To enable the **Virtual Email Receiver**, click on the button: `Enable Virtual Email Receiver`.

evalink talos provides a generated authentication token that you can use to filter your emails and avoid SPAM or email floods.

Alternatively a sender email address can be used to authenticate the incoming emails. In that case, only the provided email address is allowed to send email-alarms to evalink talos. If you want to use this option, you have to configure text mappings to react differently to each email-alarm depending on keywords within the subject or the body text of the incoming email.

For this tutorial, we will proceed with the first authorization option, which is easier to configure.

As a verification step, you can use the provided example body to send an email which will trigger an alarm in evalink talos. To do this, you need to ensure that at least the token and the alarm code is included in the email body. Additionally you can also enter the alarm zone and value, or geolocation coordinates and other custom headers.

And...That’s it!

evalink talos is now configured to convert incoming emails to the provided email address into alarms!


---

# 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://sitasys-ag.gitbook.io/evalink-tutorials/virtual-email-receiver.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.
