Sms-события Служб коммуникации Azure (предварительная версия)

Соединитель для получения SMS-сообщений из ресурсов Служб коммуникации Azure в подписке.

Этот соединитель доступен в следующих продуктах и регионах:

Услуга Class Регионы
Copilot Studio Премия Все регионы Power Automate , кроме следующих:
     - Правительство США (GCC)
     - Правительство США (GCC High)
     — Облако Китая, управляемое 21Vianet
     - Министерство обороны США (DoD)
Логические приложения Стандарт Все регионы Logic Apps , кроме следующих:
     — Регионы Azure для государственных организаций
     — Регионы Azure Для Китая
     - Министерство обороны США (DoD)
Power Apps Премия Все регионы Power Apps , кроме следующих:
     - Правительство США (GCC)
     - Правительство США (GCC High)
     — Облако Китая, управляемое 21Vianet
     - Министерство обороны США (DoD)
Power Automate Премия Все регионы Power Automate , кроме следующих:
     - Правительство США (GCC)
     - Правительство США (GCC High)
     — Облако Китая, управляемое 21Vianet
     - Министерство обороны США (DoD)
Контакт
Имя Microsoft
URL https://azure.microsoft.com/services/communication-services
Адрес электронной почты acssolutions@microsoft.com
Метаданные соединителя
Publisher Microsoft
Веб-сайт https://azure.microsoft.com/services/communication-services
Политика конфиденциальности https://privacy.microsoft.com
Категории Communication

Соединитель SMS-событий Служб коммуникации Azure позволяет обрабатывать SMS-сообщения, отправленные на номера телефонов Служб коммуникации Azure.

Предпосылки

Для продолжения вам потребуется следующее:

  • План Microsoft Power Apps или Power Automate с пользовательским компонентом соединителя
  • Подписка Azure с зарегистрированным поставщиком ресурсов Сетки событий
  • Ресурс Служб коммуникации Azure
  • Приобретенный телефонный номер Служб коммуникации Azure, настроенный для получения SMS-сообщений

Получение учетных данных

  1. Создание ресурса Служб коммуникации Azure — документация по краткому руководству.

  2. Приобретите номер телефона в этом ресурсе с выбранной функцией "Отправить и получить SMS".

  3. Регистрация поставщика ресурсов Сетки событий для подписки, включаемой ресурсом Служб коммуникации Azure.

  4. Создайте пользователя или субъекта-службы Microsoft Entra ID, который можно использовать для подключения соединителя.

    • Вариант 1. Подключение с помощью учетной записи идентификатора Microsoft Entra — добавление нового пользователя
    • Вариант 2. Подключение с помощью проверки подлинности субъекта-службы (приложение Microsoft Entra ID) — вы также можете настроить субъект-службу, создать зарегистрированное приложение из Azure CLI или на портале Azure. Затем учетные данные можно использовать для проверки подлинности.

  5. Убедитесь, что пользователю или субъекту-службе Microsoft Entra ID назначены следующие разрешения:

    • Microsoft.Communication/CommunicationServices/Read

    • Microsoft.Resources/subscriptions/resourceGroups/read

    • Microsoft.EventGrid/eventSubscriptions/write

    • Microsoft.EventGrid/eventSubscriptions/read

    • Microsoft.EventGrid/eventSubscriptions/delete

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

    • Читатель. На уровне ресурсов Служб коммуникации Azure

    • Участник EventGrid EventSubscription — на уровне группы ресурсов

Начало работы с соединителем

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

Известные проблемы и ограничения

  • Активация временно отключена при обновлении, если задано значение "Имя подписки на событие" в поле "Имя подписки события" при создании триггера, любые обновления триггера (например, добавление номера телефона "Кому") может занять до 10 минут. В это время триггер не будет функционировать.
  • Подписка на события не удаляется, если подключение удалено до потока.

Создание подключения

Соединитель поддерживает следующие типы проверки подлинности:
Интегрированный идентификатор Microsoft Entra Используйте идентификатор Microsoft Entra для доступа к ресурсам событий ACS. Все регионы Недоступен для совместного использования
Проверка подлинности субъекта-службы (приложение идентификатора Microsoft Entra ID) Используйте проверку подлинности идентификатора Microsoft Entra для доступа к ресурсу Службы коммуникации Azure. Все регионы Недоступен для совместного использования
По умолчанию [не рекомендуется] Этот параметр предназначен только для старых подключений без явного типа проверки подлинности и предоставляется только для обратной совместимости. Все регионы Недоступен для совместного использования

Microsoft Entra id Integrated

Идентификатор проверки подлинности: aadOauth

Применимо: все регионы

Используйте идентификатор Microsoft Entra для доступа к ресурсам событий ACS.

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

Проверка подлинности субъекта-службы (приложение идентификатора Microsoft Entra ID)

Идентификатор проверки подлинности: aadOauthClientCredentials

Применимо: все регионы

Используйте проверку подлинности идентификатора Microsoft Entra для доступа к ресурсу Службы коммуникации Azure.

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

Имя Тип Description Обязательно
Идентификатор арендатора струна Идентификатор клиента приложения Microsoft Entra ID. True
Идентификатор клиента струна Идентификатор клиента (или приложения) приложения Microsoft Entra ID. True
Секрет клиента securestring Секрет клиента приложения Идентификатора Microsoft Entra. True

По умолчанию [не рекомендуется]

Применимо: все регионы

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

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

Ограничения регулирования

Имя Вызовы Период обновления
Вызовы API для каждого подключения 100 60 секунд

Триггеры

При получении SMS-сообщения

При получении SMS-сообщения служб коммуникации Azure.

При получении SMS-сообщения

Идентификатор операции:
CreateSMSReceivedEventSubscription

При получении SMS-сообщения служб коммуникации Azure.

Параметры

Имя Ключ Обязательно Тип Описание
Subscription
 subscriptionId True string

Уникальный идентификатор подписки Microsoft Azure. Идентификатор подписки является частью идентификатора для каждого ресурса Azure.
Имя группы ресурсов
 resourceGroupName True string

Имя группы ресурсов, содержащей ресурс.
Имя ресурса
 resourceName True string

Имя ресурса служб коммуникации.
Фильтрация по номеру телефона
 toPhoneNumbers array of string
Фильтрация по номеру телефона
 fromPhoneNumbers array of string
Имя подписки на события
 eventSubscriptionName string

Имя новой подписки на событие.
includedEventTypes
 includedEventTypes True array of string

Возвращаемое значение

Имя Путь Тип Описание
array of object
Кому
 data.to string
От
 data.from string
Message
 data.message string
Полученная метка времени
 data.receivedTimestamp string
Идентификатор сообщения
 data.messageId string