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

  • Статья

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

Примечание.

Вы можете легко опробовать интерактивные сообщения по электронной почте, отправив себе сообщение электронной почты с необходимой разметкой без вмешательства корпорации Майкрософт. Как правило, это первый шаг в изучении данной возможности. Ознакомьтесь с этими примерами, чтобы отправить сообщение с действиями в почтовый ящик или использовать Designer actionable Message для отправки вам сообщения с действиями.

Разработчики, которые работают с интерактивными электронными сообщениями, могут использовать этот портал в следующих случаях:

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

Во всех вышеперечисленных случаях вы отправляете корпорации Майкрософт определенные сведения, которые (после проверки и утверждения) позволят отправлять интерактивные сообщения из службы.

Разделы панели мониторинга

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

Сведения о поставщике

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

Основные поля:

  • Адрес электронной почты отправителя. Это один или несколько статических адресов электронной почты, соответствующих службе, которая будет отправлять сообщения электронной почты с разметкой действия. Пример: myservice@contoso.com.

  • Целевые URL-адреса. Целевой URL-адрес может соответствовать домену верхнего уровня или поддомену TLD. Целевой URL-адрес может соответствовать домену верхнего уровня или его поддомену. Эти URL-адреса должны поддерживать протокол HTTPS. https://api.myservice.com.

  • Открытый ключ. Если вы планируете отправлять сообщения с действиями в виде подписанной карточки, вам требуется указать открытый ключ, соответствующий закрытому ключу, который будет использоваться для подписи карточки. В качестве формата для этого поля используется элемент RSAKeyValue.

    <RSAKeyValue>
  <Modulus>xA7SEU+e0yQ...</Modulus>
  <Exponent>AQAB</Exponent>
</RSAKeyValue>

Пару ключей RSA можно создать и экспортировать в правильном формате с помощью PowerShell (7.3 или более поздней версии):

# Generate a key pair:
$rsa = [System.Security.Cryptography.RSA]::Create();

# Private Key, ensure this is saved securely and kept secret:
$rsa.ToXmlString($true)

## Public Key, copy output to dashboard:
$rsa.ToXmlString($false)

Пример получения XML-файла открытого ключа из файла .cert см. в разделе Класс PublicKey.

Примечание.

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

Adaptive card signature validation failed - Failed to validate signature

Область заявки

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

  • Тестовые пользователи. Позволяет службе отправлять сообщения электронной почты с действиями некоторым пользователям электронной почты Office 365 в вашей организации. Эта область обычно используется, чтобы проверить, как сообщения с действиями интегрируются с несколькими тестовыми пользователями, которых вы указали.
  • Организация. Позволяет отправлять сообщения с действиями от вашей службы любому пользователю почты Microsoft 365 в вашей организации. Как правило, эту область используют для включения интерактивных сообщений от службы, относящейся к организации, например внутреннего бизнес-приложения.
  • Глобальная. Позволяет службе отправлять интерактивные сообщения любому пользователю электронной почты в Office 365.

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

Примечание.

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

Самостоятельная регистрация

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

  • Тестовые пользователи. Запрос на регистрацию указанных вами тестовых пользователей одобряется автоматически. Это позволяет службе отправлять сообщения электронной почты с действиями тестовым пользователям.
  • Организация. Запрос на регистрацию будет отправлен администраторам вашей организации с разрешениями Администратор Exchange. Администратор с этими разрешениями получит письмо со сведениями об отправке запроса и сможет просмотреть и одобрить ваш запрос. Если роль Администратор Exchange не назначена никому из пользователей, письмо будет направлено пользователям с ролью Глобальный администратор.

После утверждения отправки (автоматически или администратором) регистрация вступит в силу в течение 24 часов.

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

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

Адреса электронной почты тестовых пользователей

Этот раздел применим, только если выбрана область заявки Тестовые пользователи на включение сообщений с действиями.

В этом разделе содержится список пользователей почты Microsoft 365 в вашей организации, которые разделены точкой с запятой (;). Благодаря этому вы сможете протестировать интеграцию сообщений с действиями на нескольких пользователях, прежде чем создавать область заявки Организация или Глобальная.

Контактные данные

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

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

Сведения об издателе

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

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

Сведения о сценарии

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

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

Сведения для проверки

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

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

Кроме того, отправьте действительное сообщение электронной почты, поступающее с рабочих серверов (или сервера с аналогичными заголовками DKIM/SPF/From:/Return-Path: ), включая разметку в onboardoam@microsoft.com. Эта процедура позволит корпорации Майкрософт определить, соответствует ли решение всем рекомендациям и требованиям, перечисленным в разделе Условия регистрации.

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

Условия регистрации

Существует ряд факторов, которые следует учитывать при отправке решения для утверждения с глобальной областью, так как это может оказать значительное влияние на пользователей в Office 365.

Рекомендации относительно качества отправителя электронной почты

  • Проверка подлинности электронных сообщений должна выполняться с помощью DKIM или SPF.
  • Домен верхнего уровня проверки SPF и подпись DKIM должны совпадать с доменом верхнего уровня в электронном адресе From:. Например, если вы используете адрес From: myservice@contoso.com, то DKIM или SPF должны быть указаны для домена contoso.com или -.contoso.com.
  • Электронные сообщения должны отправляться со статического адреса, например myservice@contoso.com.
  • Сообщения должны соответствовать рекомендациям относительно отправителей электронной почты.
  • Регулярная отправка больших объемов почты с вашего домена (не менее ста сообщений в Office 365 ежедневно) в течение как минимум нескольких недель.
  • Очень низкая частота жалоб на спам от пользователей.
  • Следует использовать конкретные, регламентированные и простые действия, доступные для вашей службы. Для более сложного взаимодействия можно использовать действия OpenURI.
  • Действия следует использовать для транзакционной почты, где ожидается высокая частота взаимодействия. Не следует применять их в массовых рекламных рассылках.

Рекомендации относительно действий

  • Подпись кнопки должна точно соответствовать выполняемому действию.
  • Действие Action.OpenUrl должно использовать прямую ссылку на определенную страницу, связанную с сущностью или сведениями, представленными в интерактивном сообщении.
  • Низкая частота сбоев и быстрый отклик служб, обрабатывающих запросы действий.
  • Дополнительные рекомендации по созданию интерактивных сообщений см. в статье Создание карточек интерактивных сообщений Outlook с использованием формата адаптивной карточки.

Утверждение заявки

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