В этой статье
Обзор
dropdown icon
Прежде чем начать
    Подготовьте Gmail к использованию OAuth 2.0
    Подготовьте Microsoft 365 к OAuth 2.0
Настройте почтовый ресурс в Control Hub
dropdown icon
Настройте пересылку входящей электронной почты
    Настройте пересылку в Gmail
    Настройте пересылку в Microsoft 365
Протестируйте ресурс электронной почты
Настройка ресурса электронной почты
list-menuВ этой статье
list-menuОтправить обратную связь?

Создайте и аутентифицируйте цифровой ресурс электронной почты в Control Hub, а затем назначьте его сервису Webex, например Webex Connect или Webex Contact Center.

Обзор

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

При создании ресурса назначьте его сервису Webex, который будет его использовать. После успешной аутентификации Control Hub генерирует адрес для пересылки входящей электронной почты. Затем в Webex Contact Center можно связать ресурс с точкой ввода электронной почты. Для другой рабочей нагрузки Webex продолжите настройку этой рабочей нагрузки после создания ресурса.

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

  • Войдите в Control Hub как полноправный администратор, администратор клиентов или администратор партнеров, который может управлять цифровыми активами в вашей организации.
  • Используйте поддерживаемого поставщика услуг электронной почты. Для интеграции контакт-центра Webex с Webex Connect поддерживаемыми поставщиками являются Gmail и Microsoft 365. Сведения о конкретном поставщике см. в разделе Электронная почта — WXCC.
  • Подготовьте почтовый ящик, который хотите настроить. Если вы используете служебную учетную запись, убедитесь, что она может отправлять электронную почту и получать доступ к этому почтовому ящику.
  • Обратитесь к администратору поставщика идентификационных данных, чтобы зарегистрировать приложение OAuth, дать согласие и включить такие настройки поставщика, как SMTP AUTH или внешняя пересылка.
  • Будьте готовы скопировать URL-адрес обратного вызова из Control Hub в URL-адрес перенаправления приложения OAuth и настроить автоматическую переадресацию на адрес, созданный для почтового ресурса.

Подготовьте Gmail к использованию OAuth 2.0

Чтобы подготовить учетную запись Gmail для почтового ресурса, выполните следующие действия:

1

Войдите в консоль Google Cloud и создайте проект или выберите существующий.

2

Перейдите в раздел API и сервисы > Экран согласия OAuth, выберите «Внешнее» и введите название приложения, адрес электронной почты службы поддержки пользователей и контактную информацию разработчика.

3

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

4

Перейдите в раздел API и службы > Учетные данные, создайте идентификатор клиента OAuth для веб-приложения и скопируйте идентификатор клиента и секрет клиента.

5

Когда Control Hub покажет URL-адрес обратного вызова, вернитесь к клиенту OAuth и добавьте это значение в качестве авторизованного URI перенаправления.

6

Для использования в производственных целях опубликуйте приложение OAuth и выполните все проверки Google, необходимые для запрашиваемой области.

7

Запишите следующие значения поставщика для конфигурации Control Hub:

  • SMTP-сервер: smtp.gmail.com
  • Порт: 587
  • URL-адрес авторизации: https://accounts.google.com/o/oauth2/v2/auth
  • Область применения: https://mail.google.com/
  • URL-адрес токена доступа: https://oauth2.googleapis.com/token
  • Обновить URL-адрес токена: https://oauth2.googleapis.com/token

Для внешнего тестируемого приложения Google OAuth срок действия полномочий тестовых пользователей и токенов обновления истекает через семь дней после получения согласия. Опубликуйте приложение для использования в производственных целях. Если Google не вернет токен обновления, снова запустите процесс получения согласия и выберите вариант «Я хочу предварительно проверить» , прежде чем давать согласие на аутентификацию, когда эта опция будет доступна.

Документация Google по SMTP OAuth объясняет область действия SMTP OAuth в Gmail. Руководство Google по работе с аудиторией OAuth объясняет внутреннюю и внешнюю аудиторию, а также поведение в связи с публикационным статусом.

Подготовьте Microsoft 365 к OAuth 2.0

Чтобы подготовить почтовый ящик Microsoft 365 для почтового актива, выполните следующие действия:

1

В Центре администрирования Microsoft Entra перейдите в раздел Регистрация приложений, выберите Новая регистрация и зарегистрируйте приложение для типов учетных записей, разрешенных в вашей организации.

2

Запишите идентификатор приложения (клиента) и идентификатор каталога (арендатора).

3

В поле Аутентификация добавьте веб-платформу. Когда Control Hub покажет URL-адрес обратного вызова, добавьте это значение в качестве URI перенаправления.

4

В разделе Сертификаты и секреты создайте секрет клиента и скопируйте его значение, прежде чем покинуть страницу.

5

Для интерактивного потока кодов авторизации, используемого при выборе опции Создать токены, добавьте делегированное разрешение Office 365 Exchange Online SMTP.send (https://outlook.office.com/SMTP.Send) и запросите область offline_access. Предоставьте согласие администратора, если этого требует политика согласия вашей организации.

6

В Центре администрирования Microsoft 365 перейдите в раздел Пользователи > Активные пользователи, выберите пользователя почтового ящика, выберите Почта > Управление приложениями электронной почты, включите SMTP с аутентификацией для этого почтового ящика и сохраните изменения.

7

Запишите следующие значения поставщика. Замените {tenant-id} идентификатором каталога (арендатора), указанным при регистрации приложения:

  • SMTP-сервер: smtp.office365.com
  • Порт: 587
  • URL-адрес авторизации: https://login.microsoftonline.com/{tenant-id}/oauth2/v2.0/authorize
  • Область применения: offline_access https://outlook.office.com/SMTP.Send
  • URL-адрес токена доступа: https://login.microsoftonline.com/{tenant-id}/oauth2/v2.0/token
  • Обновить URL-адрес токена: https://login.microsoftonline.com/{tenant-id}/oauth2/v2.0/token

Используйте делегированную область https://outlook.office.com/SMTP.Send вместе с offline_access для этого интерактивного потока токенов. Включите SMTP AUTH только для нужного почтового ящика. Если ваша организация недавно изменила настройки согласия Microsoft Entra, дождитесь вступления изменений в силу, прежде чем создавать токены.

Руководство Microsoft по SMTP OAuth охватывает делегированные SMTP.send и offline_access. В конфигурации Microsoft SMTP AUTH объясняется, как включить SMTP AUTH для определенного почтового ящика.

Настройте почтовый ресурс в Control Hub

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

1

Войдите в Control Hub.

2

Перейдите в раздел Сервисы > Цифровые активы.

3

Выберите Создать актив.

4

В разделе Настройка сведений об ресурсе введите значения в следующие поля:

  • Имя: введите буквенно-цифровое имя актива. Не используйте пробелы или специальные символы.
  • Описание: необязательно. Введите краткое описание, которое поможет администраторам идентифицировать ресурс.
  • Канал: выберите «Электронная почта». После создания ресурса нельзя изменить назначенный сервис или канал.
  • Назначить: выберите сервис Webex, в котором будет использоваться ресурс. Например, выберите контактный центр Webex, если этот ресурс будет использовать контактный центр.
5

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

6

В разделе Аутентификация OAuth 2.0 введите значения в следующие поля:

  • SMTP-сервер: в Gmail введите smtp.gmail.com. Для Microsoft 365 введите smtp.office365.com.
  • Имя пользователя: введите адрес электронной почты почтового ящика или учетной записи службы, используемый для аутентификации SMTP.
  • Порт: введите 587 для Gmail или Microsoft 365. Подключение к провайдеру использует STARTTLS/TLS.
  • Идентификатор клиента: введите идентификатор клиента из приложения OAuth поставщика.
  • Секрет клиента: введите секретное значение клиента из приложения OAuth поставщика.
  • URL-адрес авторизации: Gmail: https://accounts.google.com/o/oauth2/v2/auth; Microsoft 365: https://login.microsoftonline.com/%7Btenant-id%7D/oauth2/v2.0/authorize.
  • Область применения: Gmail: https://mail.google.com/; Microsoft 365: offline_access https://outlook.office.com/SMTP.Send. Для входящей почты, использующей пересылку, разрешение на чтение почтового ящика не требуется.
  • URL-адрес токена доступа: Gmail: https://oauth2.googleapis.com/token; Microsoft 365: https://login.microsoftonline.com/%7Btenant-id%7D/oauth2/v2.0/token.
  • Обновить URL-адрес токена: используйте тот же URL-адрес поставщика, который указан в качестве URL-адреса токена доступа.
  • URL-адрес обратного вызова: скопируйте этот URL-адрес, доступный только для чтения, и добавьте его в качестве URI перенаправления или обратного вызова в приложении OAuth поставщика.
7

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

8

Если лицо, дающее согласие, использует адрес электронной почты, отличный от адреса почтового ящика, выберите «Генерировать токены», используя адрес электронной почты, отличный от адреса почтового ящика, и введите этот идентификатор.

Общий почтовый ящик. У общего почтового ящика нет собственных учетных данных для входа. Создавайте токены вместе с пользователем, который имеет доступ к общему почтовому ящику и имеет разрешение « Отправить как». Пользователю не нужен доступ администратора. Выберите Создать токены, используя адрес электронной почты, отличный от адреса почтового ящика, если адрес этого пользователя отличается от адреса почтового ящика.

9

Выберите Создать токены, заполните процедуру входа и получения согласия от поставщика идентификационных данных и вернитесь в Control Hub. После успешного создания токена поля «Токен доступа», «Обновить токен» и «Срок действия» заполняются автоматически.

Ограничение согласия: если ваш провайдер блокирует согласие пользователя, снимите флажок «Я хотел бы проверить это», прежде чем давать согласие на аутентификацию. Эта опция может привести к сбою аутентификации из-за того, что пользователь не сможет дать запрошенное согласие. Вместо этого попросите администратора поставщика предоставить необходимое согласие.

Если генерация токенов не работает: в Gmail убедитесь, что пользователь может авторизовать приложение и что оно имеет правильный статус публикации. В Microsoft 365 проверьте область действия offline_access, политику согласия, URI перенаправления и настройку SMTP AUTH. Исправьте конфигурацию поставщика, а затем снова сгенерируйте токены.

Продление токенов: сервис обновляет токены до истечения срока их действия. Если владелец арендатора автоматически получает электронное письмо с просьбой о регенерации токенов, откройте актив и снова выберите «Генерировать токены».

10

После успешного создания токенов нажмите кнопку Создать. Если ресурс назначен контакт-центру Webex, выберите Перейти к точкам входа и продолжите настройку контакт-центра. Для другой рабочей нагрузки Webex закройте страницу подтверждения и продолжите настройку в этой рабочей нагрузке.

Настройте пересылку входящей электронной почты

Сначала скопируйте адрес пересылки, созданный для ресурса:

1

В разделе «Цифровые активы» откройте ресурс электронной почты и выберите «Настройки».

2

В разделе Поставщик электронной почты > Почтовый ящик скопируйте адрес пересылки, связанный с адресом электронной почты почтового ящика.

Настройте пересылку в Gmail

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

1

Если вы используете Google Workspace, убедитесь, что администратор разрешил автоматическую пересылку сообщений в организационное подразделение почтового ящика в разделе Приложения > Google Workspace > Gmail > Доступ для конечных пользователей.

2

Войдите в почтовый ящик службы поддержки в Gmail и выберите Настройки > Просмотреть все настройки > Пересылка и POP/IMAP.

3

Выберите Добавить адрес для пересылки, вставьте адрес пересылки из Control Hub и заполните запросы на подтверждение. Gmail отправляет ссылку или код для подтверждения на сгенерированный адрес.

4

Получите ссылку или код для подтверждения входящей электронной почты из пакета Outbound Webhook Webex Connect или из полного текста письма в расшифрованных журналах отладки ресурса электронной почты. Затем завершите проверку в Gmail.

5

Вернитесь к настройкам пересылки Gmail, обновите страницу, выберите «Переслать копию входящей почты», выберите, что Gmail должен делать с этой копией, и нажмите «Сохранить изменения».

Настройте пересылку в Microsoft 365

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

1

Настройте переадресацию почтового ящика или правило папки «Входящие» для почтового ящика службы поддержки, чтобы новые сообщения отправлялись на адрес пересылки из Control Hub.

2

На портале Microsoft Defender ознакомьтесь с политикой исходящего спама, применимой к почтовому ящику. Установите для правил автоматической пересылки значение Вкл. Пересылка включена в политике с узкой областью действия, одобренной администратором безопасности.

3

В Exchange Online убедитесь, что соответствующий параметр удаленного домена разрешает автоматическую переадресацию в домен с адресами пересылки.

4

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

5

Сохраните конфигурацию пересылки и подождите, пока изменения политики Microsoft 365 вступят в силу.

Обязательно: входящая электронная почта не попадет в назначенную рабочую нагрузку Webex, пока не будет включена пересылка. В Microsoft 365 политика блокировки исходящего спама, настройка удаленного домена или правило потока обработки почты имеют приоритет над настройкой, разрешающей пересылку.

Ограничение по количеству вложений. Входящие вложения электронной почты ограничены 25 МБ. Если сообщение не удается отправить из-за слишком большого размера вложений, отправитель получает сообщение об ошибке доставки и должен повторно отправить его с небольшими вложениями.

Встроенные изображения: встроенные изображения попадают на рабочий стол агента в виде вложений. Если сканирование PCI включено, эти изображения блокируются.

Microsoft OutlookВложения. Из-за ограничений входящее электронное письмо с вложением в формате.msg может поступать без файлов, встроенных в этот файл. Microsoft Outlook

Протестируйте ресурс электронной почты

Чтобы проверить полный путь к электронной почте, выполните следующие действия:

1

Из внешней учетной записи электронной почты отправьте сообщение в настроенный почтовый ящик службы поддержки и убедитесь, что сообщение соответствует назначенной рабочей нагрузке Webex.

2

Из назначенной рабочей нагрузки Webex отправьте новое сообщение или ответьте на входящее сообщение и убедитесь, что внешний получатель получил его.

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

3

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

4

Если исходящая отправка не работает, проверьте сервер и порт SMTP, разрешения поставщика, учетные данные клиента, согласие, настройку Microsoft 365 SMTP AUTH и статус токена. Устраните проблему и при необходимости снова создайте токены.

Была ли статья полезной?
Была ли статья полезной?