# Уведомления о заданиях

Платформа dbt

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

* Параметр **Succeeds** — запуск задания завершился успешно, без предупреждений и ошибок.
* Параметр **Warns** — при запуске задания возникли предупреждения от [тестов данных](https://docs.getdbt.tech/docs/build/data-tests.md) или проверок [актуальности источников](https://docs.getdbt.tech/docs/deploy/source-freshness.md).
  * Это уведомление вызывается записями уровня предупреждения в журнале этих шагов, а не общим статусом запуска задания. Задание со статусом «success» в пользовательском интерфейсе всё равно может вызвать уведомление о предупреждении, если на шагах тестирования или проверки актуальности в журнал были записаны предупреждения.
* Параметр **Fails** — запуск задания не удалось завершить.
* Параметр **Is canceled** — запуск задания отменён.
  * Уведомления в Slack могут не приходить для запусков, отменённых процессом очистки по тайм-ауту неактивности в dbt platform (этот процесс отменяет запуски, которые были неактивны в течение 10 минут). Чтобы получать уведомления об этих отменах, используйте [уведомления по электронной почте](#email-job-notification-teams) или [вебхуки](https://docs.getdbt.tech/docs/deploy/webhooks.md).

### Варианты уведомлений

В настоящее время dbt platform поддерживает следующие каналы уведомлений:

* [Электронная почта](#email-notifications)
* [Slack (с привязкой к пользователю)](#slack-notifications)
* [Slack (на уровне аккаунта)](#slack-notifications-account)
* [Microsoft Teams](#microsoft-teams-notifications)

Microsoft Teams

Если вы не можете использовать встроенную интеграцию с Microsoft Teams, вы всё равно можете отправлять уведомления о заданиях в канал Teams, указав адрес электронной почты канала в качестве внешнего адреса электронной почты, как описано в следующем разделе.

## Уведомления по электронной почте

Вы можете получать оповещения по электронной почте о заданиях, настроив параметры уведомлений по электронной почте в dbt Cloud.

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

### Предварительные требования

* Чтобы настроить уведомления по электронной почте в dbt, вы должны быть *пользователем с лицензией разработчика*, *администратором аккаунта* или иметь [набор разрешений](https://docs.getdbt.tech/docs/platform/manage-access/enterprise-permissions.md) **Notification Manager**. Подробнее см. в разделе [Пользователи и лицензии](https://docs.getdbt.tech/docs/platform/manage-access/seats-and-users.md).
  * Как пользователь с лицензией разработчика, вы можете настроить уведомления по электронной почте для себя.

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

* Стандартная [группа](https://docs.getdbt.tech/docs/platform/manage-access/about-user-access.md#groups) **Account Admin**, **Owner** или **Member**
* Набор разрешений [**Notification Manager**](https://docs.getdbt.tech/docs/platform/manage-access/enterprise-permissions.md) (Enterprise). Этот набор разрешений позволяет управлять уведомлениями во всех проектах без полного доступа администратора аккаунта

1. Выберите значок своего профиля, а затем нажмите **Настройки уведомлений**.

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

3. Нажмите значок своего профиля, а затем выберите **Notification settings**.

4. По умолчанию dbt отправляет уведомления на адрес электронной почты, указанный на странице **User profile**.

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

   1. В разделе Job notifications нажмите раскрывающийся список **Notification email**.

   2. Выберите другой адрес из списка. Список включает **Internal Users** — пользователей с доступом к аккаунту — и **External Emails** — добавленные внешние адреса электронной почты.

   3. Чтобы добавить внешний адрес электронной почты, нажмите раскрывающийся список **Notification email**

   4. Нажмите **Add external email**.

   5. Введите адрес электронной почты и нажмите Add user. После добавления внешний адрес электронной почты становится доступен для выбора в раскрывающемся списке **Notification email**. Внешними могут быть адреса, не связанные с вашим аккаунтом dbt, а также адреса для интеграций со сторонними сервисами, например [каналами в Microsoft Teams](https://support.microsoft.com/en-us/office/tip-send-email-to-a-channel-2c17dbae-acdf-4209-a761-b463bdaaa4ca) и [интеграцией PagerDuty через электронную почту](https://support.pagerduty.com/docs/email-integration-guide).

      примечание

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

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

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

7. Когда вы закончите с настройками, нажмите **Сохранить**.

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

   Чтобы настроить оповещения о заданиях из другой среды, выберите другую **Среду** из выпадающего списка, **Изменить** настройки уведомлений о заданиях и **Сохранить** изменения.

   [![Пример страницы уведомлений по электронной почте](/img/docs/deploy/example-email-notification-settings-page.png?v=2 "Пример страницы уведомлений по электронной почте")](#)Пример страницы уведомлений по электронной почте

### Отписка от уведомлений по электронной почте

1. Нажмите на значок своего профиля и выберите **Notification settings**.
2. На странице **Email notifications** нажмите **Unsubscribe from all email notifications**.

### Отправка уведомлений о заданиях в канал Microsoft Teams (по электронной почте)

Вы можете отправлять [уведомления о заданиях dbt по электронной почте](#email-notifications) непосредственно в канал Microsoft Teams, используя адрес электронной почты канала.

1. В Microsoft Teams получите адрес электронной почты канала, в который хотите отправлять уведомления. См. [Отправка сообщения электронной почты в канал](https://support.microsoft.com/en-us/office/tip-send-email-to-a-channel-2c17dbae-acdf-4209-a761-b463bdaaa4ca).
2. В dbt platform нажмите на свой профиль на левой боковой панели, а затем выберите **Notification settings**.
3. В разделе **Job notifications** откройте раскрывающийся список **Notification email**.
4. Чтобы добавить внешний адрес электронной почты, нажмите **Add external email** в нижней части раскрывающегося списка.
5. Введите адрес электронной почты канала Teams и нажмите **Add user**.
6. Убедитесь, что в раскрывающемся списке **Notification email** выбран адрес электронной почты канала Teams (возможно, он уже выбран).
7. Затем выберите среду, об уведомлениях о заданиях которой вы хотите получать сообщения.
8. Нажмите **Edit** и выберите нужные статусы заданий. Затем нажмите **Save**, чтобы сохранить настройки.

## Уведомления в Slack (на уровне пользователя)

Вы можете получать в Slack оповещения о заданиях, настроив интеграцию со Slack, а затем параметры уведомлений Slack в dbt. dbt интегрируется со Slack через OAuth для обеспечения безопасной аутентификации.

Эта интеграция со Slack настраивается на уровне пользователя; её не следует путать с функцией [уведомлений в Slack на уровне аккаунта](#slack-notifications-account).

примечание

Администраторы виртуальной частной сети (VPC) должны [связаться с поддержкой](mailto:support@getdbt.com) для завершения интеграции с Slack.

Если произошли изменения в ролях пользователей или разрешениях Slack, из-за которых у вас больше нет доступа к редактированию настроенного канала Slack, пожалуйста, [свяжитесь с поддержкой](mailto:support@getdbt.com) для получения помощи.

### Предварительные требования

* У вас есть рабочее пространство Slack, в котором вы хотите получать уведомления о заданиях.
* Вы должны быть владельцем рабочего пространства Slack.
* Для настройки уведомлений Slack в dbt вы должны быть администратором аккаунта. Подробнее см. в разделе [Пользователи и лицензии](https://docs.getdbt.tech/docs/platform/manage-access/seats-and-users.md). На данный момент интеграция поддерживает только *публичные* каналы в рабочем пространстве Slack.

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

* Членство в одной из стандартных [групп](https://docs.getdbt.tech/docs/platform/manage-access/about-user-access.md#groups): **Account Admin**, **Owner** или **Member**
* Набор разрешений [**Notification Manager**](https://docs.getdbt.tech/docs/platform/manage-access/enterprise-permissions.md) (Enterprise). Он позволяет управлять уведомлениями во всех проектах без полного доступа администратора аккаунта

### Настройка интеграции с Slack

1. Выберите **Account settings**, а затем — **Integrations** на левой боковой панели.
2. Найдите раздел **OAuth** с приложением Slack и нажмите **Link**.

   [![Ссылка для подключения приложения Slack](/img/docs/dbt-platform/Link-your-Slack-Profile.png?v=2 "Ссылка для подключения приложения Slack")](#)Ссылка для подключения приложения Slack

#### Если вы уже вошли в Slack

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

[![Предоставление dbt доступа к Slack](/img/docs/dbt-platform/Allow-dbt-to-access-slack.png?v=2 "Предоставление dbt доступа к Slack")](#)Предоставление dbt доступа к Slack

#### Выход из системы

Если вы вышли из системы или приложение/веб-сайт Slack закрыты, вам необходимо пройти аутентификацию перед завершением интеграции.

1. Заполните поле, указав рабочее пространство Slack, которое вы хотите интегрировать с dbt.

   [![Укажите рабочее пространство](/img/docs/dbt-platform/define-workspace.png?v=2 "Укажите рабочее пространство")](#)Укажите рабочее пространство
2. Войдите с помощью существующей учётной записи или используйте адрес электронной почты и пароль.
3. После успешной аутентификации предоставьте запрашиваемые разрешения.

   [![Разрешите dbt доступ к Slack](/img/docs/dbt-platform/accept-permissions.png?v=2 "Разрешите dbt доступ к Slack")](#)Разрешите dbt доступ к Slack

### Настройка уведомлений в Slack

1. Выберите значок своего профиля, а затем нажмите **Настройки уведомлений**.

2. Выберите **Уведомления в Slack** в левой боковой панели.

3. Выберите **Канал уведомлений**, из которого вы хотите получать уведомления о выполнении заданий, из выпадающего списка.

   [![Пример выпадающего списка Канал уведомлений](/img/docs/deploy/example-notification-slack-channels.png?v=2 "Пример выпадающего списка Канал уведомлений")](#)Пример выпадающего списка Канал уведомлений

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

5. Нажмите **Изменить**, чтобы настроить параметры уведомлений в Slack. Выберите один или несколько статусов выполнения для каждого задания, о которых вы хотите получать уведомления.

6. Когда вы закончите с настройками, нажмите **Сохранить**.

   Чтобы отправлять оповещения в другой канал Slack, выберите другой **Канал уведомлений** из выпадающего списка, **Изменить** настройки уведомлений о заданиях и **Сохранить** изменения.

   Чтобы настроить оповещения о заданиях из другой среды, выберите другую **Среду** из выпадающего списка, **Изменить** настройки уведомлений о заданиях и **Сохранить** изменения.

   [![Пример страницы уведомлений в Slack](/img/docs/deploy/example-slack-notification-settings-page.png?v=2 "Пример страницы уведомлений в Slack")](#)Пример страницы уведомлений в Slack

7. Выберите **Account settings** и на странице **Integrations** прокрутите до раздела **OAuth**.

8. Нажмите значок **X** (справа от интеграции со Slack), затем нажмите **Unlink**. Настроенные вами каналы больше не будут получать уведомления в Slack. *Это действие не распространяется на весь аккаунт.* Каналы, настроенные другими администраторами аккаунта, продолжат получать уведомления в Slack, если у этих администраторов по-прежнему активны интеграции со Slack. Чтобы передать управление настройками уведомлений для канала Slack, попросите другого администратора аккаунта изменить свои настройки.

## Уведомления в Slack (на уровне аккаунта)

Интегрируйте Slack с dbt platform на уровне аккаунта, чтобы получать уведомления о заданиях в Slack. dbt интегрируется со Slack через OAuth для безопасной аутентификации.

Один аккаунт dbt platform можно интегрировать с одним рабочим пространством Slack.

### Предварительные требования

* У вас есть рабочее пространство Slack, в котором вы хотите получать уведомления о заданиях.
* Администратор аккаунта dbt platform должен подключить приложение Slack на уровне аккаунта.
* Установите официальное приложение dbt platform для Slack, выполнив [действия, описанные в следующем разделе](#set-up-the-slack-integration-1).
* Для установки приложения Slack в рабочее пространство в вашей организации Slack должна быть разрешена установка приложений. В некоторых организациях для этого требуется одобрение администратора Slack.
* На данный момент интеграция поддерживает только *общедоступные* каналы рабочего пространства Slack.

После того как администратор аккаунта подключит приложение Slack, пользователи с лицензиями смогут настраивать уведомления о заданиях, если им назначено что-либо из следующего:

* Стандартная [группа](https://docs.getdbt.tech/docs/platform/manage-access/about-user-access.md#groups) **Account Admin**, **Owner** или **Member**
* Набор разрешений [**Notification Manager**](https://docs.getdbt.tech/docs/platform/manage-access/enterprise-permissions.md) (Enterprise). Это разрешение позволяет управлять уведомлениями во всех проектах без полного доступа уровня Account Admin

Пользователи с лицензиями IT могут получать уведомления о заданиях, но не могут [настраивать их](https://docs.getdbt.tech/docs/platform/manage-access/seats-and-users.md?version=1.12). Подключать и отключать рабочее пространство Slack могут только пользователи с ролью **Account Admin**.

### Настройка интеграции со Slack

Интеграция со Slack на уровне аккаунта использует официальное приложение dbt platform для Slack, которое отличается от [интеграции со Slack на уровне пользователя](#slack-notifications).

Чтобы использовать уведомления в Slack, необходимо отключить старое приложение Slack, а затем подключить официальное приложение:

1. Перейдите в **Account settings** > **Integrations** > **OAuth**.
2. Нажмите значок **X** рядом со Slack и выберите **Unlink**.
3. В том же разделе OAuth нажмите **Link**, чтобы подключить официальное приложение Slack.

Пока вы этого не сделаете, вариант интеграции со Slack на уровне аккаунта не появится.

[![Подключение приложения Slack](/img/docs/dbt-platform/Link-your-Slack-Profile.png?v=2 "Подключение приложения Slack")](#)Подключение приложения Slack

### Если вы уже вошли в Slack

Если вы уже вошли в Slack, для интеграции достаточно предоставить приложению доступ. Если вы состоите в нескольких рабочих пространствах, выберите нужное в раскрывающемся меню в правом верхнем углу.

[![Предоставление dbt доступа к Slack](/img/docs/dbt-platform/Allow-dbt-to-access-slack.png?v=2 "Предоставление dbt доступа к Slack")](#)Предоставление dbt доступа к Slack

### Если вы не вошли в Slack

Если вы вышли из Slack или приложение либо сайт Slack закрыты, перед завершением интеграции необходимо пройти аутентификацию.

1. Заполните поле, указав рабочее пространство Slack, которое вы хотите интегрировать с dbt.

   [![Указание рабочего пространства](/img/docs/dbt-platform/define-workspace.png?v=2 "Указание рабочего пространства")](#)Указание рабочего пространства

2. Войдите с помощью существующей учётной записи или используйте адрес электронной почты и пароль.

3. После успешной аутентификации предоставьте запрашиваемые разрешения.

   [![Предоставление dbt доступа к Slack](/img/docs/dbt-platform/accept-permissions.png?v=2 "Предоставление dbt доступа к Slack")](#)Предоставление dbt доступа к Slack

### Настройка уведомлений в Slack

Настройте канал Slack, в котором вы хотите получать уведомления о заданиях.

1. Нажмите значок своего профиля, затем выберите **Notification settings**.

2. Выберите **Slack notifications** на левой боковой панели.

3. В первом раскрывающемся списке выберите **Notification channel** — канал, в котором вы хотите получать уведомления о запусках заданий.

   [![Пример раскрывающегося списка Notification channel](/img/docs/deploy/example-notification-slack-channels.png?v=2 "Пример раскрывающегося списка Notification channel")](#)Пример раскрывающегося списка Notification channel

4. Во втором раскрывающемся списке выберите **Environment** — окружение для заданий, о которых вы хотите получать уведомления.

5. Нажмите **Edit**, чтобы настроить уведомления в Slack. Выберите один или несколько статусов запуска для каждого задания, о котором хотите получать уведомления.

6. Завершив настройку, нажмите **Save**.

   * Чтобы отправлять оповещения в другой канал Slack, выберите другой **Notification channel** в раскрывающемся списке, нажмите **Edit**, настройте уведомления о заданиях и сохраните изменения кнопкой **Save**.
   * Чтобы настроить оповещения о заданиях из другого окружения, выберите другое **Environment** в раскрывающемся списке, нажмите **Edit**, настройте уведомления о заданиях и сохраните изменения кнопкой **Save**.

   [![Пример страницы уведомлений в Slack](/img/docs/deploy/example-slack-notification-settings-page.png?v=2 "Пример страницы уведомлений в Slack")](#)Пример страницы уведомлений в Slack

Готово! Теперь ваш канал Slack настроен для получения уведомлений о заданиях dbt на уровне аккаунта. Эта интеграция доступна во всём аккаунте для всех пользователей с лицензиями.

### Перенос устаревших настроек уведомлений в Slack

Если вы ранее настроили уведомления в Slack с помощью устаревшей интеграции, на странице **Slack notifications** может появиться баннер переноса настроек.

[![Пример баннера переноса настроек Slack](/img/docs/deploy/migrating-legacy-slack-notifications.png?v=2 "Пример баннера переноса настроек Slack")](#)Пример баннера переноса настроек Slack

Баннер появляется, когда выполняются все следующие условия:

* У вас есть настройки уведомлений от предыдущей интеграции со Slack.
* Ваш аккаунт подключён к приложению dbt platform.
* Вы ещё не настроили уведомления в Slack с помощью приложения dbt platform.

Перед переносом необходимо отключить устаревшую интеграцию со Slack и подключить приложение dbt platform. Отключение устаревшей интеграции выполняется вручную; одновременно может быть подключено только одно приложение Slack.

к сведению

Приложение dbt platform для Slack отправляет уведомления о заданиях только в *общедоступные* каналы вашего рабочего пространства. Закрытые каналы не поддерживаются.

1. Нажмите **Migrate settings**, чтобы скопировать существующие настройки в приложение dbt platform, включая:

   * Выбранные **Notification channel** и **Environment**
   * Выбранные задания
   * Состояния переключателей уведомлений (например, **Succeeds**, **Warns**, **Fails** и **Is canceled**)

2. Нажмите **Dismiss**, чтобы скрыть баннер на время текущего сеанса — он будет появляться снова при перезагрузке страницы, пока перенос не будет завершён.

После успешного переноса dbt скроет баннер и обновит ваши настройки уведомлений в Slack. Если перенос завершится ошибкой, баннер останется, чтобы вы могли повторить попытку.

[![Пример инструкций по приглашению приложения dbt platform](/img/docs/deploy/dbt-platform-slack-invite.png?v=2 "Пример инструкций по приглашению приложения dbt platform")](#)Пример инструкций по приглашению приложения dbt platform

### Отключение интеграции со Slack

На этом шаге вы отключите интеграцию со Slack и удалите учётные данные Slack на уровне аккаунта. Вы всегда можете снова включить интеграцию, выполнив действия из раздела [Настройка интеграции со Slack](#set-up-the-slack-integration-1).

1. Выберите **Account settings** и на странице **Integrations** прокрутите до раздела **OAuth**.

2. Нажмите значок **X** (справа от интеграции со Slack), затем нажмите **Unlink**.

   * Это удалит учётные данные Slack на уровне аккаунта. Отправка всех уведомлений в Slack, использующих интеграцию на уровне аккаунта, прекратится.
   * Если остались устаревшие интеграции со Slack на уровне пользователя, отправка соответствующих уведомлений может продолжаться до отключения этих интеграций. Мы рекомендуем перейти на новое приложение, работающее на уровне аккаунта, и отключить устаревшие подключения.

## Уведомления в Microsoft Teams

Вы можете получать оповещения о заданиях dbt в Microsoft Teams, подключив свою учётную запись Teams к dbt platform и настроив параметры уведомлений.

dbt интегрируется с Teams через Microsoft Entra для безопасной аутентификации при подключении Teams и настройке уведомлений.

### Предварительные требования

Прежде чем начать:

* У вас должен быть аккаунт dbt platform
* У вас есть учётная запись Microsoft Teams, в которой вы хотите получать уведомления о заданиях.
* Убедитесь, что у вас есть разрешение на просмотр страниц **Account integrations** и **Job notifications** в dbt platform.

После того как администратор аккаунта подключит приложение Microsoft Teams, пользователи с лицензиями смогут настраивать уведомления о заданиях, если им назначено что-либо из следующего:

* Стандартная [группа](https://docs.getdbt.tech/docs/platform/manage-access/about-user-access.md#groups) **Account Admin**, **Owner** или **Member**
* Набор разрешений [**Notification Manager**](https://docs.getdbt.tech/docs/platform/manage-access/enterprise-permissions.md) (Enterprise). Это разрешение позволяет управлять уведомлениями во всех проектах без полного доступа уровня Account Admin

### Настройка Microsoft Teams

Чтобы включить уведомления о заданиях в Microsoft Teams, выполните действия из следующих разделов:

1. [Подключение аккаунта dbt platform к Teams](#link-dbt-platform-account-to-teams) — подключение на уровне пользователя, которое связывает отдельную учётную запись dbt platform (или выделенную служебную учётную запись) с профилем пользователя Microsoft Teams в вашем клиенте.
2. [Настройка уведомлений в Teams](#configure-teams-notifications) — настройка каналов Teams, в которые будут поступать уведомления о заданиях.
3. [Отключение интеграции с Teams](#disable-the-teams-integration) (необязательно) — удаление или сброс подключения между dbt platform и Microsoft Teams.

### Подключение аккаунта dbt platform к Teams

к сведению

Вы можете подключить любую учётную запись пользователя Teams из своего клиента, но мы рекомендуем создать отдельную учётную запись исключительно для публикации уведомлений dbt. В процессе OAuth вам потребуется войти в учётную запись Microsoft, чтобы завершить интеграцию.

* Если вы вошли только в одну учётную запись Microsoft, интеграция завершится автоматически.
* Если вы вошли в несколько учётных записей (или не вошли ни в одну), вам предложат выбрать учётную запись или войти в неё.

 Изображение всплывающего окна выбора учётной записи Microsoft

[![Пример всплывающего окна выбора учётной записи Microsoft](/img/docs/deploy/pick-account.png?v=2 "Пример всплывающего окна выбора учётной записи Microsoft")](#)Пример всплывающего окна выбора учётной записи Microsoft

Чтобы подключить аккаунт dbt platform к Microsoft Teams:

1. В dbt platform перейдите на страницу **Account settings**, нажав на название своего аккаунта и выбрав **Account settings**.
2. На левой боковой панели выберите **Integrations**.
3. Прокрутите до раздела **OAuth**.
4. Рядом с **Teams** нажмите кнопку **Link**.
5. После этого вам предложат выбрать учётную запись Microsoft перед завершением настройки либо вы сразу вернётесь в dbt platform с подключённым профилем Teams.
6. Теперь ваш аккаунт dbt platform подключён к Microsoft Teams!

Теперь dbt добавит приложение **dbt-cloud-integration** в ваш клиент Microsoft Entra. Это приложение обеспечивает безопасное управление запросами аутентификации и разрешениями.

[![Пример страницы обзора приложения dbt-cloud-integration](/img/docs/deploy/dbt-cloud-integrations.png?v=2 "Пример страницы обзора приложения dbt-cloud-integration")](#)Пример страницы обзора приложения dbt-cloud-integration

* Текущие разрешения приложения Entra:

  * `profile`
  * `openid`
  * `offline_access`
  * `Team.ReadBasic.All`
  * `TeamsActivity.Send`
  * `ChannelMessage.Send`
  * `ChannelMessage.Read.All`
  * `Channel.ReadBasic.All`

к сведению

Приложение `dbt-cloud-integration` — это мультитенантное приложение Microsoft Entra, которое уже принадлежит dbt Labs. Вам не нужно ничего предварительно регистрировать в своём клиенте. Предоставление согласия при выполнении **Link** регистрирует приложение в вашем клиенте как корпоративное приложение (Enterprise Application). Такой же механизм используют другие мультитенантные SaaS-приложения, например Slack или Zoom.

### Устранение неполадок при подключении Teams

Если процесс **Link** завершается ошибкой `AADSTS90094: Admin consent is required`, в вашем клиенте Microsoft Entra ограничена возможность предоставления пользователями согласия для сторонних приложений.

Чтобы устранить эту проблему, попросите администратора Entra (Cloud Application Administrator или Global Administrator) выполнить одно из следующих действий:

* Самостоятельно выполнить шаг **Link** и подтвердить запрос согласия.
* Предоставить согласие администратора для приложения `dbt-cloud-integration` в разделе **Enterprise applications** центра администрирования Entra.

После предоставления согласия администратора повторите процесс **Link** в dbt platform. Дополнительную информацию см. в [документации Microsoft](https://learn.microsoft.com/en-us/answers/questions/5637987/corporate-account-apps-registration-error-aadsts90).

### Настройка уведомлений в Teams

После подключения dbt platform к Teams вы можете настроить, в какие каналы Teams будут поступать уведомления о заданиях. Для доступа к меню **Teams notifications** в аккаунте должна быть активна интеграция с Teams.

к сведению

В настоящее время dbt отправляет уведомления только в те каналы Teams (стандартные, общие или частные), в которых вы состоите.

1. В dbt platform нажмите значок своего профиля и выберите **Notification settings**.
2. Выберите **Teams notifications** на левой боковой панели.
3. В первом раскрывающемся списке выберите **Notification team** — команду, в которую вы хотите отправлять уведомления.
4. Во втором раскрывающемся списке выберите **Notification channel** — канал, в который вы хотите отправлять уведомления.
   * dbt platform отправляет уведомления только в те каналы Teams (стандартные, общие или частные), в которых состоите *вы*.
5. В раскрывающемся списке выберите окружение для заданий, о которых вы хотите получать уведомления.
6. Нажмите **Edit** в правом верхнем углу, чтобы настроить уведомления о заданиях в Teams и выбрать статусы заданий, при которых отправляются уведомления.
7. Завершив настройку, нажмите **Save**.

Теперь ваш канал Teams настроен для получения уведомлений о заданиях dbt!

[![Пример страницы настройки уведомлений в Teams](/img/docs/deploy/configure-teams-notification.png?v=2 "Пример страницы настройки уведомлений в Teams")](#)Пример страницы настройки уведомлений в Teams

### Отключение интеграции с Teams

При отключении и удалении подключения интеграции с Teams в dbt platform она удаляется для всего аккаунта. Чтобы отключить её:

1. В dbt platform перейдите в **Account settings**.
2. Нажмите **Integrations** и прокрутите вниз до **OAuth**.
3. Справа от интеграции **Teams** нажмите значок **X**.
4. Подтвердите отключение, выбрав **Unlink**.

Интеграция с Teams отключена. Вы всегда можете снова включить её, выполнив действия из раздела [Настройка Microsoft Teams](#set-up-microsoft-teams).
