Snabbstart: Hantera sms- och leveransrapporthändelser

  • Artikel

Kom igång med Azure Communication Services med hjälp av Azure Event Grid för att hantera SMS-händelser i Communication Services. När du har prenumererat på SMS-händelser, till exempel inkommande meddelanden och leveransrapporter, genererar och tar du emot dessa händelser. När du slutför den här snabbstarten medför det en liten kostnad på några usdcent eller mindre på ditt Azure-konto.

Viktigt

SMS- och PSTN-funktionerna beror på vilket telefonnummer du använder och det land/den region som du arbetar i enligt din Azure-faktureringsadress. Mer information finns i dokumentationen om prenumerationsberättigande .

Förutsättningar

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 Event Grid-visningsprogrammet

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

Konfigurera visningsprogrammet genom att följa stegen i Azure Event Grid Viewer.

Prenumerera på SMS-händelser med hjälp av webhooks

Du kan prenumerera på specifika händelser för att ge Event Grid information om vart du vill 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 Communication Services-resursen 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.

    Skärmbild som visar sidan Händelser för en Azure Communication Services resurs. Knappen Händelseprenumeration framhävs.

  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 SMS kan du välja SMS Received och SMS Delivery 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.

    Skärmbild som visar dialogrutan Skapa händelseprenumeration. Under Händelsetyper väljs mottagna SMS och mottagna SMS-leveransrapporter.

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

    Skärmbild som visar en detalj i dialogrutan Skapa händelseprenumeration. Web Hook har valts i listan Slutpunktstyp.

  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.

    Skärmbild som visar dialogrutan Välj webhook. Rutan Prenumerantslutpunkt innehåller en U R L och knappen Bekräfta val visas.

Visa SMS-händelser

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

Utlösa SMS-händelser

För att visa händelseutlösare måste vi generera vissa händelser.

  • SMS Received händelser genereras när kommunikationstjänstens telefonnummer tar emot ett sms. Om du vill utlösa en händelse skickar du ett meddelande från telefonen till telefonnumret som är kopplat till din Communication Services-resurs.
  • SMS Delivery Report Received händelser genereras när du skickar ett SMS till en användare med hjälp av ett communication services-telefonnummer. För att utlösa en händelse måste du aktivera Delivery Report alternativet för det SMS som du skickar. Försök att skicka ett meddelande till telefonen med Delivery Report aktiverat. Att slutföra den här åtgärden medför en liten kostnad på några USDcent eller mindre på ditt Azure-konto.

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

Ta emot SMS-händelser

När du har genererat en händelse ser du att SMS Received och SMS Delivery Report Received händelser skickas till slutpunkten. De här händelserna 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:

Skärmbild av Azure Event Grid visningsprogram som visar Event Grid-schemat för en SMS-mottagen händelse.

Skärmbild av Azure Event Grid visningsprogram som visar Event Grid-schemat för en SMS-leveransrapporthändelse.

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 SMS-händelser. Du kan ta emot SMS genom att skapa en Event Grid-prenumeration.

Skicka SMS

Du kanske också vill: