Megosztás a következőn keresztül:

Rövid útmutató: E-mail események kezelése

  • Cikk

Ismerkedés az Azure Communication Services szolgáltatással az Azure Event Grid használatával a Kommunikációs szolgáltatások e-mail eseményeinek kezeléséhez. Miután feliratkozott az e-mail eseményekre, például a kézbesítési jelentésekre és az előjegyzési jelentésekre, létrehozza és megkapja ezeket az eseményeket. A rövid útmutató elvégzése néhány cent (USD) vagy még kevesebb költséggel jár az Azure-fiókját illetően.

Előfeltételek

Bevezetés az Event Grid használatába

Az Event Grid egy felhőalapú eseményszolgáltatási szolgáltatás. Ebben a cikkben megtudhatja, hogyan iratkozhat fel a kommunikációs szolgáltatási eseményekre, és hogyan aktiválhat eseményt az eredmény megtekintéséhez. Általában olyan végpontoknak szoktunk eseményeket küldeni, amelyek eseményadatokat dolgoznak fel és műveleteket hajtanak végre. Ebben a cikkben elküldjük az eseményeket egy webalkalmazásnak, amely összegyűjti és megjeleníti az üzeneteket.

A környezet beállítása

Az események létrehozásához és fogadásához használni kívánt környezet beállításához kövesse az alábbi szakaszok lépéseit.

Event Grid-erőforrás-szolgáltató regisztrálása

Ha korábban nem használta az Event Gridet az Azure-előfizetésében, előfordulhat, hogy regisztrálnia kell az Event Grid-erőforrás-szolgáltatót. A szolgáltató regisztrálásához kövesse az alábbi lépéseket:

  1. Nyissa meg az Azure Portalt.
  2. A bal oldali menüben válassza az Előfizetések lehetőséget.
  3. Válassza ki az Event Gridhez használt előfizetést.
  4. A bal oldali menü Beállítások területén válassza az Erőforrás-szolgáltatók lehetőséget.
  5. Keresse ki a Microsoft.EventGrid elemet.
  6. Ha az erőforrás-szolgáltató nincs regisztrálva, válassza a Regisztráció lehetőséget.

Eltarthat egy ideig, amíg a regisztráció befejeződik. Válassza a Frissítés lehetőséget az állapotfrissítéshez. Amikor a Regisztráció megjelenik az Állapot területen, készen áll a folytatásra.

Az Event Grid-megjelenítő üzembe helyezése

Ebben a rövid útmutatóban egy Event Grid-megjelenítőt használunk az események közel valós idejű megtekintéséhez. A megtekintő valós idejű hírcsatornát biztosít a felhasználónak. Emellett az egyes események hasznos adatainak elérhetőnek kell lenniük az ellenőrzéshez.

A megtekintő beállításához kövesse az Azure Event Grid Viewer lépéseit.

Feliratkozás e-mail eseményekre webes horgok használatával

Előfizethet bizonyos eseményekre, hogy az Event Grid tájékoztatást nyújtson arról, hogy hová küldje a követni kívánt eseményeket.

  1. A portálon nyissa meg a létrehozott Communication Services-erőforrást.

  2. A Communication Services erőforrás bal oldali menüjében válassza az Események lehetőséget.

  3. Válassza az Esemény-előfizetés hozzáadása lehetőséget.

    Képernyőkép egy Azure Communication Services-erőforrás Események lapjáról. Az Esemény-előfizetés gomb ki van hívva.

  4. Az Esemény-előfizetés létrehozása lapon adja meg az esemény-előfizetés nevét.

  5. Az Eseménytípusok területen válassza ki azokat az eseményeket, amelyekre elő szeretne fizetni. Az e-mail-címhez kiválaszthatja és Email Engagement Tracking Report Receivedkiválaszthatja Email Delivery Report Received a .

  6. Ha a rendszer témakörnevének megadását kéri, adjon meg egy egyedi sztringet. Ez a mező nincs hatással a felhasználói élményre, és belső telemetriai célokra használható.

    Képernyőkép az Esemény-előfizetés létrehozása párbeszédpanelről. Az Eseménytípusok területen a beérkezett e-mail-kézbesítési jelentés és a beérkezett e-mail-előjegyzés-követő jelentés van kiválasztva.

  7. Végponttípus esetén válassza a Web Hook lehetőséget.

    Az Esemény-előfizetés létrehozása párbeszédpanel egy részletét bemutató képernyőkép. A Végponttípus listában a Web Hook van kiválasztva.

  8. Végpont esetén válassza a Végpont kiválasztása lehetőséget, majd adja meg a webalkalmazás URL-címét.

    Ebben az esetben a rövid útmutatóban korábban beállított Event Grid-megjelenítő URL-címét fogjuk használni. A minta URL-címe a következő formátummal rendelkezik: https://{{site-name}}.azurewebsites.net/api/updates

  9. Válassza a Kiválasztás megerősítése lehetőséget.

    Képernyőkép a Webhook kiválasztása párbeszédpanelről. Az Előfizetői végpont mező egy URL-címet tartalmaz, és megjelenik a Kijelölés megerősítése gomb.

E-mail-események megtekintése

Az e-mail-események létrehozásához és fogadásához hajtsa végre a következő szakaszok lépéseit.

E-mail események aktiválása

Az eseményindítók megtekintéséhez létre kell hoznunk néhány eseményt. Esemény aktiválásához küldjön e-mailt a Communication Services-erőforráshoz csatolt E-mail tartomány erőforrás használatával.

  • Email Delivery Report Received események akkor jönnek létre, ha az e-mail állapota terminálállapotban van, például Kézbesítve, Sikertelen, FilteredSpam, Karanténba helyezve.

  • Email Engagement Tracking Report Received esemény akkor jön létre, ha az elküldött e-mail meg van nyitva, vagy az e-mailben található hivatkozásra kattint. Esemény aktiválásához be kell kapcsolnia az User Interaction Tracking e-mail tartomány erőforrásának beállítását

Tekintse meg a Communication Services által támogatott események teljes listáját.

E-mail események fogadása

Az esemény létrehozása után láthatja, hogy a Email Delivery Report Received Email Engagement Tracking Report Received rendszer elküldi az eseményeket a végpontnak. Ezek az események megjelennek a rövid útmutató elején beállított Event Grid-megjelenítőben . A teljes hasznos adat megtekintéséhez válassza az esemény melletti szem ikont. Az eseményeknek a következő adatokhoz hasonlóan kell kinéznie:

Képernyőkép az Azure Event Grid-megjelenítőről, amely egy fogadott e-mail-kézbesítési jelentés Event Grid-sémáját jeleníti meg.

Képernyőkép az Azure Event Grid-megjelenítőről, amely egy E-MAIL-előjegyzés-követési jelentés eseményeinek Event Grid-sémáját jeleníti meg.

  • EngagementContext az engagementType használatakor kattintott hivatkozásra hivatkozik Click.
  • UserAgent arra a felhasználói ügynökre hivatkozik, amelyből ez az e-mail-előjegyzési esemény származik. Például Ha a felhasználó Win10-géppel kommunikált az Edge-en: Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, például Gecko) Chrome/42.0.2311.135 Safari/537.36 Edge/12.246
  • EngagementType az előjegyzés típusára hivatkozik, a lehetséges értékek a "Nézet" vagy a "Kattintás".

További információ az eseménysémákról és az eseményekkel kapcsolatos egyéb fogalmakról.

Az erőforrások eltávolítása

Ha törölni és eltávolítani szeretne egy Communication Services-előfizetést, törölheti az erőforrást vagy az erőforráscsoportot. Az erőforráscsoport törlése a hozzá társított egyéb erőforrásokat is törli. További információ az erőforrások tisztításáról.

Következő lépések

Ebben a rövid útmutatóban megtanulta, hogyan használhatja fel az e-mailes eseményeket. Eseményrács-előfizetés létrehozásával e-mailes eseményeket fogadhat.

E-mail küldése

Sémainformációkat és példaeseményeket az Azure Communication Services – E-mail események című témakörben talál.

A következő cikkeket is érdemes megtekintenie: