다음을 통해 공유


빠른 시작: 고급 메시징 이벤트 처리

이제 Azure Communication Services를 사용하면 고급 메시징 SDK를 사용하여 WhatsApp 메시지를 보내고 받을 수 있습니다. WhatsApp 메시지 보내기/받기 상태 보고서를 수신하기 위한 Event Grid 이벤트 설정을 시작하세요. 이 빠른 시작을 완료하면 Azure 계정에서 USD 센트 이하의 작은 비용이 발생합니다.

필수 조건

Event Grid 정보

Event Grid는 클라우드 기반 이벤트 서비스입니다. 이 문서에서는 통신 서비스 이벤트를 구독하고 이벤트를 트리거하여 결과를 보는 방법에 대해 설명합니다. 일반적으로 이벤트 데이터를 처리하고 작업을 수행하는 엔드포인트에 이벤트를 보냅니다. 이 문서에서는 메시지를 수집하고 표시하는 웹앱에 이벤트를 보냅니다.

Event Grid 뷰어 설정

Event Grid 뷰어는 Event Grid에서 들어오는 이벤트를 볼 수 있는 샘플 사이트입니다.

  1. 이 링크 Azure Event Grid 뷰어 - 코드 샘플 | Microsoft Learn으로 이동하세요. Azure에 배포를 클릭하여 Event Grid 뷰어 샘플을 배포합니다.

    Azure에 배포 옵션이 있는 Event Grid 뷰어 샘플 페이지를 보여 주는 스크린샷.

  2. Azure배포를 클릭한 후 필요한 필드를 입력합니다. 사이트 이름은 DNS 항목을 만들므로 전역적으로 고유해야 합니다. 이 단계의 이름에 별칭을 포함하는 것이 좋습니다. 이 빠른 시작에서는 이 단계에 대한 특별한 설정이 필요하지 않지만 배포 세부 정보를 작성하기 위한 제안 사항은 다음과 같습니다.

  • Subscription - Azure Communication Services 리소스가 포함된 구독을 선택합니다. 이 특정 구독은 필수는 아니지만 빠른 시작을 완료한 후에 정리를 더 쉽게 만들어 줍니다.

  • Resource Group - Azure Communication Services 리소스가 포함된 리소스 그룹을 선택합니다. 이 특정 리소스 그룹은 필수는 아니지만 빠른 시작을 완료한 후에 정리를 더 쉽게 만들어 줍니다.

  • Region - Azure Communication Services 리소스가 포함된 리소스 그룹을 선택합니다. 이 특정 지역은 필수는 아니지만 권장됩니다.

  • Site Name - 전역적으로 고유한 이름을 만듭니다. 이 사이트 이름은 Event Grid 뷰어에 연결할 도메인을 만드는 데 사용됩니다.

  • Hosting Plan Name - 호스팅 계획을 식별하는 이름을 만듭니다.

  • Sku - sku F1은 개발 및 테스트 목적으로 사용할 수 있습니다. F1 플랜에 대한 용량이 더 이상 없는 경우처럼 Event Grid 뷰어를 만드는 데 유효성 검사 오류가 발생하는 경우에는 다른 지역을 선택해 보세요. sku에 대한 자세한 내용은 App Service 가격 책정을 참조하세요.

    성공적으로 배포하기 위해 제공해야 하는 이벤트 뷰어 웹앱 및 속성의 사용자 지정 배포를 보여 주는 스크린샷.

  1. 그런 다음, 검토 + 만들기를 선택합니다.

  2. 배포가 완료되면 App Service 리소스를 선택하여 엽니다.

    이벤트 뷰어 웹앱을 보여 주는 스크린샷

  3. 리소스 개요 페이지에서 기본 도메인 속성 옆에 있는 복사 단추를 선택합니다.

    이벤트 뷰어 웹앱의 URL을 보여 주는 스크린샷

  4. Event Grid 뷰어의 URL은 경로 /api/update 가 추가된 배포를 만드는 데 사용한 사이트 이름입니다. 예: "https://{{site-name}}.azurewebsites.net/api/updates". 다음 단계와 데모 앱을 만드는 동안 필요합니다.

고급 메시징 이벤트 구독

  1. Azure Portal에서 Communication Services 리소스를 열고, 왼쪽 패널의 이벤트 옵션으로 이동한 다음, +이벤트 구독을 선택합니다.

    Azure Communication Services 이벤트 구독 옵션을 보여 줍니다. 고급 메시징 이벤트를 구독할 수 있는 스크린샷

  2. 새 이벤트 구독에 대한 세부 정보를 입력합니다.

    • 구독 이름입니다.

    • 시스템 토픽 이름 - 구독의 토픽이 이미 미리 채워져 있지 않은 경우 고유한 이름을 입력합니다.

    • 이벤트 유형 - 목록에서 두 개의 고급 메시징 이벤트를 선택합니다.

      이벤트 구독 속성 만들기를 보여 주는 스크린샷

    • 선택 사항: 현재 공개 미리 보기로 제공되는 AdvancedMessageAnalysisCompleted 이벤트를 선택하여 메시지 분석 이벤트를 수신합니다. 메시지 분석을 사용하도록 설정하는 방법에 대한 지침은 Azure OpenAI를 사용하여 메시지 분석 사용에서 찾을 수 있습니다.

      Important

      Azure Communication Services의 이 기능은 현재 미리 보기 상태입니다.

      미리 보기 API 및 SDK는 서비스 수준 계약 없이 제공됩니다. 프로덕션 워크로드에는 사용하지 않는 것이 좋습니다. 일부 기능은 지원되지 않거나 기능이 제한될 수 있습니다.

      자세한 내용은 Microsoft Azure 미리 보기에 대한 보충 사용 약관을 검토하세요.

      메시지 분석 이벤트 구독 속성을 만드는 방법을 보여 주는 스크린샷

    • 엔드포인트 유형의 경우 "Webhook"를 선택하고 경로 /api/updates 가 추가된 Event Grid 뷰어 설정 단계에서 만든 Event Grid 뷰어의 URL을 입력합니다. 예: https://{{site-name}}.azurewebsites.net/api/updates

      이벤트를 수신하도록 이벤트 구독의 웹후크 URL을 업데이트하는 방법을 보여 주는 스크린샷

    • 만들기를 실행합니다.

  3. Azure Communication Services 리소스의 왼쪽 패널에 있는 이벤트 옵션으로 다시 이동합니다. 고급 메시징 이벤트가 있는 새 이벤트 구독을 확인합니다.

    구독된 두 개의 고급 메시징 이벤트를 보여 주는 스크린샷

리소스 정리

Communication Services 구독을 정리하고 제거하려면 리소스 또는 리소스 그룹을 삭제하면 됩니다. 리소스 그룹을 삭제하면 해당 리소스 그룹에 연결된 다른 모든 리소스가 함께 삭제됩니다. 리소스 정리에 대해 자세히 알아보세요.

다음 단계

WhatsApp 메시징에 고급 메시징 SDK를 사용하는 방법을 알아보려면 다음 문서로 이동하세요.