Rychlý start: Zpracování událostí Email

  • Článek

Začínáme s Azure Communication Services pomocí Azure Event Grid ke zpracování událostí služby Communication Services Email. Po přihlášení k odběru Email událostí, jako jsou zprávy o doručení nebo zprávy o rezervacích, tyto události vygenerujete a obdržíte. Dokončením tohoto rychlého startu se na vašem účtu Azure účtují malé náklady ve výši několika centů nebo méně.

Požadavky

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 jak 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 odešleme události do webové aplikace, která shromažďuje a zobrazuje zprávy.

Nastavení prostředí

Pokud chcete nastavit prostředí, které budeme používat ke generování a přijímání událostí, postupujte podle kroků v následujících částech.

Registrace poskytovatele prostředků Event Gridu

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

  1. Přejděte na Azure Portal.
  2. V nabídce vlevo vyberte Předplatná.
  3. Vyberte odběr, 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. Výběrem možnosti Aktualizovat aktualizujte stav. Jakmile se v části Stav zobrazí Zaregistrováno, můžete pokračovat.

Nasazení prohlížeče Event Gridu

Pro účely tohoto rychlého startu použijeme prohlížeč Event Gridu k zobrazení událostí téměř v reálném čase. Prohlížeč poskytuje uživateli prostředí informačního kanálu v reálném čase. Ke kontrole by také měla být dostupná datová část každé události.

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

Přihlášení k odběru událostí Email pomocí webhooků

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

  1. Na portálu přejděte k prostředku služby Communication Services, 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.

    Snímek obrazovky se stránkou Události prostředku Azure Communication Services Zobrazí se tlačítko Odběr události.

  4. Na stránce Vytvořit odběr událostí 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 Email 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.

    Snímek obrazovky s dialogovým oknem Vytvořit odběr události V části Typy událostí jsou vybrané Email Přijato oznámení o doručení a přijatá sestava sledování Email zapojení.

  7. Jako Typ koncového bodu vyberte Webhook.

    Snímek obrazovky s podrobnostmi dialogového okna Vytvořit odběr události V seznamu Typ koncového bodu je vybraná možnost Webhook.

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

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

  9. Zvolte Potvrdit výběr.

    Snímek obrazovky s dialogovým oknem Vybrat webhook Pole Koncový bod odběratele obsahuje adresu URL a je viditelné tlačítko Potvrdit výběr.

Zobrazení Email událostí

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

Události Email triggerů

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

  • Email Delivery Report Receivedudálosti se generují, když je Email stav v terminálním stavu, tj. Doručeno, Selhání, FiltrovánoSpam, V karanténě.
  • Email Engagement Tracking Report Received události se vygenerují při otevření odeslaného e-mailu nebo kliknutí na odkaz v e-mailu. Pokud chcete aktivovat událost, musíte zapnout User Interaction Tracking možnost u prostředku Email domény.

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

Příjem událostí Email

Po vygenerování události si všimnete, že Email Delivery Report Received události a Email Engagement Tracking Report Received se odešlou do vašeho koncového bodu. Tyto události se zobrazí v prohlížeči Event Gridu , 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:

Snímek obrazovky prohlížeče Azure Event Grid, který zobrazuje schéma Event Gridu pro událost přijetí sestavy doručení E-MAILU

Snímek obrazovky s prohlížečem Azure Event Grid, který zobrazuje schéma Event Gridu pro událost sestavy sledování zapojení e-mailu

  • EngagementContext odkazuje na odkaz, na který se kliklo, když je Clicktyp engagementType .
  • UserAgent odkazuje na User-Agent, ze kterého tato událost zapojení e-mailu pochází. Např. Pokud uživatel komunikoval s Edge pomocí počítače s 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 vytváření událostí.

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

Pokud chcete vyčistit a odebrat předplatné komunikačních služeb, můžete odstranit prostředek nebo skupinu prostředků. Odstraněním skupiny prostředků se odstraní také všechny ostatní prostředky 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 Email události. Události Email můžete přijímat vytvořením odběru Event Gridu.

Odeslání e-mailu

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

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