# Email-шлюз

**Почтовый шлюз** является службой обмена сообщениями, которая обеспечивает автоматизированное взаимодействие с вашими клиентами. Пользователи получают автоматические письма в нескольких ключевых сценариях:

* Уведомления о событиях: оповещения, генерируемые при определённых действиях устройства или нарушениях геозоны.
* Плановые отчёты: отчёты в формате Excel или PDF, доставляемые по настроенному расписанию.
* Уведомления о платёжном балансе: оповещения о низком балансе или необходимости пополнения средств.

Как оператор сервиса, вы можете определить, какой шлюз отвечает за эти доставки, и настроить адрес отправителя.

<figure><img src="https://4285393472-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKdgeXg71LpaDrwexQYwp%2Fuploads%2FpqCChSMCGhnAD7A2cDp4%2Fimage.png?alt=media&#x26;token=8142a03e-c688-4bc7-b6f9-56a595142ab2" alt="Email gateway page" width="563"><figcaption><p>Страница почтового шлюза</p></figcaption></figure>

Страница **Почтовый шлюз** состоит из двух разделов:

* **Конфигурация SMTP-сервера**: Выберите между сервисом электронной почты Navixy или укажите собственный шлюз
* **Настройки электронной почты**: Укажите адрес электронной почты отправителя и подпись, автоматически применяемую ко всем отправляемым письмам

## Как выбрать почтовый шлюз

В зависимости от вашего продукта и конкретных потребностей вы можете выбрать один из двух вариантов:

* **Почтовый шлюз Navixy**: Это рекомендуемый вариант для **пользователей ServerMate** . Это бесплатный высокоскоростной сервис, организованный через Mandrill для обеспечения высокой доставляемости и попадания в почтовые ящики. Этот сервис интегрирован с Navixy и гарантирует, что ваши письма доставляются в почтовые ящики пользователей без пометки как спам.
* **Сторонний SMTP-шлюз**: Этот универсальный метод доступен для **пользователей ServerMate**, **Cloud**и **On-Premise** продуктов. Он позволяет указать собственный сервер для доставки почты, например ваш выделенный почтовый сервер, публичные сервисы вроде Gmail или специализированные сервисы доставки, такие как SendGrid, Mailgun или Mandrill.

## Почтовый шлюз Navixy

{% hint style="warning" %}
Этот вариант доступен только для **развёртываний Navixy ServerMate** .
{% endhint %}

### Как изменить адрес отправителя

По умолчанию поле **From** установлено в `no-reply@x-gpsmail.com`. В этой конфигурации никаких дополнительных настроек не требуется. Если вы хотите использовать собственный адрес (например, `no-reply@yourdomain.com`), вы должны авторизовать свой домен, чтобы предотвратить пометку писем как спам. Чтобы аутентифицировать и авторизовать доставку почты, выполните следующие шаги:

{% stepper %}
{% step %}

### Аутентифицируйте свой домен

Свяжитесь с [службой поддержки Navixy](mailto:support@navixy.com) и укажите имя домена, которое вы собираетесь использовать. Это не обязательно должен быть домен вашей платформы, но вы должны иметь доступ к нему, чтобы вносить изменения в DNS. Вы получите TXT-запись для добавления в настройки DNS, чтобы подтвердить право собственности.

Формат: `yourdomain.com. 1 IN TXT "mandrill_verify.KEY_PROVIDED_HERE"`.

Настройки DNS предоставляются вашим DNS-провайдером. У каждого провайдера свои инструменты и настройки. Если вам нужна помощь в изменении этих настроек, обратитесь к вашему DNS-провайдеру.
{% endstep %}

{% step %}

### Авторизуйте свой домен

Добавьте пять дополнительных записей DNS в ваш домен, чтобы подтвердить авторизацию:

* Запись SPF: добавьте `v=spf1 include:spf.mandrillapp.com -all`. Если запись SPF уже существует, вставьте `include:spf.mandrillapp.com` перед завершающим механизмом.\
  Например, если ваша текущая запись SPF выглядит как `v=spf1 a -all`, обновите её до

  `v=spf1 a include:spf.mandrillapp.com -all` .
* Записи DKIM: создайте две CNAME-записи. Установите одно имя как `mte1._domainkey.yourdomain.com` со значением `dkim1.mandrillapp.com` и второе как `mte2._domainkey.yourdomain.com` со значением `dkim2.mandrillapp.com`, заменив `yourdomain.com` на соответствующее имя вашего домен&#x430;**.**
* Запись DMARC: в настройках DNS создайте и сохраните TXT-запись с именем `_dmarc.yourdomain.com` со значением `v=DMARC1; p=none;`, заменив `yourdomain.com` на соответствующее имя вашего домен&#x430;**.**

После создания записей не забудьте сохранить информацию в DNS. Настройки вступают в силу через 30 минут или до 4 часов.
{% endstep %}

{% step %}

### Назначьте адрес отправителя

После распространения записей DNS отправьте письмо на адрес <support@navixy.com> с данными для входа в Admin Panel и желаемым адресом отправителя. Команда поддержки протестирует конфигурацию и подтвердит, когда настройка будет завершена.
{% endstep %}
{% endstepper %}

### Как проверить вашу конфигурацию DKIM

После завершения настройки DNS следует проверить, правильно ли ваши письма подписываются цифровой подписью. Это гарантирует, что почтовые серверы получателей распознают ваши сообщения как подлинные.

1. В Admin Panel отправьте тестовое сообщение на личный адрес электронной почты (например, Gmail или Outlook).
2. Откройте полученное письмо, нажмите на **More** опций (обычно три точки) и выберите **Show original** или **View message details**.
3. Используйте функцию поиска, чтобы найти фразу `dkim=pass`. Если она найдена, это означает, что поле настроено правильно. В противном случае сообщение либо не подписано, либо подпись некорректна.

## **Сторонний шлюз**

{% hint style="info" %}
Если вы используете собственный SMTP-сервис, вы несёте ответственность за то, чтобы письма доставлялись в почтовые ящики ваших пользователей и не помечались как спам.
{% endhint %}

Чтобы использовать собственного SMTP-провайдера, войдите в **Admin Panel** и перейдите в **Settings** > **Почтовый шлюз**.

{% stepper %}
{% step %}

### Выберите тип шлюза

В разделе **SMTP server** выберите **Custom SMTP**.
{% endstep %}

{% step %}

### Настройте сервер и безопасность

Введите адрес хоста, предоставленный вашим сервисом (например, `smtp.gmail.com`).

1. Укажите, используете ли вы протокол защищённой передачи данных (SSL или TLS).
2. После выбора протокола безопасности поле порта SMTP автоматически заполнится в соответствии со стандартными рекомендациями для публичных почтовых сервисов. При необходимости вы можете вручную изменить этот номер порта, если ваш провайдер требует нестандартной конфигурации.
3. При использовании SSL/TLS вы увидите флажок **Trust all** . Он используется для обхода ошибок, если ваш SMTP-сервер использует самоподписанный сертификат или сертификат, не признанный стандартными удостоверяющими центрами. Включайте его только если вы уверены в безопасности вашего сервера.
   {% endstep %}

{% step %}

### Настройте авторизацию

Если ваш провайдер требует входа (как большинство публичных сервисов, таких как Gmail), отметьте поле авторизации и введите ваше имя пользователя и пароль.
{% endstep %}

{% step %}

### Введите информацию об отправителе

Укажите адрес электронной почты отправителя и пользовательскую подпись, которую система будет автоматически добавлять ко всем исходящим письмам.
{% endstep %}

{% step %}

### Проверьте вашу настройку

Нажмите **Send Test Email** и введите адрес назначения, чтобы проверить соединение. Если всё настроено правильно, вы получите тестовое сообщение на указанный адрес.
{% endstep %}
{% endstepper %}