Share via

Quickstart: Email-gebeurtenissen afhandelen

  • Artikel

Ga aan de slag met Azure Communication Services door Azure Event Grid te gebruiken om communication services Email-gebeurtenissen af te handelen. Nadat u zich hebt geabonneerd op Email gebeurtenissen, zoals bezorgingsrapporten en betrokkenheidsrapporten, genereert en ontvangt u deze gebeurtenissen. Voor het voltooien van deze quickstart worden kosten van een paar dollarcent of minder in rekening gebracht bij uw Azure-account.

Vereisten

Over Event Grid

Event Grid is een gebeurtenisservice in de cloud. In dit artikel leert u hoe u zich kunt abonneren op communicatieservice-gebeurtenissen en een gebeurtenis activeert om het resultaat weer te geven. Normaal gesproken verzendt u gebeurtenissen naar een eindpunt dat de gebeurtenisgegevens verwerkt en vervolgens in actie komt. In dit artikel sturen we de gebeurtenissen naar een web-app die de berichten verzamelt en weergeeft.

De omgeving instellen

Voer de stappen in de volgende secties uit om de omgeving in te stellen die we gebruiken om gebeurtenissen te genereren en te ontvangen.

Een Event Grid-resourceprovider registreren

Als u Event Grid nog niet eerder hebt gebruikt in uw Azure-abonnement, moet u mogelijk uw Event Grid-resourceprovider registreren. Voer de volgende stappen uit om de provider te registreren:

  1. Ga naar Azure Portal.
  2. Selecteer Abonnementen in het linkermenu.
  3. Selecteer het abonnement dat u gebruikt voor Event Grid.
  4. Selecteer onder Instellingen in het menu links de optie Resourceproviders.
  5. Zoek Microsoft.EventGrid.
  6. Als uw resourceprovider niet is geregistreerd, selecteert u Registreren.

Het kan even duren voordat de registratie is voltooid. Selecteer Vernieuwen om de status bij te werken. Wanneer Geregistreerd wordt weergegeven onder Status, bent u klaar om door te gaan.

De Event Grid-viewer implementeren

Voor deze quickstart gebruiken we een Event Grid-viewer om gebeurtenissen bijna in realtime weer te geven. De viewer biedt de gebruiker de ervaring van een realtime feed. Ook moet de nettolading van elke gebeurtenis beschikbaar zijn voor inspectie.

Volg de stappen in Azure Event Grid Viewer om de viewer in te stellen.

Abonneren op Email gebeurtenissen met behulp van webhook

U kunt zich abonneren op specifieke gebeurtenissen om Event Grid informatie te geven over de locatie van de gebeurtenissen die u wilt bijhouden.

  1. Ga in de portal naar de Communication Services-resource die u hebt gemaakt.

  2. Selecteer in de Communication Services-resource in het linkermenu van de pagina Communication Servicesde optie Gebeurtenissen.

  3. Selecteer Gebeurtenisabonnement toevoegen.

    Schermopname van de pagina Gebeurtenissen van een Azure Communication Services resource. De knop Gebeurtenisabonnement wordt uitgelicht.

  4. Voer op de pagina Gebeurtenisabonnement maken een naam in voor het gebeurtenisabonnement.

  5. Selecteer onder Gebeurtenistypen de gebeurtenissen waarop u zich wilt abonneren. Voor Email kunt u en Email Engagement Tracking Report ReceivedkiezenEmail Delivery Report Received.

  6. Als u wordt gevraagd om de naam van een Systeemonderwerp op te geven, kunt u een unieke tekenreeks opgeven. Dit veld heeft geen invloed op uw ervaring en wordt gebruikt voor interne telemetrie.

    Schermopname van het dialoogvenster Gebeurtenisabonnement maken. Onder Gebeurtenistypen zijn Email Bezorgingsrapport ontvangen en Email Ontvangen betrokkenheidsrapport geselecteerd.

  7. Bij Eindpunttype selecteert u Webhook.

    Schermopname met een detail van het dialoogvenster Gebeurtenisabonnement maken. In de lijst Eindpunttype is Webhook geselecteerd.

  8. Selecteer bij Eindpuntde optie Een eindpunt selecteren en voer vervolgens de URL van uw web-app in.

    In dit geval gebruiken we de URL van de Event Grid-viewer die we eerder in de quickstart hebben ingesteld. De URL voor het voorbeeld heeft deze indeling: https://{{site-name}}.azurewebsites.net/api/updates

  9. Selecteer Confirm Selection (Selectie bevestigen).

    Schermopname van het dialoogvenster Webhook selecteren. Het vak Abonnee-eindpunt bevat een URL en de knop Selectie bevestigen is zichtbaar.

Email-gebeurtenissen weergeven

Voer de stappen in de volgende secties uit om Email gebeurtenissen te genereren en te ontvangen.

Gebeurtenissen Email activeren

We moeten enkele gebeurtenissen genereren om gebeurtenistriggers weer te geven. Als u een gebeurtenis wilt activeren, verzendt u een e-mail met behulp van de Email domeinresource die is gekoppeld aan de Communication Services-resource.

  • Email Delivery Report Receivedgebeurtenissen worden gegenereerd wanneer de status van de Email zich in de terminale status bevindt, bijvoorbeeld Geleverd, Mislukt, GefilterdeSpam, In quarantaine geplaatst.
  • Email Engagement Tracking Report Received gebeurtenissen worden gegenereerd wanneer de verzonden e-mail wordt geopend of op een koppeling in de e-mail wordt geklikt. Als u een gebeurtenis wilt activeren, moet u de User Interaction Tracking optie inschakelen op de Email domeinresource

Bekijk de volledige lijst met gebeurtenissen die door Communication Services worden ondersteund.

Gebeurtenissen Email ontvangen

Nadat u een gebeurtenis hebt gegenereerd, ziet u dat Email Delivery Report Received en-gebeurtenissen Email Engagement Tracking Report Received naar uw eindpunt worden verzonden. Deze gebeurtenissen worden weergegeven in de Event Grid-viewer die we aan het begin van deze quickstart hebben ingesteld. Selecteer het oogpictogram naast de gebeurtenis om de hele nettolading te zien. Gebeurtenissen moeten er ongeveer uitzien als de volgende gegevens:

Schermopname van de Azure Event Grid viewer met het Event Grid-schema voor een ontvangen e-mailbezorgingsrapport.

Schermopname van de Azure Event Grid-viewer met het Event Grid-schema voor een rapport voor het bijhouden van e-mailafspraken.

  • EngagementContext verwijst naar de koppeling waarop is geklikt wanneer het engagementType is Click.
  • UserAgent verwijst naar de User-Agent waaruit deze e-mailbetrokkenheidsgebeurtenis afkomstig is. Bijvoorbeeld Als de gebruiker interactie heeft gehad in Edge met behulp van een Win10-computer: Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, zoals Gecko) Chrome/42.0.2311.135 Safari/537.36 Edge/12.246
  • EngagementType verwijst naar het type afspraak, mogelijke waarden zijn 'Weergeven' of 'Klikken'.

Meer informatie over de gebeurtenisschema's en andere gebeurtenisconcepten.

Resources opschonen

Als u een Communication Services-abonnement wilt opschonen en verwijderen, kunt u de resource of resourcegroep verwijderen. Als u de resourcegroep verwijdert, worden ook alle bijbehorende resources verwijderd. Meer informatie over het opschonen van resources.

Volgende stappen

In deze quickstart hebt u geleerd hoe u Email-gebeurtenissen kunt gebruiken. U kunt Email gebeurtenissen ontvangen door een Event Grid-abonnement te maken.

E-mail verzenden

Zie Azure Communication Services - Email gebeurtenissen voor schema-informatie en voorbeeldgebeurtenissen.

Mogelijk wilt u ook de volgende artikelen bekijken: