Краткое руководство. Обработка событий расширенного обмена сообщениями

Службы коммуникации Azure теперь позволяет отправлять и получать сообщения WhatsApp с помощью пакета SDK для расширенного обмена сообщениями. Начало работы с настройкой событий Сетки событий для получения отчетов о состоянии отправки и получения сообщений WhatsApp. Выполнение этого краткого руководства предполагает небольшую дополнительную плату в несколько центов США в учетной записи Azure.

Необходимые компоненты

• Учетная запись Azure с активной подпиской
• Регистрация поставщика ресурсов сетки событий
• Создайте ресурс Служб коммуникации Azure.

Сведения о службе "Сетка событий Azure"

Сетка событий — это облачная служба событий. В этой статье вы узнаете, как подписаться на события службы коммуникации и активировать событие для просмотра результата. Как правило, события отправляются на конечную точку, которая обрабатывает данные событий и выполняет соответствующие действия. В этой статье мы отправим события в веб-приложение, которое собирает и отображает сообщения.

Настройка средства просмотра сетки событий

Средство просмотра сетки событий — это пример сайта, который позволяет просматривать входящие события из сетки событий.

1. Перейдите по этой ссылке Сетка событий Azure viewer — примеры кода | Microsoft Learn. Разверните пример средства просмотра сетки событий, нажав кнопку "Развернуть в Azure".

   

2. После нажатия кнопки "Развернуть в Azure" заполните обязательные поля. Так как имя сайта создает запись DNS, она должна быть глобально уникальной. Мы рекомендуем включить псевдоним в имя этого шага. Хотя в этом кратком руководстве не требуется специальная настройка для этого шага, ниже приведены рекомендации по заполнению сведений о развертывании.

• Subscription— Выберите подписку, содержащую ресурс Службы коммуникации Azure. Эта конкретная подписка не требуется, но она упрощает очистку после завершения работы с кратким руководством.

• Resource Group— выберите группу ресурсов, содержащую ресурс Службы коммуникации Azure. Эта конкретная группа ресурсов не требуется, но она упрощает очистку после завершения работы с кратким руководством.

• Region— выберите группу ресурсов, содержащую ресурс Службы коммуникации Azure. Этот конкретный регион не является обязательным, но рекомендуется.

• Site Name — создайте имя, которое глобально уникально. Это имя сайта используется для создания домена для подключения к средству просмотра сетки событий.

• Hosting Plan Name — создайте любое имя для идентификации плана размещения.

• Sku — SKU F1 можно использовать для разработки и тестирования. Если возникают ошибки проверки, создающие средство просмотра сетки событий, которые говорят, что для плана F1 больше нет емкости, попробуйте выбрать другой регион. Дополнительные сведения о SKU см. в разделе о ценах на Служба приложений

  

3. Щелкните Просмотр и создание.

4. После завершения развертывания выберите ресурс Служба приложений, чтобы открыть его.

   

5. На странице обзора ресурсов нажмите кнопку копирования рядом со свойством домена по умолчанию.

   

6. URL-адрес средства просмотра сетки событий — это имя сайта, используемое для создания развертывания с добавленным путем /api/update . Например: "https://{имя_сайта}}.azurewebsites.net/api/updates". Он понадобится на следующем шаге и во время создания демонстрационного приложения.

Подписка на события расширенного обмена сообщениями

1. Откройте ресурс Служб коммуникации в портал Azure, перейдите к параметру "События" на левой панели и выберите +Подписка на события.

   

2. Укажите сведения о новой подписке на события.

   • Имя подписки.

   • Имя раздела системы— введите уникальное имя, если это имя еще не заполнено разделом из подписки.

   • Типы событий— выберите два события расширенного обмена сообщениями из списка.

     

   • Необязательно. Выберите событие AdvancedMessageAnalysisCompleted( в настоящее время в общедоступной предварительной версии) для получения событий анализа сообщений. Инструкции по включению анализа сообщений см. в разделе "Включение анализа сообщений" с помощью Azure OpenAI

     Внимание

     Эта функция Службы коммуникации Azure сейчас доступна в предварительной версии.

     Предварительные версии API и пакеты SDK предоставляются без соглашения об уровне обслуживания. Рекомендуется не использовать их для рабочих нагрузок. Некоторые функции могут не поддерживаться или могут иметь ограниченные возможности.

     Дополнительные сведения см . в дополнительных условиях использования для предварительных версий Microsoft Azure.

     

   • Для типа конечной точки выберите "Веб-перехватчик" и введите URL-адрес для средства просмотра сетки событий, созданного на шаге "Средство просмотра сетки событий установки" с добавленным путем/api/updates. Например: https://{{site-name}}.azurewebsites.net/api/updates.

     

   • Нажмите кнопку создания.

3. Вернитесь к параметру "События" на левой панели ресурса Службы коммуникации Azure. Обратите внимание на новую подписку на события с расширенными сообщениями.

   

Очистка ресурсов

Если вы хотите отменить и удалить подписку на Службы коммуникации, можно удалить ресурс или группу ресурсов. При удалении группы ресурсов также удаляются все связанные с ней ресурсы. См. сведения об очистке ресурсов.

Следующие шаги

Перейдите к следующей статье, чтобы узнать, как использовать расширенный пакет SDK для обмена сообщениями WhatsApp.

Приступая к работе с пакетом SDK для расширенных сообщений для обмена сообщениями.