Rychlý start: Zpracování e-mailových událostí

Začínáme se službou Azure Communication Services pomocí azure Event Gridu pro zpracování e-mailových událostí komunikačních služeb Po přihlášení k odběru e-mailových událostí, jako jsou zprávy o doručení a sestavy zapojení, vygenerujete a obdržíte tyto události. Při dokončení tohoto rychlého zprovoznění vzniknou ve vašem účtu Azure náklady ve výši několika centů USD (nebo menší).

Požadavky

• Účet Azure s aktivním předplatným. Vytvoření účtu zdarma
• Prostředek Komunikační služby. Podrobné informace najdete v tématu Vytvoření prostředku Azure Communication Services.
• Prostředek e-mailu se zřízenou doménou. Vytvoření e-mailového prostředku

Informace o službě Event Grid

Event Grid je cloudová služba pro vytváření událostí. V tomto článku se dozvíte, jak se přihlásit k odběru událostí komunikační služby a aktivovat událost, aby se zobrazil výsledek. Obvykle odesíláte události do koncového bodu, který data události zpracuje a provede akce. V tomto článku pošleme události do webové aplikace, která shromažďuje a zobrazuje zprávy.

Nastavení prostředí

Pokud chcete nastavit prostředí, které použijeme k vygenerování a přijímání událostí, proveďte kroky v následujících částech.

Registrace poskytovatele prostředků Event Gridu

Pokud jste ve svém předplatném Azure službu Event Grid ještě nepoužívali, možná budete muset zaregistrovat svého poskytovatele prostředků Event Gridu. Pokud chcete poskytovatele zaregistrovat, postupujte takto:

1. Přejděte na Azure Portal.
2. V nabídce vlevo vyberte Předplatná.
3. Vyberte předplatné, které používáte pro Event Grid.
4. V nabídce vlevo v části Nastavení vyberte Poskytovatelé prostředků.
5. Vyhledejte Microsoft.EventGrid.
6. Pokud váš poskytovatel prostředků není zaregistrovaný, vyberte Zaregistrovat.

Dokončení registrace může chvíli trvat. Stav můžete aktualizovat kliknutím na Aktualizovat. Když se v části Stav zobrazí Registrace, můžete pokračovat.

Nasazení prohlížeče Event Gridu

V tomto rychlém startu použijeme prohlížeč Event Gridu k zobrazení událostí téměř v reálném čase. Prohlížeč poskytuje uživateli zkušenosti s informačním kanálem v reálném čase. Datová část každé události by měla být také k dispozici pro kontrolu.

Pokud chcete nastavit prohlížeč, postupujte podle kroků v prohlížeči Azure Event Grid.

Přihlášení k odběru e-mailových událostí pomocí webhooků

Můžete se přihlásit k odběru konkrétních událostí a poskytnout službě Event Grid informace o tom, kam odesílat události, které chcete sledovat.

1. Na portálu přejděte k prostředku komunikační služby, který jste vytvořili.

2. V prostředku Komunikační služby v nabídce vlevo na stránce Komunikační služby vyberte Události.

3. Vyberte Přidat odběr události.

   

4. Na stránce Vytvořit odběr události zadejte název odběru události.

5. V části Typy událostí vyberte události, které chcete přihlásit k odběru. Pro e-mail můžete zvolit Email Delivery Report Received a Email Engagement Tracking Report Received.

6. Pokud se zobrazí výzva k zadání názvu tématu systému, můžete zadat jedinečný řetězec. Toto pole nemá žádný vliv na vaše prostředí a používá se pro účely interní telemetrie.

   

7. Jako typ koncového bodu vyberte WebHook.

   

8. V části Koncový bod vyberte Vybrat koncový bod a zadejte adresu URL vaší webové aplikace.

   V tomto případě použijeme adresu URL z prohlížeče Event Grid, který jsme nastavili dříve v rychlém startu. Adresa URL ukázky má tento formát: https://{{site-name}}.azurewebsites.net/api/updates

9. Zvolte Potvrdit výběr.

   

Zobrazení e-mailových událostí

Pokud chcete generovat a přijímat e-mailové události, postupujte podle kroků v následujících částech.

Aktivace e-mailových událostí

Abychom mohli zobrazit triggery událostí, musíme vygenerovat některé události. Pokud chcete aktivovat událost, odešlete e-mail pomocí prostředku e-mailové domény připojeného k prostředku Komunikační služby.

• Email Delivery Report Received Události se generují, když je stav e-mailu v terminálovém stavu, například Doručeno, Selhání, FiltrovanýSpam, V karanténě.

• Email Engagement Tracking Report Received události se vygenerují, když se e-mail odešle, nebo se klikne na odkaz v e-mailu. Pokud chcete aktivovat událost, musíte zapnout User Interaction Tracking možnost u prostředku e-mailové domény.

Podívejte se na úplný seznam událostí , které služba Communication Services podporuje.

Příjem e-mailových událostí

Po vygenerování události si všimnete, že Email Delivery Report Received se Email Engagement Tracking Report Received události odesílají do koncového bodu. Tyto události se zobrazují v prohlížeči Event Grid, který jsme nastavili na začátku tohoto rychlého startu. Výběrem ikony oka vedle události zobrazíte celou datovou část. Události by měly vypadat podobně jako následující data:

• EngagementContext odkazuje na odkaz, na který kliknete, když je Clicktyp engagementType .
• UserAgent odkazuje na user-agenta, ze kterého tato událost zapojení e-mailu pochází. Např. Pokud uživatel pracoval na Edgi pomocí počítače Win10: Mozilla/5.0 (systém Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/42.0.2311.135 Safari/537.36 Edge/12.246
• EngagementType odkazuje na typ rezervace, možné hodnoty jsou Zobrazení nebo Kliknutí.

Přečtěte si další informace o schématech událostí a dalších konceptech událostí.

Vyčištění prostředků

Pokud chcete vyčistit a odebrat předplatné služby Communication Services, můžete odstranit prostředek nebo skupinu prostředků. Odstraněním skupiny prostředků se odstraní také všechny ostatní prostředky, které jsou k ní přidružené. Přečtěte si další informace o čištění prostředků.

Další kroky

V tomto rychlém startu jste zjistili, jak využívat e-mailové události. Události e-mailu můžete přijímat vytvořením odběru Event Gridu.

Poslat e-mail

Informace o schématu a ukázkové události najdete v tématu Azure Communication Services – e-mailové události.

Můžete se také podívat na následující články:

• Informace o konceptech zpracování událostí
• Další informace o Event Gridu