Обработка событий SMS

2025-04-22

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

Завершение этой статьи обойдется вам в небольшую стоимость — несколько центов США или даже меньше в вашей учетной записи Azure.

Это важно

Возможности SMS и ТСОП зависят от используемого номера телефона и страны или региона, в которых вы работаете согласно вашему адресу выставления счетов в Azure. Дополнительные сведения см. в документации по условиям подписки.

Предпосылки

Учетная запись Azure с активной подпиской. Создайте учетную запись бесплатно .
Ресурс служб коммуникации. Подробные сведения см. в статье "Создание ресурса Службы коммуникации Azure".
Номер телефона с поддержкой SMS. Получите номер телефона.

О службе Event Grid

Сетка событий — это облачная служба событий. В этой статье вы узнаете, как подписаться на события службы коммуникации и активировать событие для просмотра результата. Как правило, события отправляются на конечную точку, которая обрабатывает данные событий и выполняет соответствующие действия. В этой статье описывается, как отправлять события в веб-приложение, которое собирает и отображает сообщения.

Настройка среды

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

Регистрация поставщика ресурсов Event Grid

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

Перейдите на портал Azure.
В меню слева выберите Подписки.
Выберите подписку, используемую для сетки событий.
В разделе Параметры выберите Поставщики ресурсов.
Найдите Microsoft.EventGrid.
Если поставщик ресурсов не зарегистрирован, выберите "Зарегистрировать".

Регистрация может занять некоторое время. Щелкните Обновить, чтобы обновить состояние. Когда зарегистрировано в разделе "Состояние", вы будете готовы продолжить.

Развертывание средства просмотра сетки событий

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

Чтобы настроить средство просмотра, выполните действия, описанные в Viewer для Сетки событий Azure.

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

На портале перейдите к созданному ресурсу Служб коммуникации.
В ресурсе Служб коммуникации в меню слева на странице служб коммуникации выберите "События".
Выберите "Добавить подписку на события".
На странице "Создание подписки на событие" введите имя подписки на события.
В разделе "Типы событий" выберите события, на которые вы хотите подписаться. Для SMS можно выбрать SMS Received и SMS Delivery Report Received.
Если вам предложено ввести имя системного раздела, можно предоставить уникальную строку. Значение в этом поле не влияет на ваш опыт и используется для внутренней телеметрии.
Для типа конечной точки (Endpoint type) выберите WebHook.
Для конечной точки выберите " Выбрать конечную точку" и введите URL-адрес веб-приложения.

В этом случае используйте URL-адрес из просмотрщика Event Grid, который мы настроили ранее в кратком руководстве. URL-адрес примера имеет следующий формат: https://{{site-name}}.azurewebsites.net/api/updates
Выберите Подтвердить выбор.

Просмотр событий SMS

Чтобы создать и получать sms-события, выполните следующие действия.

Активация событий SMS

Чтобы просмотреть триггеры событий, необходимо создать некоторые события.

SMS Received события создаются, когда номер телефона служб коммуникации получает текстовое сообщение. Чтобы активировать событие, отправьте сообщение с телефона на номер телефона, подключенный к ресурсу Служб коммуникации.
SMS Delivery Report Received события создаются при отправке SMS пользователю с помощью номера телефона служб коммуникации. Чтобы активировать событие, необходимо включить Delivery Report параметр отправленного SMS. Попробуйте отправить сообщение на телефон с Delivery Report включенной функцией. Выполнение этого действия будет стоить несколько центов США или меньше на вашем счете Azure.

Полный список событий, поддерживаемых службами коммуникации.

Получение событий SMS

После создания события вы увидите, что SMS Received и SMS Delivery Report Received события отправляются в конечную точку. Эти события отображаются в средстве просмотра сетки событий, который мы настроили в начале этого краткого руководства. Чтобы просмотреть всю полезную нагрузку, выберите значок глаза рядом с событием. События должны выглядеть похоже на приведенные ниже данные:

Снимок экрана: средство просмотра сетки событий Azure, в котором показана схема сетки событий для полученного события SMS.

Снимок экрана: средство просмотра сетки событий Azure, в котором показана схема сетки событий для события отчета о доставке SMS.

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

Очистите ресурсы

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

Дальнейшие шаги

Отправка SMS