Gerencie eventos de mensagens avançadas

Aviso

O Serviços de Comunicação do Azure está introduzindo mudanças urgentes, e alguns serviços estão sendo aposentados. Saiba mais no guia de desativações e alterações significativas.

Serviços de Comunicação do Azure permite enviar e receber 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. Concluir este artigo incorre em um pequeno custo de alguns centavos de dólar ou menos em sua conta Azure.

Pré-requisitos

Sobre a Grade de Eventos

A Grade de Eventos do Azure é um serviço de eventos baseado em nuvem. Este artigo descreve como assinar eventos do serviço de comunicação e disparar um evento para exibir o resultado. Normalmente, você envia eventos para um ponto de extremidade que processa os dados de evento e realiza ações. Neste artigo, enviamos os eventos para um aplicativo Web que coleta e exibe as mensagens.

Configurar o Visualizador de Grade 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 Grade de Eventos do Azure Viewer - Exemplos de Código | Microsoft Learn e implante o exemplo do Visualizador de Grid de Eventos selecionando Implantar no Azure.

    Captura de tela que mostra a Página de Exemplo do Visualizador da Grade de Eventos com a opção Implantar no Azure.

  2. Depois de clicar no Deploy para Azure, preencha os campos necessários. Como o nome do site cria uma entrada DNS, ele precisa ser globalmente exclusivo. Recomendamos que você inclua seu alias no nome desta 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 de Serviços de Comunicação do Azure. Essa assinatura específica não é necessária, mas facilitará a limpeza depois que você terminar o início rápido.

  • Resource Group – selecione o grupo de recursos que contém seu recurso de 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 de Serviços de Comunicação do Azure. Essa região específica não é obrigatória, mas é recomendada.

  • Site Name: 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.

  • Hosting Plan Name: crie qualquer nome para identificar seu plano de hospedagem.

  • Sku - Use o SKU F1 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

    Captura de tela que mostra a implantação personalizada do aplicativo Web do visualizador de Eventos e as propriedades que você precisa fornecer para concluir a implantação com sucesso.

  1. Em seguida, selecione Examinar + Criar.

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

    Captura de tela que mostra o aplicativo Web do visualizador de Eventos.

  3. Na página de visão geral do recurso, selecione o botão copiar ao lado da propriedade Domínio Padrão .

    Captura de tela que mostra a URL do aplicativo Web do visualizador de Eventos.

  4. A URL do Visualizador da Grade de Eventos é o Nome do Site que você usou para criar a implantação com o caminho /api/updates anexado. 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.

Assinar eventos de mensagens avançadas

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

    Screenshot que mostra a opção de assinatura para eventos do Serviços de Comunicação do Azure e permite que você assine os eventos de Mensagens Avançadas.

  2. Preencha os detalhes para a nova assinatura de evento.

    • Nome da assinatura.

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

    • Tipos de evento: selecione os dois eventos de Mensagem avançada na lista.

      Captura de tela que mostra a criação de propriedades de assinatura de eventos.

    • Tipo de ponto de extremidade: selecione "Webhook" e insira o URL do Visualizador da Grade de Eventos que criamos na etapa Visualizador da Grade de Eventos de Instalação com o caminho /api/updates acrescentado. Por exemplo: https://{{site-name}}.azurewebsites.net/api/updates.

      Captura de tela que mostra como atualizar a URL do webhook de assinatura de eventos para receber eventos.

    • Selecione Criar.

  3. Navegue de volta para a opção Events no painel esquerdo do recurso Serviços de Comunicação do Azure. Observe a nova assinatura de evento com eventos de Mensagem avançada.

    Captura de tela que mostra dois eventos de mensagens avançadas assinados.

Limpar os recursos

Se quiser limpar e remover uma assinatura dos Serviços de Comunicação, exclua o recurso ou o grupo de recursos. Excluir o grupo de recursos também exclui todos os recursos associados a ele. Saiba mais sobre como limpar recursos.

Nomes de usuário e BSUIDs do WhatsApp

Com a introdução dos nomes de usuário do WhatsApp, os eventos de Mensagens Avançadas agora incluem novos campos para IDs de usuário com escopo comercial (BSUIDs).

  • AdvancedMessageReceived os eventos incluem um fromBSUID campo com o BSUID do remetente.
  • AdvancedMessageDeliveryStatusUpdated os eventos incluem um toBSUID campo com o BSUID do destinatário.

Aviso

Alteração significativa: Os campos existentes from e to agora podem estar vazios ou nulos quando um usuário do WhatsApp adotou um nome de usuário e ocultou seu número de telefone. Atualize os manipuladores de eventos adequadamente. Além disso, o campo de evento subject agora pode conter uma BSUID em vez de um número de telefone, o que pode interromper os filtros de assunto de webhook existentes e o código de automação que analisa o assunto. Para obter mais informações, consulte nomes de usuário do WhatsApp e BSUIDs.

Próximas etapas

  • Última atualização em