[Документация Yandex Cloud](../../../index.md) > [Yandex DataLens](../../index.md) > Дашборды > Рассылки

# Рассылки


Вы можете настроить рассылку для дашборда по электронной почте. В письме адресаты получат ссылки на те состояния дашборда и чартов, которые задаются в настройках рассылки. Можно настроить состояние селекторов на дашборде, расписание, размеры чартов и другие параметры. Рассылки доступны только для актуальной [версии](../../dashboard/versioning.md) дашборда.

{% note info %}

* Рассылки доступны только для дашбордов, расположенных в [воркбуках](../../workbooks-collections/index.md).
* Добавить и изменить рассылку может пользователь с ролью `datalens.admin`.

{% endnote %}

Чтобы добавить рассылку для дашборда:

1. На панели слева нажмите ![image](../../../_assets/console-icons/layout-cells-large.svg) **Дашборды** и выберите нужный дашборд. Если у вас нет дашборда, [создайте его](create.md).
1. В верхней части экрана нажмите значок ![image](../../../_assets/console-icons/envelope.svg).
1. Укажите параметры рассылки:

   * Название рассылки:
   
     1. Напротив поля **Новая рассылка** нажмите ![image](../../../_assets/console-icons/pencil.svg).
     1. Введите название рассылки, которое будет отображаться в заголовке и теме письма.

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

          * начинается и заканчивается заглавной или строчной латинской или русской буквой, цифрой, символом `_`, `@`, `(`, `)`,  или `%`;
          * остальные символы — заглавные и строчные латинские или русские буквы, цифры, символы: `_`, `@`, `(`, `)`, `%`, `.`, `,`, `:`, `;`, `'`, `|`, `-`, `–`, `—`, `−`, `$`, `*`, `&` и пробелы.

     1. (опционально) Введите описание рассылки.
     1. Нажмите кнопку **Сохранить**.

   * На шаге **Что** укажите содержание рассылки:

     * Размер скриншота. Доступные значения:
       
       
       * ширина — от `360` до `1920` пикселей;

       
       * высота — от `400` до `6000` пикселей. Используйте опцию `Авто` для автоматического подбора высоты, чтобы на скриншоте поместились все чарты с вкладки дашборда.

     * Состояние дашборда. По умолчанию состояние первой вкладки дашборда уже добавлено в содержание рассылки. При необходимости скорректируйте его. В одной рассылке можно отправлять несколько состояний дашборда. Чтобы добавить еще одно состояние, нажмите **Добавить**.

       * Укажите, скриншот какой вкладки и с какими фильтрами будет приходить в рассылке:
         
         * Нажмите ![image](../../../_assets/console-icons/pencil.svg) **Редактировать**. В открывшемся окне перейдите на нужную вкладку дашборда, настройте фильтры и нажмите **Готово**.
         * Нажмите ![image](../../../_assets/console-icons/eye.svg) **Предпросмотр**, чтобы посмотреть скриншот рассылки.
         * Нажмите ![image](../../../_assets/console-icons/arrow-up-right-from-square.svg), чтобы открыть текущий дашборд в новой вкладке.

       * Чтобы изменить заголовок состояния, нажмите ![image](../../../_assets/console-icons/pencil.svg).
       
       {% note info %}

       * Обновляйте состояние, если меняете селекторы или поля датасета.

       {% endnote %}

     После сохранения рассылки вы можете изменить ее содержание на вкладке **Содержание**.

     {% cut "Содержание рассылки" %}

     ![maillist-content](../../../_assets/datalens/dashboard/maillist-content.png =687x436)
   
     {% endcut %}

   * На шаге **Когда** укажите параметры отправки:

     * **Триггер** — задайте событие для отправки рассылки. В настоящее время доступна отправка рассылки по расписанию. Скоро будет доступна отправка по алерту и при обновлении дашборда.

      {% list tabs %}

      - Расписание

        Настройте периодичность отправки рассылки:

        {% list tabs %}
        
        - День

          Рассылка будет отправляться один раз в день. Укажите время рассылки в текущем часовом поясе.

        - Неделя

          Укажите дни недели и время рассылки в текущем часовом поясе.

        - Месяц

          Укажите число месяца и время рассылки в текущем часовом поясе.

        {% endlist %}

      {% endlist %}

     После сохранения рассылки вы можете изменить ее отправку на вкладке **Отправка**.

     {% cut "Отправка рассылки" %}

     ![maillist-sending](../../../_assets/datalens/dashboard/maillist-sending.png =687x436)
   
     {% endcut %}

   * На шаге **Кому** укажите получателей рассылки.

     
     {% note info %}

     * Чтобы получать рассылку, у пользователя должно быть активное рабочее место.
     * Если нет ни одного получателя с активным рабочим местом, рассылка отправляться не будет.

     {% endnote %}


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

     {% cut "Получатели рассылки" %}

     
     ![maillist-recipients](../../../_assets/datalens/dashboard/maillist-recipients-yc.png =687x436)



     {% endcut %}

   * На вкладке **История** вы можете просмотреть историю рассылки с указанием даты, времени и статуса выполнения. Доступно после сохранения рассылки.

     {% cut "История рассылки" %}

     ![maillist-history](../../../_assets/datalens/dashboard/maillist-history.png =687x436)
   
     {% endcut %}

1. Чтобы добавить несколько рассылок для дашборда, в окне **Рассылки дашборда** вверху слева нажмите ![image](../../../_assets/console-icons/plus.svg) и повторите действия шага 3.
1. Нажмите кнопку **Сохранить**.

После добавления рассылки она получает статус `Активна` и отправляется в соответствии с настройками указанным получателям.

Каждый получатель получит письмо рассылки:

* В теме письма отображается название рассылки.
* Вложение — скриншоты дашборда, файлы формата: `<название_рассылки> - <название_вкладки> - <дата_и_время_отправки>.png`.
* В содержании письма отображаются:
  
  * заголовок состояния;
  * скриншоты дашборда;
  * название дашборда, по которому сформирована рассылка, и ссылка на него;
  * ссылка, чтобы отписаться от рассылки;
  * ссылки на документацию DataLens и сервисы Yandex Cloud.

  {% cut "Содержание письма рассылки" %}

  ![maillist-attachment](../../../_assets/datalens/dashboard/maillist-attachment.png =450x1378)

  {% endcut %}

## Управление рассылками {#maillist-operations}

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

1. На панели слева нажмите ![image](../../../_assets/console-icons/layout-cells-large.svg) **Дашборды** и выберите нужный дашборд.
1. В верхней части экрана нажмите значок ![image](../../../_assets/console-icons/envelope.svg).
1. В списке слева выберите нужную рассылку. Вы можете воспользоваться поиском по названию или фильтром по статусу рассылки.
1. Выполните нужное действие:

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

   * Отправить рассылку сейчас. Внизу окна рассылок нажмите ![image](../../../_assets/console-icons/envelope.svg) **Отправить** и выберите, кому отправить рассылку: `Только себе` или `Всем получателям`.

   * Подписаться или отписаться:
     
     * Чтобы подписаться на рассылку, вверху под названием рассылки нажмите кнопку ![image](../../../_assets/console-icons/bell.svg) **Подписаться** или нажмите ![image](../../../_assets/console-icons/ellipsis.svg) → ![image](../../../_assets/console-icons/bell.svg) **Подписаться**.
     * Чтобы отписаться от рассылки, вверху под названием рассылки нажмите кнопку ![image](../../../_assets/console-icons/bell.svg) **Вы подписаны** или нажмите ![image](../../../_assets/console-icons/ellipsis.svg) → ![image](../../../_assets/console-icons/bell-slash.svg) **Отписаться**.

   * Приостановить или запустить:
     
     * Чтобы приостановить рассылку, вверху под названием рассылки нажмите кнопку ![image](../../../_assets/console-icons/circle-play.svg) **Активна** или нажмите ![image](../../../_assets/console-icons/ellipsis.svg) → ![image](../../../_assets/console-icons/pause.svg) **Приостановить**. Рассылка получит статус `На паузе` и не будет отправляться.
     * Чтобы запустить рассылку, вверху под названием рассылки нажмите кнопку ![image](../../../_assets/console-icons/circle-pause.svg) **На паузе** или нажмите ![image](../../../_assets/console-icons/ellipsis.svg) → ![image](../../../_assets/console-icons/play.svg) **Запустить**. Рассылка получит статус `Активна` и будет отправляться в соответствии с настройками.

   * Переименовать. Чтобы переименовать рассылку, вверху справа от названия рассылки нажмите ![image](../../../_assets/console-icons/ellipsis.svg) или под названием нажмите ![image](../../../_assets/console-icons/ellipsis.svg) → ![image](../../../_assets/console-icons/pencil.svg) **Переименовать**. В открывшемся окне введите название и описание рассылки и нажмите кнопку **Сохранить**.
   * Удалить. Чтобы удалить рассылку, вверху под названием рассылки нажмите ![image](../../../_assets/console-icons/ellipsis.svg) → ![image](../../../_assets/console-icons/trash-bin.svg) **Удалить**.