Snabbstart: Hantera e-posthändelser

Kom igång med Azure Communication Services med hjälp av Azure Event Grid för att hantera e-posthändelser för Kommunikationstjänster. När du har prenumererat på e-posthändelser som leveransrapporter och engagemangsrapporter genererar och tar du emot dessa händelser. Slutförande av den här snabbstarten medför en liten kostnad på några USD-cent eller mindre på ditt Azure-konto.

Förutsättningar

• Ett Azure-konto med en aktiv prenumeration. Skapa ett konto utan kostnad.
• En Communication Services-resurs. Detaljerad information finns i Skapa en Azure Communication Services-resurs.
• En e-postresurs med en etablerad domän. Skapa en e-postresurs.

Om Event Grid

Event Grid är en molnbaserad händelsetjänst. I den här artikeln får du lära dig hur du prenumererar på kommunikationstjänsthändelser och utlöser en händelse för att visa resultatet. Normalt kan du skicka händelser till en slutpunkt som bearbetar informationen om händelsen och utför åtgärder. I den här artikeln skickar vi händelserna till en webbapp som samlar in och visar meddelandena.

Konfigurera miljön

Utför stegen i följande avsnitt för att konfigurera miljön som vi ska använda för att generera och ta emot händelser.

Registrera en Event Grid-resursprovider

Om du inte tidigare har använt Event Grid i din Azure-prenumeration kan du behöva registrera din Event Grid-resursprovider. Följ dessa steg för att registrera providern:

1. Gå till Azure-portalen.
2. Välj Prenumerationer på den vänstra menyn.
3. Välj den prenumeration som du använder för Event Grid.
4. På menyn till vänster går du till Inställningar och väljer Resursprovidrar.
5. Hitta Microsoft.EventGrid.
6. Om resursprovidern inte är registrerad väljer du Registrera.

Det kan ta en stund innan registreringen är klar. Välj Uppdatera för att uppdatera statusen. När Registrerad visas under Status är du redo att fortsätta.

Distribuera Loggboken för Event Grid

I den här snabbstarten använder vi ett Event Grid-visningsprogram för att visa händelser nästan i realtid. Visningsprogrammet ger användaren en upplevelse av en realtidsfeed. Dessutom bör nyttolasten för varje händelse vara tillgänglig för inspektion.

Om du vill konfigurera visningsprogrammet följer du stegen i Azure Event Grid Viewer.

Prenumerera på e-posthändelser med hjälp av webbkrokar

Du kan prenumerera på specifika händelser för att ge Event Grid information om var du kan skicka de händelser som du vill spåra.

1. I portalen går du till den Communication Services-resurs som du skapade.

2. I resursen Communication Services går du till den vänstra menyn på sidan Kommunikationstjänster och väljer Händelser.

3. Välj Lägg till händelseprenumeration.

   

4. På sidan Skapa händelseprenumeration anger du ett namn för händelseprenumerationen.

5. Under Händelsetyper väljer du de händelser som du vill prenumerera på. För E-post kan du välja Email Delivery Report Received och Email Engagement Tracking Report Received.

6. Om du uppmanas att ange ett systemämnesnamn kan du ange en unik sträng. Det här fältet påverkar inte din upplevelse och används för interna telemetriändamål.

   

7. För Slutpunktstyp väljer du Web Hook.

   

8. För Slutpunkt väljer du Välj en slutpunkt och anger sedan URL:en för webbappen.

   I det här fallet använder vi URL:en från Loggboken som vi konfigurerade tidigare i snabbstarten. URL:en för exemplet har följande format: https://{{site-name}}.azurewebsites.net/api/updates

9. Välj Bekräfta val.

   

Visa e-posthändelser

Utför stegen i följande avsnitt för att generera och ta emot e-posthändelser.

Utlösa e-posthändelser

Om du vill visa händelseutlösare måste vi generera vissa händelser. Om du vill utlösa en händelse skickar du ett e-postmeddelande med hjälp av den e-postdomänresurs som är kopplad till Communication Services-resursen.

• Email Delivery Report Received händelser genereras när e-poststatusen är i terminaltillstånd, till exempel Levererad, Misslyckad, FiltreradSpam, Karantän.

• Email Engagement Tracking Report Received händelser genereras när e-postmeddelandet som skickas antingen öppnas eller en länk i e-postmeddelandet klickas. För att utlösa en händelse måste du aktivera User Interaction Tracking alternativet på resursen e-postdomän

Ta en titt på den fullständiga listan över händelser som Communication Services stöder.

Ta emot e-posthändelser

När du har genererat en händelse ser du att Email Delivery Report Received och Email Engagement Tracking Report Received händelser skickas till slutpunkten. Dessa händelser visas i Loggboken som vi konfigurerade i början av den här snabbstarten. Välj ögonikonen bredvid händelsen för att se hela nyttolasten. Händelser bör se ut ungefär som följande data:

• EngagementContext refererar till länken som klickades när engagementType är Click.
• UserAgent refererar till användaragenten som händelsen för e-postengagemang kommer från. T.ex. Om användaren interagerade på Edge med en Win10-dator: Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, som Gecko) Chrome/42.0.2311.135 Safari/537.36 Edge/12.246
• EngagementType refererar till typen av engagemang, möjliga värden är "Visa" eller "Klicka".

Läs mer om händelsescheman och andra händelsebegrepp.

Rensa resurser

Om du vill rensa och ta bort en Communication Services-prenumeration kan du ta bort resursen eller resursgruppen. Om du tar bort resursgruppen tas även alla andra resurser som är associerade med den bort. Läs mer om att rensa resurser.

Nästa steg

I den här snabbstarten har du lärt dig hur du använder e-posthändelser. Du kan ta emot e-posthändelser genom att skapa en Event Grid-prenumeration.

Skicka e-postmeddelande

Schemainformation och exempelhändelser finns i Azure Communication Services – e-posthändelser.

Du kanske också vill se följande artiklar:

• Lär dig mer om begrepp för händelsehantering
• Läs mer om Event Grid