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

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

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

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