Szybki start: obsługa zdarzeń raportów sms i dostarczania

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

Ważne

Możliwości wiadomości SMS i PSTN zależą od używanego numeru telefonu oraz kraju/regionu, w którym działasz zgodnie z adresem rozliczeniowym platformy Azure. Aby uzyskać więcej informacji, odwiedź dokumentację dotyczącą uprawnień do subskrypcji .

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, aby wyświetlić wynik. 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, którego użyjemy do generowania i odbierania zdarzeń, 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ń w czasie niemal 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ń sms przy użyciu elementów web hook

Możesz zasubskrybować określone zdarzenia, aby udostępnić usłudze Event Grid informacje o miejscu wysyłania zdarzeń, 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 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 przypadku programu SMS możesz wybrać pozycję SMS Received i SMS Delivery 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 twoje środowisko i jest używane do celów telemetrycznych wewnętrznych.

    Zrzut ekranu przedstawiający okno dialogowe Tworzenie subskrypcji zdarzeń. W obszarze Typy zdarzeń wybrano pozycję Odebrane wiadomości SMS i odebrany raport dostarczania wiadomości SMS.

  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 obszarze 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 język U R L, a przycisk Potwierdź zaznaczenie jest widoczny.

Wyświetlanie zdarzeń sms

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

Wyzwalanie zdarzeń SMS

Aby wyświetlić wyzwalacze zdarzeń, musimy wygenerować niektóre zdarzenia.

  • SMS Received zdarzenia są generowane, gdy numer telefonu usług komunikacyjnych odbiera wiadomość SMS. Aby wyzwolić zdarzenie, wyślij wiadomość z telefonu do numeru telefonu dołączonego do zasobu usług komunikacyjnych.
  • SMS Delivery Report Received zdarzenia są generowane podczas wysyłania wiadomości SMS do użytkownika przy użyciu numeru telefonu usług komunikacyjnych. Aby wyzwolić zdarzenie, należy włączyć Delivery Report opcję wysyłanego wiadomości SMS. Spróbuj wysłać wiadomość na telefon z włączonym przyciskiem Delivery Report . Ukończenie tej akcji wiąże się z niewielkimi kosztami w wysokości kilku centów USD lub mniej na koncie platformy Azure.

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

Odbieranie zdarzeń sms

Po wygenerowaniu zdarzenia zauważysz, że SMS Received zdarzenia i SMS Delivery Report Received zdarzenia są wysyłane do punktu końcowego. Te zdarzenia są wyświetlane w podglądzie usługi Event Grid skonfigurowanym 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 SMS.

Zrzut ekranu przedstawiający przeglądarkę Azure Event Grid, która pokazuje schemat usługi Event Grid dla zdarzenia raportu dostarczania wiadomości SMS.

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 z zdarzeń sms. Wiadomości SMS można odbierać, tworząc subskrypcję usługi Event Grid.

Możesz również chcieć: