Partilhar via

Guia de início rápido: manipular eventos de mensagens avançadas

  • Artigo

Os Serviços de Comunicação do Azure agora permitem que você envie e receba mensagens do WhatsApp usando o SDK de Mensagens Avançadas. Comece a configurar eventos da Grade de Eventos para receber mensagens do WhatsApp, enviar / receber relatórios de status. A conclusão deste início rápido incorre num pequeno custo de alguns cêntimos USD ou menos na sua conta do Azure.

Pré-requisitos

Sobre o Event Grid

A Grade de Eventos é um serviço de eventos baseado em nuvem. Neste artigo, você aprenderá a assinar eventos de serviço de comunicação e acionar um evento para exibir o resultado. Normalmente, envia eventos para um ponto final que processa os dados de eventos e efetua ações. Neste artigo, enviamos os eventos para um aplicativo Web que coleta e exibe as mensagens.

Configurar o Visualizador de Grelha de Eventos

O Visualizador de Grade de Eventos é um site de exemplo que permite exibir eventos de entrada da Grade de Eventos.

  1. Vá para este link Azure Event Grid Viewer - Exemplos de código | Microsoft Learn. Implante o exemplo de Visualizador de Grade de Eventos clicando em Implantar no Azure.

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

  2. Depois de clicar em Implantar no Azure, preencha os campos obrigatórios. Como o nome do site cria uma entrada DNS, ele precisa ser globalmente exclusivo. Recomendamos que você inclua seu alias no nome para esta etapa. Embora este início rápido não exija nenhuma configuração especial para esta etapa, aqui estão sugestões para preencher os detalhes da implantação:

  • Subscription - Selecione a assinatura que contém seu recurso dos Serviços de Comunicação do Azure. Esta subscrição específica não é necessária, mas facilitará a limpeza depois de terminar o início rápido.

  • Resource Group - Selecione o grupo de recursos que contém seu recurso dos Serviços de Comunicação do Azure. Esse grupo de recursos específico não é necessário, mas facilitará a limpeza depois que você terminar o início rápido.

  • Region - Selecione o grupo de recursos que contém seu recurso dos Serviços de Comunicação do Azure. Esta região específica não é necessária, mas é recomendada.

  • 'Nome do site' - Crie um nome que seja globalmente exclusivo. Esse nome de site é usado para criar um domínio para se conectar ao Visualizador de Grade de Eventos.

  • 'Nome do Plano de Hospedagem' - Crie qualquer nome para identificar seu plano de hospedagem.

  • 'Sku' - O sku F1 pode ser usado para fins de desenvolvimento e teste. Se você encontrar erros de validação ao criar seu Visualizador de Grade de Eventos que dizem que não há mais capacidade para o plano F1, tente selecionar uma região diferente. Para obter mais informações sobre skus, consulte Preços do Serviço de Aplicativo

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

  1. Em seguida, selecione Rever + Criar.

  2. Após a conclusão da implantação, selecione o recurso do Serviço de Aplicativo para abri-lo.

    Screenshot that shows Events Viewer web app.

  3. Na página de visão geral do recurso, selecione no botão de cópia ao lado da propriedade Domínio padrão .

    Screenshot that shows URL of Events Viewer web app.

  4. A URL do Visualizador de Grade de Eventos é o Nome do Site usado para criar a implantação com o caminho /api/update acrescentado. Por exemplo: "https://{{site-name}}.azurewebsites.net/api/updates". Você precisará dele na próxima etapa e durante a criação do aplicativo de demonstração.

Inscrever-se em eventos do Advanced Messaging

  1. Abra o recurso Serviços de Comunicação no portal do Azure, navegue até a opção Eventos no painel esquerdo e selecione +Assinatura de Evento.

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

  2. Preencha os detalhes da nova subscrição do evento.

    • Nome da subscrição.

    • Nome do tópico do sistema - Insira um nome exclusivo, a menos que esse nome já esteja pré-preenchido com um tópico da sua assinatura.

    • Tipos de evento - Selecione os dois eventos de mensagens avançadas na lista.

      Screenshot that shows create event subscription properties.

    • Para o tipo de ponto final, selecione "Webhook" e insira o URL para o Visualizador de Grade de Eventos que criamos na etapa Configurar Visualizador de Grade de Eventos com o caminho /api/updates anexado. Por exemplo: https://{{site-name}}.azurewebsites.net/api/updates.

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

    • Selecione Criar.

  3. Navegue de volta para a opção Eventos no painel esquerdo do seu recurso dos Serviços de Comunicação do Azure. Observe a nova assinatura de evento com eventos do Advanced Messaging.

    Screenshot that shows two Advanced messaging events subscribed.

Clean up resources (Limpar recursos)

Se quiser limpar e remover uma assinatura dos Serviços de Comunicação, você pode excluir o recurso ou grupo de recursos. A exclusão do grupo de recursos também exclui quaisquer outros recursos associados a ele. Saiba mais sobre a limpeza de recursos.

Próximos passos

Avance para o próximo artigo para saber como usar o Advanced Messaging SDK para mensagens do WhatsApp.

Introdução ao SDK de Mensagens de Comunicação Avançadas.