Szybki start: obsługa zaawansowanych zdarzeń obsługi komunikatów

Usługi Azure Communication Services umożliwiają teraz wysyłanie i odbieranie wiadomości WhatsApp przy użyciu zestawu Advanced Messaging SDK. Wprowadzenie do konfigurowania zdarzeń usługi Event Grid na potrzeby odbierania komunikatów WhatsApp do wysyłania/odbierania raportów o stanie. 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ą
• Rejestrowanie dostawcy zasobów usługi Event Grid
• Tworzenie zasobu usług Azure Communication Services

Event Grid — informacje

Event Grid to oparta na chmurze usługa zdarzeń. Z tego artykułu 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 wysyłamy zdarzenia do aplikacji internetowej, która zbiera i wyświetla komunikaty.

Konfigurowanie podglądu usługi Event Grid

Podgląd usługi Event Grid to przykładowa witryna umożliwiająca wyświetlanie zdarzeń przychodzących 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.

   

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 przewodnik Szybki start nie wymaga żadnej specjalnej konfiguracji dla tego kroku, poniżej przedstawiono sugestie dotyczące wypeł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 czyszczenie po zakończeniu pracy z przewodnikiem Szybki start.

• 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 przeglądarką usługi Event Grid.

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

• Sku — Jednostka SKU F1 może być używana 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

  

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

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

   

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

   

6. Adres URL przeglądarki usługi Event Grid to nazwa witryny użyta do utworzenia wdrożenia z dołączoną ścieżką /api/update . 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ń.

   

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

   • Nazwa subskrypcji.

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

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

     

   • Opcjonalnie: wybierz zdarzenie AdvancedMessageAnalysisCompleted, obecnie w publicznej wersji zapoznawczej, aby odbierać zdarzenia analizy komunikatów. Instrukcje dotyczące włączania analizy komunikatów można znaleźć w artykule 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.

     

   • W polu Typ punktu końcowego wybierz pozycję "Element webhook" i wprowadź adres URL podglądu usługi Event Grid utworzonego w kroku Podgląd usługi Event Grid Instalatora z dołączą ścieżką /api/updates . Na przykład: https://{{site-name}}.azurewebsites.net/api/updates.

     

   • 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 zdarzeniami obsługi komunikatów.

   

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

Przejdź do następnego artykułu, aby dowiedzieć się, jak używać zestawu Advanced Messaging SDK dla wiadomości WhatsApp.

Wprowadzenie do zestawu SDK zaawansowanych komunikatów komunikacyjnych.