Udostępnij za pośrednictwem

Szybki start: obsługa zdarzeń Email

  • Artykuł

Rozpocznij pracę z Azure Communication Services przy użyciu Azure Event Grid do obsługi zdarzeń Email usług Komunikacyjnych. Po zasubskrybowaniu Email zdarzeń, takich jak raporty dostarczania i raporty zaangażowania, generujesz i odbierasz te zdarzenia. Ukończenie tego przewodnika Szybki start wiąże się z niewielkimi kosztami w wysokości kilku centów lub mniej na koncie platformy Azure.

Wymagania wstępne

Event Grid — informacje

Event Grid to oparta na chmurze usługa zdarzeń. W tym artykule dowiesz się, jak subskrybować zdarzenia usługi komunikacyjnej i wyzwalać zdarzenie w celu wyświetlenia wyniku. Zazwyczaj użytkownik wysyła zdarzenia do punktu końcowego, w którym następuje przetwarzanie danych zdarzenia i są wykonywane akcje. W tym artykule wyślemy zdarzenia do aplikacji internetowej, która zbiera i wyświetla komunikaty.

Konfigurowanie środowiska

Aby skonfigurować środowisko, za pomocą którego będziemy generować i odbierać zdarzenia, wykonaj kroki opisane w poniższych sekcjach.

Rejestrowanie dostawcy zasobów usługi Event Grid

Jeśli usługa Event Grid nie była wcześniej używana w ramach subskrypcji platformy Azure, może być konieczne zarejestrowanie dostawcy zasobów usługi Event Grid. Aby zarejestrować dostawcę, wykonaj następujące kroki:

  1. Przejdź do witryny Azure Portal.
  2. W menu po lewej stronie wybierz pozycję Subskrypcje.
  3. Wybierz subskrypcję używaną dla usługi Event Grid.
  4. W menu po lewej stronie, w obszarze Ustawienia wybierz opcję Dostawcy zasobów.
  5. Znajdź dostawcę Microsoft.EventGrid.
  6. Jeśli dostawca zasobów nie jest zarejestrowany, wybierz pozycję Zarejestruj.

Ukończenie rejestracji może zająć trochę czasu. Wybierz pozycję Odśwież , aby zaktualizować stan. Po wyświetleniu pozycji Zarejestrowane w obszarze Stan możesz kontynuować.

Wdrażanie przeglądarki usługi Event Grid

W tym przewodniku Szybki start użyjemy przeglądarki usługi Event Grid do wyświetlania zdarzeń niemal w czasie rzeczywistym. Przeglądarka udostępnia użytkownikowi środowisko kanału informacyjnego w czasie rzeczywistym. Ponadto ładunek każdego zdarzenia powinien być dostępny do inspekcji.

Aby skonfigurować przeglądarkę, wykonaj kroki opisane w Azure Event Grid Viewer.

Subskrybowanie zdarzeń Email przy użyciu elementów webhook

Możesz subskrybować określone zdarzenia, aby udostępnić usłudze Event Grid informacje o tym, gdzie mają być wysyłane zdarzenia, które chcesz śledzić.

  1. W portalu przejdź do utworzonego zasobu usług komunikacyjnych.

  2. W zasobie Usługi komunikacyjne w menu po lewej stronie usług komunikacyjnych wybierz pozycję Zdarzenia.

  3. Wybierz pozycję Dodaj subskrypcję zdarzeń.

    Zrzut ekranu przedstawiający stronę Zdarzenia zasobu Azure Communication Services. Zostanie wywołany przycisk Subskrypcja zdarzeń.

  4. Na stronie Tworzenie subskrypcji zdarzeń wprowadź nazwę subskrypcji zdarzeń.

  5. W obszarze Typy zdarzeń wybierz zdarzenia, do których chcesz zasubskrybować. W przypadku Email możesz wybrać elementy Email Delivery Report Received i Email Engagement Tracking Report Received.

  6. Jeśli zostanie wyświetlony monit o podanie nazwy tematu systemowego, możesz podać unikatowy ciąg. To pole nie ma wpływu na Środowisko użytkownika i jest używane do wewnętrznych celów telemetrycznych.

    Zrzut ekranu przedstawiający okno dialogowe Tworzenie subskrypcji zdarzeń. W obszarze Typy zdarzeń wybrano pozycję Odebrany raport dostarczania Email i odebrany raport śledzenia zaangażowania Email.

  7. W polu Typ punktu końcowego wybierz pozycję Web Hook.

    Zrzut ekranu przedstawiający szczegóły okna dialogowego Tworzenie subskrypcji zdarzeń. Na liście Typ punktu końcowego wybrano pozycję Web Hook.

  8. W polu Punkt końcowy wybierz pozycję Wybierz punkt końcowy, a następnie wprowadź adres URL aplikacji internetowej.

    W takim przypadku użyjemy adresu URL przeglądarki usługi Event Grid , który skonfigurowaliśmy wcześniej w przewodniku Szybki start. Adres URL przykładu ma następujący format: https://{{site-name}}.azurewebsites.net/api/updates

  9. Wybierz pozycję Potwierdź wybór.

    Zrzut ekranu przedstawiający okno dialogowe Wybieranie elementu Web Hook. Pole Punkt końcowy subskrybenta zawiera adres URL, a przycisk Potwierdź wybór jest widoczny.

Wyświetlanie zdarzeń Email

Aby wygenerować i odebrać zdarzenia Email, wykonaj kroki opisane w poniższych sekcjach.

Wyzwalanie zdarzeń Email

Aby wyświetlić wyzwalacze zdarzeń, musimy wygenerować niektóre zdarzenia. Aby wyzwolić zdarzenie, wyślij wiadomość e-mail przy użyciu zasobu domeny Email dołączonego do zasobu usług komunikacyjnych.

  • Email Delivery Report Receivedzdarzenia są generowane, gdy stan Email jest w stanie terminalu, tj. Dostarczono, Niepowodzenie, FiltrowaneSpam, Poddane kwarantannie.
  • Email Engagement Tracking Report Received zdarzenia są generowane po otwarciu wiadomości e-mail lub kliknięciu linku w wiadomości e-mail. Aby wyzwolić zdarzenie, należy włączyć User Interaction Tracking opcję w zasobie domeny Email

Zapoznaj się z pełną listą zdarzeń, które obsługują usługi Communication Services.

Odbieranie zdarzeń Email

Po wygenerowaniu zdarzenia zauważysz, że Email Delivery Report Received zdarzenia i Email Engagement Tracking Report Received są wysyłane do punktu końcowego. Te zdarzenia są wyświetlane w podglądzie usługi Event Grid , który skonfigurowaliśmy na początku tego przewodnika Szybki start. Wybierz ikonę oka obok zdarzenia, aby wyświetlić cały ładunek. Zdarzenia powinny wyglądać podobnie do następujących danych:

Zrzut ekranu przedstawiający przeglądarkę Azure Event Grid, która pokazuje schemat usługi Event Grid dla odebranego zdarzenia w raporcie dostarczania WIADOMOŚCI E-MAIL.

Zrzut ekranu przedstawiający przeglądarkę Azure Event Grid, która pokazuje schemat usługi Event Grid dla zdarzenia raportu śledzenia zaangażowania e-mail.

  • EngagementContext odwołuje się do linku klikniętego, gdy parametr engagementType ma wartość Click.
  • UserAgent odnosi się do User-Agent, z której pochodzi to zdarzenie zaangażowania poczty e-mail. Na przykład: Jeśli użytkownik wchodził w interakcję z przeglądarką Edge przy użyciu komputera Win10: Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, na przykład Gecko) Chrome/42.0.2311.135 Safari/537.36 Edge/12.246
  • EngagementType odnosi się do typu zakontraktowania, możliwe wartości to "Wyświetl" lub "Kliknij".

Dowiedz się więcej o schematach zdarzeń i innych pojęciach dotyczących zdarzeń.

Czyszczenie zasobów

Jeśli chcesz wyczyścić i usunąć subskrypcję usług Communication Services, możesz usunąć zasób lub grupę zasobów. Usunięcie grupy zasobów powoduje również usunięcie wszystkich innych skojarzonych z nią zasobów. Dowiedz się więcej o czyszczeniu zasobów.

Następne kroki

W tym przewodniku Szybki start przedstawiono sposób korzystania ze zdarzeń Email. Zdarzenia Email można odbierać, tworząc subskrypcję usługi Event Grid.

Wysyłanie wiadomości e-mail

Aby uzyskać informacje o schemacie i przykładowe zdarzenia, zobacz Azure Communication Services — zdarzenia Email.

Warto również zapoznać się z następującymi artykułami: