Udostępnij za pośrednictwem

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

  • Artykuł

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

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.

    Screenshot that shows the Event Grid Viewer Sample Page with Deploy To Azure option.

  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.

  • "Nazwa witryny" — 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.

  • "Nazwa planu hostingu" — 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

    Screenshot that shows Custom deployment of Events Viewer web app and properties you need to provide to successfully deploy.

  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ć.

    Screenshot that shows Events Viewer web app.

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

    Screenshot that shows URL of Events Viewer web app.

  4. 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ń.

    Screenshot that shows Azure Communication Services Events subscription option and allows you to subscribe to Advanced Messaging events.

  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.

      Screenshot that shows create event subscription properties.

    • 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.

      Screenshot that shows how to update webhook url of event subscription to receive events.

    • 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.

    Screenshot that shows two Advanced messaging events subscribed.

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.