Quickstart: Geavanceerde berichten-gebeurtenissen afhandelen

Met Azure Communication Services kunt u nu WhatsApp-berichten verzenden en ontvangen met behulp van de Advanced Messaging SDK. Ga aan de slag met het instellen van Event Grid-gebeurtenissen voor het ontvangen van WhatsApp-berichten voor het verzenden/ontvangen van statusrapporten. Voor het voltooien van deze quickstart worden kosten van een paar dollarcent of minder in rekening gebracht bij uw Azure-account.

Vereisten

• Azure-account met een actief abonnement
• Event Grid-resourceprovider registreren
• Een Azure Communication Services-resource maken

Over Event Grid

Event Grid is een gebeurtenisservice in de cloud. In dit artikel leert u hoe u zich abonneert 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 verzenden we de gebeurtenissen naar een web-app die de berichten verzamelt en weergeeft.

Event Grid Viewer instellen

Event Grid Viewer is een voorbeeldsite waarmee u binnenkomende gebeurtenissen vanuit Event Grid kunt bekijken.

1. Ga naar deze Azure Event Grid Viewer koppelen - Codevoorbeelden | Microsoft Learn. Implementeer het Event Grid Viewer-voorbeeld door te klikken op Implementeren in Azure.

   

2. Nadat u op Implementeren in Azure hebt geklikt, vult u de vereiste velden in. Omdat de sitenaam een DNS-vermelding maakt, moet deze globaal uniek zijn. We raden u aan uw alias op te nemen in de naam voor deze stap. Hoewel voor deze quickstart geen speciale instellingen nodig zijn voor deze stap, zijn hier suggesties voor het invullen van de implementatiedetails:

• Subscription - Selecteer het abonnement dat uw Azure Communication Services-resource bevat. Dit specifieke abonnement is niet vereist, maar het maakt het gemakkelijker om op te schonen nadat u klaar bent met de quickstart.

• Resource Group - Selecteer de resourcegroep die uw Azure Communication Services-resource bevat. Deze specifieke resourcegroep is niet vereist, maar het maakt het gemakkelijker om op te schonen nadat u klaar bent met de quickstart.

• Region - Selecteer de resourcegroep die uw Azure Communication Services-resource bevat. Deze specifieke regio is niet vereist, maar wordt aanbevolen.

• Site Name - Maak een naam die wereldwijd uniek is. Deze sitenaam wordt gebruikt om een domein te maken om verbinding te maken met uw Event Grid Viewer.

• Hosting Plan Name - Maak een naam om uw hostingabonnement te identificeren.

• Sku - De SKU F1 kan worden gebruikt voor ontwikkelings- en testdoeleinden. Als er validatiefouten optreden bij het maken van uw Event Grid Viewer met de tekst dat er geen capaciteit meer is voor het F1-plan, selecteert u een andere regio. Zie App Service-prijzen voor meer informatie over SKU's

  

3. Selecteer vervolgens Controleren en maken.

4. Nadat de implementatie is voltooid, selecteert u de App Service-resource om deze te openen.

   

5. Selecteer op de overzichtspagina van de resource de knop Kopiëren naast de eigenschap Standaarddomein .

   

6. De URL voor de Event Grid Viewer is de sitenaam die u hebt gebruikt om de implementatie te maken met het pad /api/update dat is toegevoegd. Bijvoorbeeld: 'https://{{site-name}}.azurewebsites.net/api/updates'. U hebt deze nodig in de volgende stap en tijdens het maken van de demo-app.

Abonneren op Advanced Messaging-gebeurtenissen

1. Open uw Communication Services-resource in Azure Portal, navigeer naar de optie Gebeurtenissen in het linkerdeelvenster en selecteer +Gebeurtenisabonnement.

   

2. Vul de details in voor het nieuwe gebeurtenisabonnement.

   • Abonnementsnaam.

   • Naam van systeemonderwerp: voer een unieke naam in, tenzij deze naam al vooraf is ingevuld met een onderwerp uit uw abonnement.

   • Gebeurtenistypen: selecteer de twee geavanceerde berichtengebeurtenissen in de lijst.

     

   • Optioneel: selecteer de gebeurtenis AdvancedMessageAnalysisCompleted, momenteel in openbare preview, om berichtenanalysegebeurtenissen te ontvangen. Instructies over het inschakelen van een berichtanalyse vindt u op Berichtanalyse inschakelen met Azure OpenAI

     Belangrijk

     Deze functie van Azure Communication Services is momenteel beschikbaar als preview-versie.

     Preview-API's en SDK's worden aangeboden zonder een service level agreement. U wordt aangeraden deze niet te gebruiken voor productieworkloads. Sommige functies worden mogelijk niet ondersteund of hebben mogelijk beperkte mogelijkheden.

     Raadpleeg aanvullende gebruiksvoorwaarden voor Microsoft Azure Previews voor meer informatie.

     

   • Voor eindpunttype selecteert u 'Webhook' en voert u de URL in voor de Event Grid Viewer die we hebben gemaakt in de stap Event Grid Viewer instellen, waarbij het pad /api/updates is toegevoegd. Voorbeeld: https://{{site-name}}.azurewebsites.net/api/updates.

     

   • Selecteer Maken.

3. Ga terug naar de optie Gebeurtenissen in het linkerdeelvenster van uw Azure Communication Services-resource. Let op het nieuwe gebeurtenisabonnement met Advanced Messaging-gebeurtenissen.

   

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

Ga naar het volgende artikel voor meer informatie over het gebruik van Advanced Messaging SDK voor WhatsApp Messaging.

Aan de slag met de SDK voor geavanceerde communicatieberichten.