Delen via

Quickstart: Sms- en bezorgingsrapport-gebeurtenissen verwerken

  • Artikel

Aan de slag met Azure Communication Services met Azure Event Grid om SMS-gebeurtenissen van Communication Services te verwerken. Nadat u zich hebt geabonneerd op sms-gebeurtenissen zoals inkomende berichten en bezorgingsrapporten, 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.

Belangrijk

Sms- en PSTN-mogelijkheden zijn afhankelijk van het telefoonnummer dat u gebruikt en het land/de regio waarin u werkt, zoals bepaald door uw Azure-factuuradres. Ga naar de documentatie over geschiktheid voor abonnementen voor meer informatie.

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 sms-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 sms kunt u en SMS Delivery Report ReceivedkiezenSMS 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 SMS ontvangen en Sms-bezorgingsrapport ontvangen 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.

Sms-gebeurtenissen weergeven

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

Sms-gebeurtenissen activeren

We moeten enkele gebeurtenissen genereren om gebeurtenistriggers weer te geven.

  • SMS Received-gebeurtenissen worden gegenereerd wanneer het Communication Services-telefoonnummer een sms-bericht ontvangt. Als u een gebeurtenis wilt activeren, verzendt u een bericht vanaf uw telefoon naar het telefoonnummer dat is gekoppeld aan uw Communication Services-resource.
  • SMS Delivery Report Received gebeurtenissen worden gegenereerd wanneer u een sms naar een gebruiker verzendt met behulp van een Communication Services-telefoonnummer. Als u een gebeurtenis wilt activeren, moet u de optie van de Delivery Reportsms die u verzendt inschakelen. Probeer een bericht naar uw telefoon te verzenden met Delivery Report ingeschakeld. Voor het voltooien van deze actie worden kosten van een paar dollarcent of minder in rekening gebracht bij uw Azure-account.

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

Sms-gebeurtenissen ontvangen

Nadat u een gebeurtenis hebt gegenereerd, ziet u dat SMS Received en-gebeurtenissen SMS Delivery 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 sms-gebeurtenis.

Schermopname van de Azure Event Grid viewer met het Event Grid-schema voor een rapport voor sms-bezorging.

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 leert u hoe u SMS-gebeurtenis gebruikt. U kunt SMS-berichten ontvangen door een Event Grid-abonnement te maken.

SMS verzenden

U kunt ook het volgende doen: