Udostępnij za pośrednictwem

Szybki start: obsługa zdarzeń poczty e-mail

  • Artykuł

Rozpocznij pracę z usługami Azure Communication Services przy użyciu usługi Azure Event Grid w celu obsługi zdarzeń poczty e-mail usług Komunikacyjnych. Po zasubskrybowaniu zdarzeń e-mail, takich jak raporty dostarczania i raporty zakontraktowań, generujesz i odbierasz te zdarzenia. Ukończenie tego przewodnika Szybki start wiąże się z naliczeniem niewielkiej opłaty w wysokości kilku centów USD lub mniej na koncie platformy Azure.

Wymagania wstępne

  • Konto platformy Azure z aktywną subskrypcją. Utwórz konto bezpłatnie.
  • Zasób usług komunikacyjnych. Aby uzyskać szczegółowe informacje, zobacz Tworzenie zasobu usług Azure Communication Services.
  • Zasób poczty e-mail z aprowizowaną domeną. Utwórz zasób poczty e-mail.

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 portalu 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 zapewnia 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 w Podglądzie usługi Azure Event Grid.

Subskrybowanie zdarzeń poczty e-mail 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ług komunikacyjnych w menu po lewej stronie usług komunikacyjnych wybierz pozycję Zdarzenia.

  3. Wybierz pozycję Dodaj subskrypcję zdarzeń.

    Zrzut ekranu przedstawiający stronę Zdarzenia zasobu usług Azure Communication Services. Przycisk Subskrypcja zdarzeń jest wywoływany.

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

  5. W obszarze Typy zdarzeń wybierz zdarzenia, do których chcesz zasubskrybować. W obszarze Poczta e-mail możesz wybrać pozycję 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 celów wewnętrznych telemetrii.

    Zrzut ekranu przedstawiający okno dialogowe Tworzenie subskrypcji zdarzeń. W obszarze Typy zdarzeń wybrano odebrany raport dostarczania wiadomości e-mail i odebrany raport śledzenia zaangażowania poczty e-mail.

  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 z przeglądarki usługi Event Grid skonfigurowanej 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ź zaznaczenie jest widoczny.

Wyświetlanie zdarzeń poczty e-mail

Aby wygenerować i odebrać zdarzenia poczty e-mail, wykonaj kroki opisane w poniższych sekcjach.

Wyzwalanie zdarzeń poczty e-mail

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

  • Email Delivery Report Received zdarzenia są generowane, gdy stan wiadomości e-mail jest w stanie terminalu, na przykład 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 poczty e-mail

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

Odbieranie zdarzeń poczty e-mail

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 podgląd usługi Azure Event Grid przedstawiający schemat usługi Event Grid dla odebranego zdarzenia dostarczenia WIADOMOŚCI E-MAIL.

Zrzut ekranu przedstawiający podgląd usługi Azure Event Grid przedstawiający schemat usługi Event Grid dla zdarzenia raportu śledzenia aktywności e-mail.

  • EngagementContext odwołuje się do linku klikniętego, gdy parametr engagementType ma wartość Click.
  • UserAgent odwołuje się do agenta użytkownika, z którego 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 "Widok" 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 Komunikacyjnych, możesz usunąć zasób lub grupę zasobów. Usunięcie grupy zasobów powoduje również usunięcie wszelkich 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ń poczty e-mail. Zdarzenia e-mail można odbierać, tworząc subskrypcję usługi Event Grid.

Wyślij wiadomość e-mail

Aby uzyskać informacje o schemacie i przykładowe zdarzenia, zobacz Azure Communication Services — Zdarzenia poczty e-mail.

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