Händelsehantering i Azure Communication Services

Azure Communication Services integreras med Azure Event Grid för att leverera händelsemeddelanden i realtid på ett tillförlitligt, skalbart och säkert sätt. Syftet med den här artikeln är att hjälpa dig att konfigurera dina program för att lyssna på Communication Services-händelser. Du kanske till exempel vill uppdatera en databas, skapa ett arbetsobjekt och leverera ett push-meddelande när ett SMS tas emot av ett telefonnummer som är kopplat till din Communication Services-resurs.

Azure Event Grid är en fullständigt hanterad händelseroutningstjänst som använder en publiceringsprenumereringsmodell. Event Grid har inbyggt stöd för Azure-tjänster som Azure Functions och Azure Logic Apps. Den kan leverera händelseaviseringar till icke-Azure-tjänster med hjälp av webhooks. En fullständig lista över de händelsehanterare som Event Grid stöder finns i En introduktion till Azure Event Grid.

Diagram showing Azure Event Grid's event model.

Kommentar

Mer information om hur datahemvist relaterar till händelsehantering finns i den konceptuella dokumentationen för Data Residency

Händelsetyper

Event Grid använder händelseprenumerationer för att dirigera händelsemeddelanden till prenumeranter.

Azure Communication Services genererar följande händelsetyper:

Du kan använda Azure-portalen eller Azure CLI för att prenumerera på händelser som genereras av din Communication Services-resurs.

Händelseämnen

Fältet subject för alla Communication Services-händelser identifierar den användare, telefonnummer eller entitet som händelsen riktar sig till. Vanliga prefix används för att tillåta enkel Event Grid-filtrering.

Ämnesprefix Kommunikationstjänstentitet
phonenumber/ PSTN-telefonnummer
user/ Communication Services-användare
thread/ Chatttråd.

I följande exempel visas ett filter för alla SMS-meddelanden och leveransrapporter som skickas till alla telefonnummer med 555 riktnummer som ägs av en Communication Services-resurs:

"filter": {
  "includedEventTypes": [
    "Microsoft.Communication.SMSReceived",
    "Microsoft.Communication.SMSDeliveryReportReceived"
  ],
  "subjectBeginsWith": "phonenumber/1555",
}

Nästa steg