Краткое руководство. Обработка событий SMS и отчетов о доставке

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

Важно!

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

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

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

Сведения о службе "Сетка событий Azure"

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

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

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

Регистрация поставщика ресурсов Сетки событий

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

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

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

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

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

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

Подписка на события SMS с помощью веб-перехватчиков

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

1. На портале перейдите к созданному ресурсу Служб коммуникации.

2. В ресурсе Служб коммуникации в меню слева на странице Службы коммуникации выберите События.

3. Выберите Добавить подписку на события.

   

4. На странице Создание подписки на события введите имя подписки на события.

5. В разделе Типы событий выберите события, на которые вы хотите подписаться. Для SMS можно выбрать SMS Received и SMS Delivery Report Received.

6. Если вам предложено ввести имя системного раздела, можно предоставить уникальную строку. Значение в этом поле не влияет на вашу работу и используется для внутренней телеметрии.

   

7. В поле Тип конечной точки выберите Веб-перехватчик.

   

8. В поле Конечная точка выберите Выбрать конечную точку и введите URL-адрес веб-приложения.

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

9. Выберите Подтвердить выбор.

   

Просмотр событий 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. Сообщения SMS можно получить, создав подписку на Сетку событий.

Краткое руководство по отправке SMS-сообщений

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

• Обработка событий в Службах коммуникации Azure
• Что такое служба "Сетка событий Azure"?