# Настройка email-платформы

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

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

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

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

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

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

<img src="/configure-project-email-verification-1.webp" alt="Интерфейс настройки email-платформы с кнопкой Configure для настроек email-сообщений."/>

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

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

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

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

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

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


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

После подтверждения вашего аккаунта вы получите email с подтверждением. Затем вы можете перейти к настройке параметров отправителя.

Для этого: 

1. Перейдите в **Settings**.  
2. Выберите **Configure platforms**.  
3. Нажмите **Continue configuration** рядом с email-платформой.

<img src="/configure-project-email-verification-3.webp" alt="Интерфейс настройки платформы с кнопкой Continue configuration для email-платформы."/>

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

### Добавьте домен

Чтобы отправлять электронные письма с помощью Pushwoosh, добавьте и подтвердите домен. 

В поле **Domain** введите домен, который вы хотите использовать для отправки писем (например, yourcompany.com). Этот домен должен быть подтвержден через DNS на следующем шаге, прежде чем его можно будет использовать в ваших email-кампаниях.
 
<img src="/configure-project-email-verification-4.webp" alt="Интерфейс настройки домена с полем для ввода домена отправителя."/>

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

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

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

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

*   **Name**: Введите имя отправителя (например, John).
*   **Email**: Введите email-адрес отправителя до символа "@". Например, для *marketing@yourcompany.com* введите *marketing*.

<Aside type="caution" title="Как определяются данные отправителя в Customer Journeys и разовых email-рассылках">
Эти данные отправителя по умолчанию используются, когда отправитель не указан в контенте письма или на шаге Journey (или разовой email-рассылки). Отправитель, указанный на [шаге Customer Journey](/ru/product/customer-journey/journey-elements/channels/email/#define-sender-details-and-reply-address) или в [форме разовой email-рассылки](/ru/product/messaging-channels/emails/sending-emails/send-one-time-emails/#sender-details), имеет приоритет как над контентом письма, так и над настройками платформы по умолчанию. Отправитель, указанный в контенте письма, имеет приоритет над настройками платформы по умолчанию. 
</Aside> 

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

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

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

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

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

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

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

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

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

<Aside type="caution" title="Может потребоваться техническая помощь"> 
****
Добавление DNS-записей требует доступа к настройкам DNS вашего домена. Если вы не уверены, как их настроить, обратитесь за помощью к вашей IT-команде или провайдеру домена. 

</Aside>

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

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


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

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

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

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

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

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

<img src="/configure-project-email-verification-8.webp" alt="Интерфейс настройки DKIM, показывающий четыре записи 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="Интерфейс статуса верификации домена с кнопкой Check DNS Records и статусом верификации."/>

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

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

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

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

<img src="/configure-project-email-verification-10.webp" alt="Интерфейс Email Channel Configuration с кнопкой Send test email."/>

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

<div style={{ display: "flex", justifyContent: "center" }}>
  <img src="/configure-project-email-verification-11.webp" alt="Верификация Email" />
</div>

### Записи 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, показывающий значение SPF и инструкции по добавлению DNS-записей."/>

### Проверка 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, показывающий запись DMARC TXT, которую необходимо добавить в DNS-настройки."/>


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

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

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

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

<img src="/configure-project-email-verification-14.webp" alt="Интерфейс выбора домена с кнопкой Choose different domain для изменения доменов отправителя."/>

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

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

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

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

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

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

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

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

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

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

<img src="/configure-project-email-verification-15.webp" alt="Интерфейс настройки отслеживания ссылок, показывающий UTM-параметры и пример предпросмотра ссылки."/>

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

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

## Просмотр и управление настройками вашего email-канала

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

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

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

*   **Данные отправителя по умолчанию** не указаны. [Узнайте больше о данных отправителя по умолчанию](/ru/product/first-steps/start-with-your-project/configure-platforms/email-verification#add-default-sender-details).
<div style={{ display: "flex", justifyContent: "center" }}>
  <img src="/configure-project-email-verification-16.webp" alt="Данные отправителя по умолчанию не указаны" />
</div> 

*   **Неподтвержденный домен** установлен в качестве отправителя по умолчанию. [Узнайте больше о подтверждении вашего домена](/ru/product/first-steps/start-with-your-project/configure-platforms/email-verification#configure-dns-records).

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

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

*   **READY**: Домен настроен и готов к отправке писем.
*   **NOT READY**: Верификация домена не завершена, обычно из-за ожидающей [верификации DKIM](/ru/product/first-steps/start-with-your-project/configure-platforms/email-verification/#dkim-records-required), которая является обязательной. Домены, помеченные как **NOT READY**, не могут отправлять письма до тех пор, пока все необходимые верификации не будут завершены. Чтобы завершить настройку, нажмите на имя домена в списке.

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

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

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

Чтобы добавить дополнительные домены, нажмите **Add domain**. Чтобы увеличить этот лимит, пожалуйста, [свяжитесь со службой поддержки](https://help.pushwoosh.com/hc/en-us/requests/new).

<img src="/configure-project-email-verification-18.webp" alt="Интерфейс управления доменами с кнопкой Add domain для добавления дополнительных доменов отправителя."/>

##### Удаление домена
<Aside type="danger" title="Важно"> 
****
Удаление домена может нарушить активные email-кампании, которые используют его в качестве отправителя. Обязательно проверьте все текущие кампании перед удалением домена.
</Aside>
Чтобы удалить домен:

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

**Примечание**: Если домен установлен в качестве адреса ["From"](/ru/product/first-steps/start-with-your-project/configure-platforms/email-verification/#from-address) по умолчанию в каком-либо проекте, вы не сможете его удалить, пока информация об отправителе не будет обновлена в этих проектах. Появится сообщение об ошибке со списком проектов, использующих этот домен в качестве отправителя по умолчанию. Обновите адрес "From" в каждом проекте на другой подтвержденный домен, а затем попробуйте удалить домен снова.


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

Из списка доменов вы также можете отправить тестовое письмо. 

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

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

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

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

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

<Aside type="caution" title="Важно"> 
****
Email-канал не будет настроен, если вы не укажете [данные отправителя по умолчанию](/ru/product/first-steps/start-with-your-project/configure-platforms/email-verification/#add-default-sender-details), и появится предупреждающее сообщение. Чтобы установить данные отправителя по умолчанию, нажмите **Set sender details.**
</Aside>

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

В этом разделе вы можете управлять настройками [**отслеживания ссылок**](/ru/product/first-steps/start-with-your-project/configure-platforms/email-verification/#configure-link-tracking). Чтобы включить отслеживание, переключите переключатель в положение **Enable**.

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

## Настройка email-рассылок через Pushwoosh API

Вы также можете настроить email-платформу с помощью Pushwoosh API. Для этого вам понадобится помощь вашей команды разработчиков. Пожалуйста, поделитесь с ними [этим руководством](/ru/developer/api-reference/app-configuration#configureapplication-for-email) для получения подробных инструкций.

## Настройте центр предпочтений подписки

После настройки email-платформы (подтверждения доменов и установки данных отправителя по умолчанию) вы можете настроить [центр предпочтений подписки](/ru/product/messaging-channels/emails/email-preferences/), чтобы пользователи могли выбирать, какие категории писем они хотят получать.



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


**Домен для отслеживания кликов (CTD)** — это доменная часть URL-адреса отслеживаемой ссылки, отображаемой в email-сообщении. Он состоит из поддомена и вашего основного домена, например, `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**.