Dela via

Hantera SMS-händelser

Kom igång med Azure Communication Services med hjälp av Azure Event Grid för att hantera SMS-händelser för Communication Services. När du har prenumererat på SMS-händelser som inkommande meddelanden och leveransrapporter genererar och tar du emot dessa händelser.

Att slutföra den här artikeln medför en liten kostnad på några USD cent eller mindre i ditt Azure-konto.

Viktigt!

SMS- och PSTN-funktioner beror på vilket telefonnummer du använder och det land/den region som du arbetar inom 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. Den här artikeln beskriver hur du skickar händelserna till en webbapp som samlar in och visar meddelandena.

Konfigurera miljön

Om du vill konfigurera miljön för att generera och ta emot händelser slutför du följande avsnitt.

Registrera en Event Grid-resursprovider

Om du inte har Event Grid i din Azure-prenumeration måste du registrera event grid-resursprovidern. 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 Visaren för Event Grid

I det här exemplet använder du 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 innehållet för varje händelse vara tillgängligt för granskning.

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

Prenumerera på SMS-hä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.

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

  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 SMS-leveransrapporter.

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

    Skärmbild som visar en detalj i dialogrutan Skapa händelseprenumeration. I listan Slutpunktstyp är Web Hook valt.

  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 du URL:en från Event Grid-visaren 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 webbhook. Rutan Prenumerantens slutpunkt innehåller URL och knappen Bekräfta markering är synlig.

Visa SMS-händelser

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

Utlösa SMS-händelser

Om du vill visa händelseutlösare måste vi generera vissa händelser.

  • SMS Received händelser genereras när kommunikationstjänsternas telefonnummer tar emot ett sms. Om du vill utlösa en händelse skickar du ett meddelande från telefonen till det telefonnummer 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 kommunikationstjänsttelefonnummer. 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 USD cent eller mindre i ditt Azure-konto.

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

Ta emot SMS-händelser

När du har genererat en händelse kan du se att SMS Received och SMS Delivery Report Received händelser skickas till slutpunkten. Dessa händelser visas i Event Grid-visaren som vi konfigurerade i början av den här snabbstarten. För att se hela innehållet, välj ögonikonen bredvid händelsen. Händelser bör se ut ungefär som följande data:

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

Skärmbild av Azure Event Grid-visningsprogrammet 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. Att ta bort resursgruppen innebär också att alla andra resurser som är kopplade till den tas bort. Läs mer om att rensa resurser.

Nästa steg

Skicka SMS

  • Last updated on