# Настройка Email

<Aside type="note">
Обратите внимание, что настройка платформы зависит от проекта. Настройте платформу Email для каждого проекта, который вы хотите использовать для отправки электронных писем. Подтвержденные адреса электронной почты и домены доступны для всех проектов в вашем аккаунте.
</Aside>

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

## Верификация вашего аккаунта
Прежде чем вы начнете отправлять электронные письма через Pushwoosh, вам необходимо верифицировать свой аккаунт.

Это важный шаг для обеспечения надежной и безопасной доставки ваших писем. Верификация помогает предотвратить неправомерное использование платформы для спама или вредоносных действий и обеспечивает соблюдение нормативных требований.

Выполните следующие шаги для завершения процесса верификации:

1. Перейдите в **Settings > Configure platforms**.

2. Найдите Email Message и нажмите **Configure**.

<img src="/configure-project-email-verification-1.webp" alt="Раздел настройки Email Message в Панели управления Pushwoosh"/>

3. В появившейся форме укажите URL-адрес веб-сайта вашей компании в поле Your company website URL (например, https://example.com).

4. В поле **Primary technical contact** введите адрес электронной почты лица, ответственного за управление техническими аспектами вашей интеграции. Этот контакт будет использоваться для любых технических запросов или проблем.

5. В поле **Tell us about how you’ll be using Pushwoosh** предоставьте подробную информацию о том, как вы собираетесь использовать Pushwoosh для своих email-кампаний. Включите такую информацию, как:

- Типы сообщений, которые вы планируете отправлять (например, новостные рассылки, рекламные предложения и т.д.).

- Как ваши подписчики подписываются на получение этих сообщений (например, через форму на веб-сайте, регистрацию в мобильном приложении).

<img src="/configure-project-email-verification-2.webp" alt="Форма верификации email с полями для URL-адреса сайта компании, основного технического контакта и сведений об использовании"/>

После заполнения всей информации нажмите кнопку **Verify my account**, чтобы отправить запрос. Pushwoosh рассмотрит ваши данные и свяжется с вами как можно скорее.

После верификации вашего аккаунта вы получите подтверждающее письмо. Затем вы можете перейти к настройке параметров отправителя электронной почты.

Для этого перейдите в **Settings**, выберите **Configure Platforms** и нажмите **Continue Configuration** рядом с платформой Email.

<img src="/configure-project-email-verification-3.webp" alt="Кнопка Continue Configuration рядом с платформой Email в Панели управления Pushwoosh"/>

## Настройка данных отправителя

### Добавление домена

Чтобы отправлять электронные письма с помощью Pushwoosh, добавьте и верифицируйте домен. В поле **Domain** введите домен, который вы хотите использовать для отправки электронных писем (например, yourcompany.com).

<img src="/configure-project-email-verification-4.webp" alt="Поле Domain для добавления домена отправителя в настройках email в Pushwoosh"/>

**Важно:** Этот домен должен быть верифицирован через DNS на следующем шаге, прежде чем его можно будет использовать в ваших email-кампаниях.

<Aside type="note">
В верхней части экрана вы увидите оставшееся количество доменов, которые можно добавить. Чтобы увеличить этот лимит, пожалуйста, [свяжитесь с нашей службой поддержки](https://help.pushwoosh.com/hc/en-us/).
</Aside>

### Добавление данных отправителя по умолчанию

#### Адрес "От кого"

Настройте имя и адрес электронной почты отправителя по умолчанию, которые будут отображаться в почтовых ящиках получателей. Это помогает пользователям узнавать отправителя и укрепляет доверие.

*   **Name**: Введите имя отправителя (например, John).
*   **Email**: Введите адрес электронной почты отправителя до символа "@" (например, для *marketing@yourcompany.com* введите *marketing*)

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

<img src="/configure-project-email-verification-5.webp" alt="Форма данных отправителя по умолчанию с полями имени и email-адреса в Pushwoosh"/>

Установите флажок **Use this as reply-to address to track replies**, если вы хотите, чтобы ответы от получателей поступали непосредственно на адрес электронной почты отправителя.

#### Адрес для ответа

Чтобы использовать другой адрес для ответа, оставьте флажок снятым и укажите:

*   **Reply-To name**: Имя, которое будет отображаться как контакт для ответов.
*   **Reply-To email**: Адрес электронной почты, на который должны отправляться ответы.

<img src="/configure-project-email-verification-6.webp" alt="Поля настройки адреса для ответа с именем и email в Pushwoosh"/>

Если оба поля останутся пустыми, ответы будут отправляться на адрес электронной почты отправителя по умолчанию, указанный в разделе **From address**.

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

## Настройка DNS-записей

Для аутентификации вашего домена и включения отправки электронной почты для ваших кампаний вам необходимо настроить следующие DNS-записи в настройках DNS вашего хостинг-провайдера:

*   **DKIM (Обязательно)**. Эта запись ставит цифровую подпись на ваши электронные письма, позволяя почтовым провайдерам убедиться, что письмо исходит от вашего домена и не было изменено в пути.
*   **SPF (Обязательно)**: Эта запись указывает, каким почтовым серверам разрешено отправлять электронные письма от имени вашего домена, что помогает предотвратить спуфинг.
*   **DMARC (Обязательно)**: Эта запись предоставляет инструкции по обработке неаутентифицированных писем и отправке отчетов вам, повышая безопасность электронной почты.


### Записи DKIM (обязательно)

<details>
  <summary>Что такое записи DKIM?</summary>

DKIM (DomainKeys Identified Mail) — это метод аутентификации электронной почты, который позволяет принимающим серверам убедиться, что письмо было отправлено указанным доменом и не было изменено в пути.

Добавляя записи DKIM в ваши настройки DNS, вы применяете криптографическую подпись к исходящим письмам. Эта подпись подтверждает, что содержимое сообщения осталось неизменным, и аутентифицирует его как легитимное сообщение от вашего домена.
</details>

Для настройки DKIM вам необходимо добавить все четыре записи CNAME (Canonical Name) в ваши настройки DNS. Эти записи необходимы для аутентификации вашего домена и подтверждения того, что электронные письма, отправленные с вашего домена, авторизованы.

<img src="/configure-project-email-verification-8.webp" alt="Записи DKIM CNAME, отображаемые в настройках email в Pushwoosh"/>

Скопируйте записи CNAME и добавьте их в свои настройки DNS.

<Aside type="note">
DNS-провайдеры обрабатывают записи по-разному. Некоторые требуют вставить всю запись (имя хоста + домен), в то время как другим нужна только уникальная часть ключа (имя хоста без домена). Ознакомьтесь с инструкциями вашего DNS-провайдера о том, как добавлять записи.
</Aside>

После добавления необходимых DNS-записей процесс верификации домена обычно занимает от 5 до 10 минут, но в некоторых случаях может занять до 24 часов. В течение этого времени вы не сможете отправлять электронные письма через Pushwoosh до завершения верификации.

Нажмите **Check DNS Records**, чтобы обновить статус верификации после добавления DNS-записей. После успешной верификации статус верификации домена изменится на **Verified**.

<img src="/configure-project-email-verification-9.webp" alt="Статус верификации домена показывает статус Verified после настройки DNS-записей"/>

Тем временем, вы можете переходить к другим шагам настройки и вернуться позже, чтобы проверить статус верификации.

#### Отправка тестового письма

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

Чтобы отправить тестовое письмо:

1. В разделе **Email Channel Configuration** нажмите **Send test email**.

<img src="/configure-project-email-verification-10.webp" alt="Кнопка Send test email в разделе Email Channel Configuration"/>

2. Введите данные отправителя и получателя:
*   **From**: Адрес электронной почты отправителя, который вы настроили.
*   **Recipient**: Введите адрес электронной почты, на который вы хотите отправить тестовое письмо. По умолчанию это поле заполнено адресом электронной почты вошедшего в систему пользователя, но при необходимости вы можете его изменить.
3. Выберите содержимое письма из выпадающего списка для включения в тестовое письмо.
4. Нажмите **Send**.

<img src="/configure-project-email-verification-11.webp" alt="Форма тестового письма с полями выбора отправителя, получателя и содержимого письма"/>

### Записи SPF (обязательно)

Pushwoosh требует настройки записи **Sender Policy Framework (SPF)** для авторизации своих почтовых серверов на отправку электронных писем от имени вашего домена. SPF — это протокол аутентификации электронной почты, который помогает предотвратить спуфинг и улучшает доставляемость писем.

<Aside type="note">
Прежде чем добавлять новую запись SPF, проверьте, есть ли у вашего домена уже такая запись, так как большинство DNS-провайдеров разрешают только одну запись SPF на домен.
</Aside>

#### Добавление новой записи SPF

Если у вашего домена нет записи SPF, добавьте новую запись TXT со следующим значением.

**Значение SPF**

```
"v=spf1 include:spf.pushwoosh.io ~all"
```

В зависимости от вашего DNS-провайдера, имя записи может быть либо пустым, либо установлено как @.

#### Добавление к существующей записи SPF

Если у вашего домена уже есть запись SPF, просто добавьте следующий механизм SPF в вашу существующую запись, чтобы авторизовать Pushwoosh.

```
include:spf.pushwoosh.io
```

<img src="/configure-project-email-verification-12.webp" alt="Пример настройки записи SPF, показывающий, как добавить include:spf.pushwoosh.io в существующую запись SPF"/>

### Верификация DMARC (обязательно)

**DMARC** (Domain-based Message Authentication, Reporting, and Conformance) — это протокол аутентификации электронной почты, который помогает защитить ваш домен от несанкционированного использования, такого как спуфинг.

Pushwoosh требует, чтобы DMARC был настроен на вашем домене для обеспечения безопасной и аутентифицированной доставки электронной почты. Для получения дополнительной информации о DMARC см. [документацию по протоколу DMARC](https://dmarc.org/overview/).

Для настройки DMARC:

1. Скопируйте запись DMARC TXT

<img src="/configure-project-email-verification-13.webp" alt="Запись DMARC TXT, отображаемая в настройках email в Pushwoosh"/>

2. Перейдите в настройки вашего DNS-провайдера и добавьте запись DMARC в настройки DNS. (Обратитесь к документации вашего DNS-провайдера, если вам нужна помощь в добавлении этих записей.)
3. Включите отчетность (необязательно). Чтобы получать отчеты о проблемах с аутентификацией и безопасностью электронной почты, добавьте адрес электронной почты в поле
`rua` в параметре **Value**.

### Выбор другого домена

Если на этом шаге вы поняли, что вам нужно изменить домен, нажмите **Choose different domain**. Затем вы сможете добавить новый домен отправителя.

Имейте в виду, что изменение имени вашего домена сгенерирует новые DNS-записи. Это гарантирует правильное отслеживание лимита доменов и исключает любые домены, которые вам больше не нужны.

<img src="/configure-project-email-verification-14.webp" alt="Кнопка Choose different domain в настройках email в Pushwoosh"/>

## Настройка отслеживания ссылок

Отслеживание ссылок помогает вам понять, как ваша аудитория взаимодействует со ссылками в ваших электронных письмах, добавляя **UTM-параметры**. С помощью UTM-меток вы можете отслеживать вовлеченность в электронную почту непосредственно в Google Analytics или любой другой аналитической системе, которая отслеживает UTM.

<Aside type="note">
Если вы решите не настраивать отслеживание URL-адресов Google Analytics, Pushwoosh все равно будет отслеживать клики по ссылкам и предоставлять базовую статистику. Просто оставьте переключатель **Google Analytics URL tracking** выключенным и нажмите **Complete setup**.
</Aside>

Чтобы добавить отслеживание ссылок, включите отслеживание URL-адресов Google Analytics.

К вашим ссылкам будут добавлены следующие UTM-параметры:

- **utm_source**: Идентифицирует источник трафика.

- **utm_medium**: Указывает маркетинговый канал, который по умолчанию установлен как "email".

- **utm_campaign**: Добавляет код кампании (например, ID кампании). Вставляется автоматически.

- **utm_content**: Отслеживает конкретное содержимое в письме, например, тему. Вставляется автоматически.

**Link Preview** показывает пример того, как будут выглядеть ваши ссылки с выбранными UTM-параметрами.

<img src="/configure-project-email-verification-15.webp" alt="Настройка отслеживания URL-адресов Google Analytics с UTM-параметрами и предварительным просмотром ссылки"/>

После настройки UTM-параметров нажмите **Complete setup**, чтобы сохранить ваши настройки.

UTM-метки будут автоматически добавляться к каждой ссылке в вашем письме, позволяя вам отслеживать эффективность источника, канала, кампании и контента непосредственно в Google Analytics.

## Обзор конфигурации email-канала

После настройки вашего email-канала панель **Email channel configuration** предоставляет обзор и позволяет управлять ключевыми настройками для отправки электронных писем, включая домены отправителя, данные отправителя по умолчанию и опции отслеживания ссылок.

### Статус конфигурации

Вверху вы можете просмотреть статус платформы Email, который указывает, настроена ли она. Если платформа не настроена, это может быть по следующим причинам:

*   **Default sender details** не были указаны. [Узнайте больше о данных отправителя по умолчанию](#add-default-sender-details).

<img src="/configure-project-email-verification-16.webp" alt="Статус платформы Email, показывающий проблему с конфигурацией из-за отсутствия данных отправителя по умолчанию"/>

*   **Неверифицированный домен** установлен в качестве отправителя по умолчанию. [Узнайте больше о верификации вашего домена](#configure-dns-records).

<img src="/configure-project-email-verification-17.webp" alt="Статус платформы Email, показывающий предупреждение о неверифицированном домене в Pushwoosh"/>

### Ваши домены отправителя
В разделе **Your sender domains** вы можете просматривать и управлять доменами, которые вы используете для отправки электронных писем, и статусом каждого домена:

*   **READY**: Домен настроен и готов к отправке электронных писем.
*   **NOT READY**: Верификация домена не завершена, обычно из-за ожидающей верификации DKIM, которая является обязательной. Домены, помеченные как **NOT READY**, не могут отправлять электронные письма до тех пор, пока все необходимые верификации не будут завершены. Чтобы завершить настройку, нажмите на имя домена в списке.

Кроме того, в этом разделе отображается статус каждой записи верификации (DKIM, SPF, DMARC) как **Verified** или **Pending**. **Pending** указывает, что запись либо ожидает верификации, либо еще не была настроена.

Нажмите **Update status**, чтобы обновить статус верификации для каждого домена.

##### Добавление домена

Чтобы добавить дополнительные домены, нажмите **Add domain**. Чтобы увеличить этот лимит, пожалуйста, свяжитесь со службой поддержки.

<img src="/configure-project-email-verification-18.webp" alt="Кнопка Add domain в разделе Your sender domains в настройках email в Pushwoosh"/>

##### Удаление домена

Чтобы удалить домен:

1. В **Your Sender Domains** найдите домен для удаления.
2. Нажмите на **меню с тремя точками** рядом с именем домена и выберите **Delete domain**.
3. Подтвердите удаление или нажмите **Cancel**, чтобы сохранить домен.

> **Важно**: Удаление домена может нарушить работу активных email-кампаний, которые используют его в качестве отправителя. Обязательно проверьте все текущие кампании перед удалением домена.

<Aside type="note">
Если домен установлен в качестве адреса "От кого" по умолчанию в каком-либо проекте, вы не сможете его удалить, пока информация об отправителе не будет обновлена в этих проектах. Появится сообщение об ошибке, а также список проектов, использующих этот домен в качестве отправителя по умолчанию. Обновите адрес "От кого" в каждом проекте на другой верифицированный домен, а затем попробуйте удалить домен снова.
</Aside>

##### Отправка тестового письма

Из списка доменов вы также можете отправить тестовое письмо. Для этого нажмите на меню с тремя точками рядом с настроенным доменом и выберите **Send Test Email**. Обратите внимание, что эта опция доступна только для полностью настроенных доменов.

### Данные отправителя по умолчанию

В этом разделе вы можете просматривать и управлять данными отправителя по умолчанию, включая:

*   **From Address**: Имя и адрес электронной почты, которые будут отображаться в качестве отправителя в письмах.
*   **Reply-To Address**: Имя и адрес электронной почты по умолчанию для ответов.

Чтобы внести изменения, нажмите **Edit default sender details**.

> **Важно**: Email-канал не будет настроен, если вы не укажете данные отправителя по умолчанию, и появится предупреждающее сообщение. Чтобы установить данные отправителя по умолчанию, нажмите **Set sender details.**

### Отслеживание URL-адресов Google Analytics

В этом разделе вы можете управлять настройками **Link Tracking**.

При включении UTM-параметры автоматически добавляются к ссылкам в письмах, что позволяет отслеживать вовлеченность пользователей в Google Analytics. Вы также увидите **Link Preview**, показывающий, как будут выглядеть ваши URL-адреса с UTM-метками.

Чтобы включить отслеживание, переключите переключатель в положение **Enable**.

## Настройка Email через Pushwoosh API

Для настройки платформы Email через Pushwoosh API отправьте запрос [`configureApplication`](/ru/developer/api-reference/app-configuration#configureapplication-for-email).



## Настройка пользовательского домена для отслеживания


**Домен для отслеживания кликов (CTD)** — это доменная часть URL-адреса отслеживаемой ссылки, отображаемой в электронном письме. Он состоит из поддомена и вашего основного домена, например, `click.yourdomain.com`. Поддомен создается в настройках DNS вашего домена у вашего доменного провайдера, обычно путем добавления записи CNAME. С помощью CTD вы можете оборачивать ссылки в письмах для отслеживания кликов на вашем собственном поддомене, сохраняя при этом доставляемость и работоспособность диплинков.

Чтобы настроить пользовательский домен для отслеживания:

1. Решите, какой поддомен вы будете использовать в качестве вашего CTD (например, `click.yourdomain.com`).
2. В Pushwoosh откройте **Settings**, затем выберите **Configure Platforms**.
3. На странице **Email channel configuration** прокрутите до **Custom tracking domain** и выберите **Enable**.

<Aside type="note" >
Раздел **Custom tracking domain** отображается только после того, как email-канал будет настроен для вашего приложения. Если вы его не видите, сначала завершите [настройку email](/ru/product/first-steps/start-with-your-project/configure-platforms/email-verification/).
</Aside>

<img src="/integrations-appsflyer-esp2-email-integration-2.webp" alt="Панель управления Pushwoosh, показывающая Settings, Configure Platforms, Email channel configuration и карточку Custom tracking domain с элементом управления Enable."/>

4. Введите ваш CTD в поле **Domain** и выберите **Next**.

<img src="/integrations-appsflyer-esp2-email-integration-3.webp" alt="Диалоговое окно включения пользовательского домена для отслеживания с полем Domain для ввода CTD и кнопками Cancel и Next."/>

5. Вне Pushwoosh откройте сервис, где вы управляете публичным DNS для домена вашего CTD (обычно это ваш регистратор доменов, DNS-хостинг или ваш хостинг-аккаунт). В его редакторе DNS или зон для этого домена добавьте запись **CNAME**, которую Pushwoosh показывает на этом шаге, чтобы ваш CTD указывал на `api.pushwoosh.com`.

<Aside type="note" title="Распространение DNS">
Изменения DNS обычно вступают в силу в течение нескольких минут, но могут занять до 48 часов.
</Aside>

6. В Pushwoosh выберите **Verify**.

<img src="/integrations-appsflyer-esp2-email-integration-4.webp" alt="Шаг верификации DNS пользовательского домена для отслеживания, показывающий цель CNAME api.pushwoosh.com и элементы управления Back, Verify и Save."/>

7. Когда верификация будет успешной, выберите **Save**.
8. Если вам нужно изменить **Domain** или DNS-запись, выберите **Back** и скорректируйте предыдущие шаги.

9. После нажатия **Save** ваш CTD появится в списке **Custom tracking domain** в **Email channel configuration**.

<img src="/integrations-appsflyer-esp2-email-integration-5.webp" alt="Конфигурация email-канала с разделом Custom tracking domain, показывающим сохраненный домен для отслеживания кликов в списке."/>

Чтобы отключить его позже, выберите `...` рядом с вашим CTD, затем выберите **Disable custom tracking domain**.