Краткое руководство. Обработка событий электронной почты

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

Необходимые компоненты

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

   

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

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

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

   

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

   

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

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

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

   

Просмотр событий электронной почты

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

Активация событий электронной почты

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

• Email Delivery Report Received события создаются, когда состояние электронной почты находится в состоянии терминала, например "Доставлено", "Сбой", "Отфильтровано", "Карантин".

• Email Engagement Tracking Report Received события создаются при открытии сообщения электронной почты или нажатии ссылки в сообщении электронной почты. Чтобы активировать событие, необходимо включить User Interaction Tracking параметр в ресурсе домена электронной почты.

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

Получение событий электронной почты

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

• EngagementContext ссылается на ссылку, щелкнув при использовании ClickengagementType.
• UserAgent относится к агенту пользователя, из которого возникло это событие взаимодействия с электронной почтой. Например, Если пользователь взаимодействовал с Edge с помощью компьютера Win10: Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, например Gecko) Chrome/42.0.2311.135 Safari/537.36 Edge/12.246
• EngagementType относится к типу взаимодействия, возможные значения: View или Click.

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

Очистка ресурсов

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

Следующие шаги

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

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

Вы также можете просмотреть следующие статьи:

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