Udostępnij za pośrednictwem

Obsługa zaawansowanych zdarzeń obsługi komunikatów

  • Artykuł

Usługi Azure Communication Services umożliwiają wysyłanie i odbieranie wiadomości WhatsApp przy użyciu zestawu Advanced Messaging SDK. Rozpocznij konfigurację zdarzeń Event Grid do śledzenia raportów o stanie wysyłania i odbioru wiadomości WhatsApp. Ukończenie tego artykułu wiąże się z niewielkim kosztem kilku centów USD lub mniej na koncie platformy Azure.

Wymagania wstępne

Informacje o Event Grid

Event Grid to oparta na chmurze usługa zdarzeń. W tym artykule opisano sposób subskrybowania zdarzeń usługi komunikacji i wyzwalania zdarzenia 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 wysyłamy zdarzenia do aplikacji internetowej, która zbiera i wyświetla komunikaty.

Konfigurowanie podglądu usługi Event Grid

Podgląd Event Grid to przykładowa witryna umożliwiająca wyświetlanie przychodzących zdarzeń z usługi Event Grid.

  1. Przejdź do tego linku Podgląd usługi Azure Event Grid — przykłady kodu | Microsoft Learn. Wdróż przykład podglądu usługi Event Grid, klikając pozycję Wdróż na platformie Azure.

    Zrzut ekranu przedstawiający przykładową stronę podglądu usługi Event Grid z opcją Wdróż na platformie Azure.

  2. Po kliknięciu pozycji Wdróż na platformie Azure wypełnij wymagane pola. Ponieważ nazwa lokacji tworzy wpis DNS, musi być globalnie unikatowa. Zalecamy uwzględnienie aliasu w nazwie dla tego kroku. Chociaż ten szybki start nie wymaga żadnej specjalnej konfiguracji dla tego kroku, poniżej przedstawiono sugestie dotyczące uzupełniania szczegółów wdrożenia.

  • Subscription — Wybierz subskrypcję zawierającą zasób usług Azure Communication Services. Ta konkretna subskrypcja nie jest wymagana, ale ułatwi czyszczenie po zakończeniu pracy z przewodnikiem Szybki start.

  • Resource Group — Wybierz grupę zasobów zawierającą zasób usług Azure Communication Services. Ta konkretna grupa zasobów nie jest wymagana, ale ułatwi sprzątanie po zakończeniu szybkiego startu.

  • Region — Wybierz grupę zasobów zawierającą zasób usług Azure Communication Services. Ten konkretny region nie jest wymagany, ale jest zalecany.

  • Site Name — Utwórz nazwę, która jest globalnie unikatowa. Ta nazwa witryny służy do tworzenia domeny w celu nawiązania połączenia z wyświetlaczem Event Grid.

  • Hosting Plan Name — Utwórz dowolną nazwę, aby zidentyfikować plan hostingu.

  • Sku — Użyj jednostki SKU F1 do celów programistycznych i testowych. Jeśli wystąpią błędy sprawdzania poprawności podczas tworzenia podglądu usługi Event Grid, które mówią, że nie ma więcej pojemności dla planu F1, spróbuj wybrać inny region. Aby uzyskać więcej informacji na temat jednostek SKU, zobacz Cennik usługi App Service

    Zrzut ekranu przedstawiający niestandardowe wdrożenie aplikacji internetowej Podgląd Wydarzeń oraz właściwości, które trzeba podać do pomyślnego wdrożenia.

  1. Następnie wybierz pozycję Przejrzyj i utwórz.

  2. Po zakończeniu wdrażania wybierz zasób usługi App Service, aby go otworzyć.

    Zrzut ekranu przedstawiający aplikację internetową Podgląd zdarzeń.

  3. Na stronie przeglądu zasobu wybierz przycisk kopiowania obok właściwości Domena domyślna.

    Zrzut ekranu przedstawiający adres URL aplikacji internetowej Podgląd zdarzeń.

  4. Adres URL przeglądarki Event Grid to nazwa witryny, którą użyto do utworzenia wdrożenia, z dołączoną ścieżką /api/updates. Na przykład: "https://{{nazwa_witryny}}.azurewebsites.net/api/updates". Będzie ona potrzebna w następnym kroku i podczas tworzenia aplikacji demonstracyjnej.

Subskrybowanie zdarzeń zaawansowanej obsługi komunikatów

  1. Otwórz zasób usług komunikacyjnych w witrynie Azure Portal, przejdź do opcji Zdarzenia w panelu po lewej stronie i wybierz pozycję +Subskrypcja zdarzeń.

    Zrzut ekranu pokazuje opcję subskrypcji zdarzeń w Azure Communication Services i umożliwia subskrybowanie zaawansowanych zdarzeń komunikacyjnych.

  2. Podaj szczegóły nowej subskrypcji zdarzeń.

    • Nazwa subskrypcji.

    • Nazwa tematu systemowego: wprowadź unikatową nazwę, chyba że ta nazwa została już wstępnie wypełniona tematem z subskrypcji.

    • Typy zdarzeń: wybierz z listy dwa zaawansowane zdarzenia obsługi komunikatów.

      Zrzut ekranu przedstawiający tworzenie właściwości subskrypcji zdarzeń.

    • Opcjonalnie: Aby odbierać zdarzenia analizy komunikatów, wybierz AdvancedMessageAnalysisCompleted zdarzenie, które jest obecnie w publicznej wersji próbnej. Aby uzyskać więcej informacji, zobacz Włączanie analizy komunikatów za pomocą usługi Azure OpenAI.

      Ważne

      Ta funkcja usług Azure Communication Services jest obecnie dostępna w wersji zapoznawczej.

      Interfejsy API i zestawy SDK w wersji zapoznawczej są udostępniane bez umowy dotyczącej poziomu usług. Zalecamy, aby nie używać ich w przypadku obciążeń produkcyjnych. Niektóre funkcje mogą nie być obsługiwane lub mogą mieć ograniczone możliwości.

      Aby uzyskać więcej informacji, zapoznaj się z dodatkowymi warunkami użytkowania dla wersji zapoznawczych platformy Microsoft Azure.

      Zrzut ekranu pokazujący, jak tworzyć właściwości subskrypcji zdarzeń analizy komunikatów.

    • Typ punktu końcowego: wybierz "Webhook" i wprowadź adres URL dla podglądu usługi Event Grid, który utworzyliśmy w kroku Konfiguracja Podglądu Event Grid, z dołączoną ścieżką /api/updates. Na przykład: https://{{site-name}}.azurewebsites.net/api/updates.

      Zrzut ekranu pokazujący, jak zaktualizować adres URL webhooka dla subskrypcji zdarzeń, aby odbierać zdarzenia.

    • Wybierz pozycję Utwórz.

  3. Wróć do opcji Zdarzenia w lewym panelu zasobu usług Azure Communication Services. Zwróć uwagę na nową subskrypcję zdarzeń z Zaawansowanymi Wiadomościami.

    Zrzut ekranu przedstawiający dwa subskrybowane zaawansowane zdarzenia wiadomości.

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

Aby uzyskać więcej informacji, zobacz: